BilbyHelp Center
Open Bilby

List conversation artifacts

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

Lists current artifacts, including sandbox_execute outputs, without creating attachment rows. Each downloadUrl is an authenticated API endpoint returning bytes, not a signed storage URL. Regenerating a filename replaces its current contents; this is not a version history. size is stored artifact size; compiled XLSX/DOCX specifications may download at a different size.

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
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

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

Current artifacts for the conversation

application/json
  1. response
items*array<>
total*number
Example Request
curl -X GET 'https://pulse.bilby.ai/api/v1/conversations/497f6eca-6276-4993-bfeb-53cbbbba6f08/artifacts' \  -H 'Authorization: Bearer YOUR_API_KEY'
Example Response
{  "items": [    {      "name": "string",      "size": 0,      "mimeType": "string",      "updatedAt": "2019-08-24T14:15:22Z",      "downloadUrl": "string"    }  ],  "total": 0}

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.

Download a conversation artifact GET

Returns current artifact bytes with Content-Type, Content-Length and Content-Disposition headers. Uses the same content resolution as browser downloads, including stored XLSX/DOCX specifications. Requires bearer or session auth. Deleting the artifact makes this endpoint return 404. Does not publish the artifact or create an attachment snapshot.