Yapper API
Api reference
GET
/sessions/{sessionId}/workspace

Returns the session's workspace: the folders, media, text documents, notes, pins and selected takes the session shows in the Yapper web app, and that the in-app Yapper agent works from. items lists every folder and file with its absolute path (such as /Characters/hero), sorted by path; top-level items have the root as parentId. unfiled lists the session's finished media that is in no folder. Pass path to list one folder and everything in it instead (unfiled is then empty). Hidden or cross-team sessions return not_found. Uses the processes:read scope.

Authorization

bearerAuth processes:read
AuthorizationBearer <token>

In: header

Scope: processes:read

Path Parameters

sessionId*string

Query Parameters

path?string

Only this folder and everything in it, such as /Characters. Names match exactly first, then ignoring case.

Length1 <= length <= 4000

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/sessions/string/workspace?path=%2FCharacters%2Fhero"
{  "sessionId": "string",  "rootId": "string",  "briefNodeId": "string",  "items": [    {      "id": "string",      "parentId": "string",      "name": "string",      "path": "/Characters/hero",      "type": "folder",      "kind": "folder",      "assetId": "string",      "previewUrl": "http://example.com",      "note": "string",      "pinned": true,      "selected": true,      "brief": true,      "color": "string",      "semantic": "string",      "childCount": 0,      "createdAt": "2019-08-24T14:15:22Z",      "updatedAt": "2019-08-24T14:15:22Z"    }  ],  "unfiled": [    {      "assetId": "string",      "name": "string",      "type": "image",      "previewUrl": "http://example.com"    }  ]}
{  "error": {    "code": "string",    "message": "string",    "requestId": "string"  }}
{  "error": {    "code": "string",    "message": "string",    "requestId": "string"  }}
{  "error": {    "code": "string",    "message": "string",    "requestId": "string"  }}
{  "error": {    "code": "string",    "message": "string",    "requestId": "string"  }}
{  "error": {    "code": "string",    "message": "string",    "requestId": "string"  }}

Get a session's canvas GET

Returns the session's node canvas: every card (node) with its settings, ports, latest versions and selected output, the wires (edges) between cards, and the LLM models a text-gen card can use. Every session has a canvas; exists is false until a card is added or the canvas is opened in the web app, and nodes is then empty. Lists the three newest versions per card; GET a node for all of them. Hidden or cross-team sessions return not_found. Uses the processes:read scope.

Get storage usage GET

Stored bytes and asset counts by type, plus trashed items still held until they are purged. Matches the Storage card on the account usage page. Pass memberId for the assets one member created; another member's storage requires the key's member to be a team owner or admin. Returns usage_breakdown_unavailable (409) until the workspace's storage has been indexed.