Get Run Audio Url

{
  "data": {
    "url": "https://s3.onepin.ai/audio/9f8b7c6d5e4a3b2c/output_9f8b7c6d5e4a3b2c.mp3?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE%2F20240615%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20240615T093000Z&X-Amz-Expires=900&X-Amz-SignedHeaders=host&X-Amz-Signature=abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
    "filename": "run_audio_9f8b7c6d5e4a3b2c.mp3",
    "expires_at": "2024-06-15T09:45:00Z"
  },
  "meta": {
    "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "timestamp": "2024-06-15T09:30:00Z"
  }
}

Mint a fresh playback URL for one audio output of a run.

audio_id is the stable 16-hex output identifier embedded in run-data card ids and carried by assistant chat audio parts. Presigned playback URLs expire after 15 minutes; call this endpoint at play time to refresh the URL by id instead of caching it or re-fetching a whole run-data page.

Returns 404 when the run has no s3-backed audio output with this id.

Mint a fresh playback URL for one audio output of a run. `audio_id` is the stable 16-hex output identifier embedded in run-data card ids and carried by assistant chat `audio` parts. Presigned playback URLs expire after 15 minutes; call this endpoint at play time to refresh the URL by id instead of caching it or re-fetching a whole run-data page. Returns 404 when the run has no s3-backed audio output with this id.

Authentication

AuthorizationBearer

Clerk JWT token

AuthorizationBearer

Onepin live API key (op_live_...). Test and public keys are reserved in Phase 1.

Path parameters

workflow_idstringRequiredformat: "uuid"

run_idstringRequiredformat: "uuid"

audio_idstringRequired

Response

Successful Response

dataobject

metaobject

Errors

404

Not Found Error

422

Unprocessable Entity Error

$	curl https://api.onepin.ai/api/v1/workflows/workflow_id/runs/run_id/audio/audio_id/url \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json"