Upload a file

PUT/conversations/{conversation_id}/assets/{asset_id}/content

Send Authorization: Bearer <access_token> and X-Workspace-Id.

Path parameters

conversation_idstring · uuidRequired
asset_idstring · uuidRequired

Body

multipart/form-data

filefileRequired

Responses

200OK · AssetUpload at most 10 MiB. Ready assets are immutable; retries return the existing asset.

Plus the usual errors: 400, 403, 404.

curl -X PUT https://api.fryll.com/conversations/$CONVERSATION_ID/assets/$ASSET_ID/content \
  -H "Authorization: Bearer $FRYLL_ACCESS_TOKEN" \
  -H "X-Workspace-Id: $FRYLL_WORKSPACE_ID" \
  -F "file=@avatar.png"

const form = new FormData();
form.append('file', file);

const res = await fetch(`https://api.fryll.com/conversations/${conversationId}/assets/${assetId}/content`, {
  method: 'PUT',
  headers: {
    'Authorization': `Bearer ${process.env.FRYLL_ACCESS_TOKEN}`,
    'X-Workspace-Id': process.env.FRYLL_WORKSPACE_ID!,
  },
  body: form,
});
const data = await res.json();

Response200OK

{
  "id": "0192f3a4-81d0-7c61-a3b2-5e6f7a8b9c0d",
  "created_at": "2026-10-14T10:24:03.118Z",
  "updated_at": "2026-10-14T10:24:03.118Z",
  "conversation_id": "0192f3a4-8f22-7a04-b6c5-1d2e3f4a5b6c",
  "message_id": "0192f3a4-7b3c-7d2e-9f10-4a5b6c7d8e9f",
  "name": "deploys",
  "size_bytes": 1,
  "content_type": "image/png",
  "status": "pending",
  "preview_kind": "image"
}

Upload a file

PUT/conversations/{conversation_id}/assets/{asset_id}/content

Send Authorization: Bearer <access_token> and X-Workspace-Id.

Path parameters

conversation_idstring · uuidRequired
asset_idstring · uuidRequired

Body

multipart/form-data

filefileRequired

Responses

200OK · AssetUpload at most 10 MiB. Ready assets are immutable; retries return the existing asset.

Plus the usual errors: 400, 403, 404.

curl -X PUT https://api.fryll.com/conversations/$CONVERSATION_ID/assets/$ASSET_ID/content \
  -H "Authorization: Bearer $FRYLL_ACCESS_TOKEN" \
  -H "X-Workspace-Id: $FRYLL_WORKSPACE_ID" \
  -F "file=@avatar.png"

const form = new FormData();
form.append('file', file);

const res = await fetch(`https://api.fryll.com/conversations/${conversationId}/assets/${assetId}/content`, {
  method: 'PUT',
  headers: {
    'Authorization': `Bearer ${process.env.FRYLL_ACCESS_TOKEN}`,
    'X-Workspace-Id': process.env.FRYLL_WORKSPACE_ID!,
  },
  body: form,
});
const data = await res.json();

Response200OK

{
  "id": "0192f3a4-81d0-7c61-a3b2-5e6f7a8b9c0d",
  "created_at": "2026-10-14T10:24:03.118Z",
  "updated_at": "2026-10-14T10:24:03.118Z",
  "conversation_id": "0192f3a4-8f22-7a04-b6c5-1d2e3f4a5b6c",
  "message_id": "0192f3a4-7b3c-7d2e-9f10-4a5b6c7d8e9f",
  "name": "deploys",
  "size_bytes": 1,
  "content_type": "image/png",
  "status": "pending",
  "preview_kind": "image"
}