BilbyHelp Center
Open Bilby

List conversation attachments

GET
/api/v1/conversations/{id}/attachments

Durable attachments (user uploads + sandbox outputs) for one conversation. Each entry carries a downloadUrl.

Authorization

bearerAuth
headerAuthorizationBearer <token>

Personal API key (Authorization: Bearer pulse_...). Scoped to selected organizations (or all current ones); acts as the creating user. If the key covers more than one organization, pass its organizationId on each request.

Path Parameters

id*string

Query Parameters

organizationId?string

Organization to operate in. Optional when the API key is bound to exactly one organization (inferred). Required for keys that cover several or all organizations, and for session cookie auth.

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
workspaceId?stringDeprecated

Deprecated: the old name of organizationId, still accepted. If both are sent, they must match.

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Response Body

Attachments for the conversation

application/json
  1. response
items*array<>
total*number
Example Request
curl -X GET 'https://pulse.bilby.ai/api/v1/conversations/string/attachments' \  -H 'Authorization: Bearer YOUR_API_KEY'
Example Response
{  "items": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "conversationId": "ee6e55e8-45fe-4a3e-9bc8-4669f9fdf77a",      "messageId": "string",      "filename": "string",      "mediaType": "string",      "byteSize": 0,      "sourceKind": "string",      "createdAt": "2019-08-24T14:15:22Z",      "downloadUrl": "string"    }  ],  "total": 0}

Initialize file upload POST

Start a 2-phase upload. Returns a presigned `uploadUrl` (`PUT` file bytes with `Content-Type: <fileType>`) plus `objectKey` and short-lived `uploadToken`. Then send the message with `attachments: [{ objectKey, filename, mediaType, uploadToken }]`. Accepts the same files as a conversation in Bilby (images, PDF, Word, PowerPoint and Excel files, text/code, SVG). Max 25MB per file.

Get attachment download URL GET

Returns a short-lived signed `downloadUrl` (1h) for one durable attachment. Unlike the `readUrl` from `/attachments/init` (15m, temp key), this authorizes by attachment UUID against the committed `chats/` key — safe for bots to fetch server-side.