Zuse

List messages

GET/v1/api/workspaces/{workspaceId}/messages

Returns the conversation, oldest first. To follow a running workspace, keep passing the previous latestSeq as afterSeq. A page shorter than limit means you've caught up.

Authorization

apiKey
AuthorizationBearer <token>

An API key that starts with zk_. Create one in the Zuse app.

In: header

Path Parameters

workspaceId*string

Workspace ID.

Query Parameters

afterSeq?integer

Return messages with a sequence number greater than this.

Range0 <= value
Default0
limit?integer

Maximum messages to return. Larger values are capped at 200.

Range1 <= value <= 200
Default200

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/api/workspaces/workspace_Q2x8mN4pR7sT1vWz/messages"
{  "messages": [    {      "messageId": "msg_k3Jd9sLq2Pz8xVb1Nm4Tr7",      "seq": 5,      "role": "user",      "text": "string",      "status": "pending",      "turnId": "turn_7a2c9e",      "outcome": "completed",      "createdAt": 1760697600000,      "deliveredAt": 1760697600000,      "attachments": [        {          "assetId": "asset_4kQ9mZr2Lp8vTx1nWc6bYs0d",          "mimeType": "image/png",          "originalName": "error.png",          "sizeBytes": 48213        }      ]    }  ],  "latestSeq": 0,  "turnFailure": {    "turnId": "string",    "agent": "claude",    "code": "agent_not_installed",    "message": "string"  }}
{  "error": "invalid_api_key",  "detail": "string"}
{  "error": "invalid_api_key",  "detail": "string"}
{  "error": "invalid_api_key",  "detail": "string"}
{  "error": "invalid_api_key",  "detail": "string"}

Send message POST

Sends a message to the workspace's agent. A paused workspace resumes automatically. Messages are queued while the agent is busy and handled in order.

Upload attachment POST

Uploads a file to a workspace so you can attach it to a message. Send the raw file as the body with its media type in `Content-Type`. Files can be up to 20 MiB.