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.
apiKeyAuthorizationBearer <snoze_sk_…>Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.
workspaceId*stringSuccess
application/json- response
data*array<>curl -X GET 'https://api.snoze.dev/v1/workspaces/string/agent/chats'{ "data": [ { "id": "string", "workspaceId": "string", "title": "string", "parentSessionId": "string", "model": "string", "appearance": { "shape": "box", "color": "string", "accentColor": "string", "eyes": "dot", "eyePlacement": "centered", "motion": "still", "finish": "flat", "gradientColor": "string", "glowColor": "string", "intensity": "subtle", "cosmetics": { "head": "none", "face": "none" } }, "status": "idle", "runningMessageId": "string", "streamIdentity": { "turnId": "string", "messageId": "string" }, "lastError": "string", "background": { "enabled": true, "continuations": 0, "deadlineAt": 0 }, "createdAt": "string", "updatedAt": "string" } ]}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.
Create an agent chat
Creates an empty chat owned by the caller, with an optional title, model, and appearance, and returns it. Requires a Clerk session for a workspace member with the `ai:write` permission. The conversation itself is driven by the separate streaming turn route, not by this operation.