SnozeDevelopers
API referenceAgent

List the files attached to your agent chats

The assistant's file library: every file attached to one of the caller's own chats in this workspace, most recently attached first, with its type, size, whether Snoze has read it, whether it has been saved to the sidebar, and which chats it appears in (the latest twenty). A file attached to several chats is listed once; files the caller can no longer open are left out. Paginated by file, a hundred at a time: pass the `cursor` from the previous response while `hasMore` is true, with the same filters. `chatId` narrows the list to one chat's files; `q` to files whose name contains it. Requires a Clerk session for a workspace member with the `ai:read` permission.

GET
/v1/workspaces/{workspaceId}/agent/files

Authorization

apiKey
headerAuthorizationBearer <snoze_sk_…>

Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.

Path Parameters

workspaceId*string

Query Parameters

cursor?string|null
chatId?string|null
q?string|null

Response Body

Success

application/json
  1. response
data*
Example Request
curl -X GET 'https://api.snoze.dev/v1/workspaces/string/agent/files'
Example Response
{  "data": {    "files": [      {        "fileId": "string",        "name": "string",        "mimeType": "string",        "byteSize": 0,        "url": "string",        "kind": "image",        "reading": "pending",        "readingError": "string",        "pageCount": 0,        "itemId": "string",        "attachedAt": "string",        "chats": [          {            "chatId": "string",            "title": "string",            "attachedAt": "string"          }        ]      }    ],    "cursor": "string",    "hasMore": true  }}

List what was made in your agent chats

The Library's Created list: artifacts from the caller's own live chats, newest first, as titles and origins without their content (read an artifact through the ai-artifacts endpoints). `q` narrows to titles containing it; pass the `cursor` from the previous response while `hasMore` is true. An artifact pointing at an item or file the caller cannot open is left out. Requires a Clerk session for a workspace member with the `ai:read` permission.

List the caller's agent chats in a workspace

Returns the chats this user created in the workspace, most recently updated first, with each chat's status, model, appearance, and last error. A chat still marked `running` past the stuck threshold is reaped into `error` while the list is built. Requires a Clerk session for a workspace member with the `ai:read` permission; API keys cannot call this group.