Skip to main content
POST
Call library.get

Authorizations

Authorization
string
header
required

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

application/json
kind
enum<string>
required

The item's kind, exactly as library.search reported it.

Available options:
image_generation,
storage_object,
video_unit,
document
id
string
required

The item's id from library.search.

Minimum string length: 1
workspace
string

Which 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.

Minimum string length: 1

Response

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.

The tool ran and answered.

ok
boolean
required
kind
enum<string>
required

What sort of object this is — pass it back to library.get.

Available options:
image_generation,
storage_object,
video_unit,
document
id
string
required

The object's own id. With kind, this addresses it exactly.

roll
enum<string>
required

Which shelf of the library it sits on.

Available options:
images,
clips,
videos,
documents
title
string
required

What it is called: the name someone typed when pinning it, else the object's own label.

pinned
boolean
required

Has someone pinned this to the shelf?

pinned_name
string | null
required
finalized_at
string | null
required

When it was promoted into the library.

source_board_id
string | null
required

The board it was made on, when that board still exists.

source_board_name
string | null
required
preview_image_generation_id
string | null
required

The image whose bytes preview it, when it has one.

preview_has_bytes
boolean
required
workspace
string
required

The slug of the workspace this call ran in.

working_in
object
required

Which workspace this call ran in, and how that was decided. Present on every workspace-scoped result.