calls.artifact
Download a recording or transcript with a signed token.
artifact_type is either recording or transcript. The token is a time-limited download token — generate one from the run details before calling this endpoint.
Reference
GET/api/v1/public/download/workflow/{token}/{artifact_type}
- Auth
- API key in
X-API-Key - Content
- none
- Returns
- 200 · any
Download a workflow recording or transcript via public access token. This endpoint: 1. Validates the public access token 2. Looks up the corresponding workflow run 3. Generates a signed URL for the requested artifact 4. Redirects to the signed URL Args: token: The public access token (UUID format) artifact_type: Type of artifact - "recording", "transcript", "user_recording", or "bot_recording" inline: If true, sets Content-Disposition to inline for browser preview Returns: RedirectResponse to the signed URL (302 redirect) Raises: HTTPException 400: If artifact type is unsupported HTTPException 404: If token is invalid or artifact not found
Arguments
| Argument | In | Type | Required | Description |
|---|---|---|---|---|
token | path | string | required | |
artifact_type | path | string | required | |
inline | query | boolean | default false | Display inline in browser instead of download |
Example request
curl -X GET "https://api.decibyl.ai/api/v1/public/download/workflow/<token>/<artifact_type>" \
-H "X-API-Key: dcb_your_key"Response
{}Errors
| Status | When |
|---|---|
404 | Not found |
422 | Validation Error |