Call library.get
Read one library item by the kind and id library.search returned. Use it to confirm an item still exists and to see where it was made before you reference it.
Every result names the workspace it ran in. Say which workspace the answer is about. When the account has more than one workspace and none is selected, this tool refuses with workspace_ambiguous and lists the choices — offer them, never pick one.
Authorizations
An API key minted at Settings › API & MCP. Send it as Authorization: Bearer <key>. A key carries its holder's own permissions, resolved on every call — revoking a membership closes the key's reach immediately. Keep it in an environment variable (GOOSY_API_KEY), never in a committed file.
Body
The item's kind, exactly as library.search reported it.
image_generation, storage_object, video_unit, document The item's id from library.search.
1Which workspace to run in — its slug. Omit to use your default. With more than one reachable workspace and no default, the call is refused and the choices are listed.
1Response
The call was admitted and dispatched. ok says whether the tool succeeded — a refusal the tool itself produced is still a 200, exactly as it is a successful JSON-RPC result over MCP.
- Option 1
- Option 2
The tool ran and answered.
What sort of object this is — pass it back to library.get.
image_generation, storage_object, video_unit, document The object's own id. With kind, this addresses it exactly.
Which shelf of the library it sits on.
images, clips, videos, documents What it is called: the name someone typed when pinning it, else the object's own label.
Has someone pinned this to the shelf?
When it was promoted into the library.
The board it was made on, when that board still exists.
The image whose bytes preview it, when it has one.
The slug of the workspace this call ran in.
Which workspace this call ran in, and how that was decided. Present on every workspace-scoped result.