Developers

Talent Buddy API

Connect your recording workflow to assigned jobs, scripts and deliveries. HTTP and MCP use the same permissions and workflows.

Base URLhttps://talent.radioworkflow.com/api/v1

1. Create a key

Choose only the permissions your integration needs. Read access is selected by default. The full key is shown once, so save it when you create it and keep it on your own server.

Go to API keys Connect an MCP client

2. Make your first request

Set TALENT_API_KEY in your environment. Send it as a bearer token with every request. The xi-api-key header also works. Browser sign-in does not authenticate API or MCP calls.

Read your assigned jobs

curl 'https://talent.radioworkflow.com/api/v1/jobs' \
  -H "Authorization: Bearer $TALENT_API_KEY"

The list defaults to pending jobs, page 1 and 25 rows. Use a job ID from the response when opening a script or delivering a take.

What to expect

Your assigned work

A key can reach only the work currently assigned to you. Its permissions apply to both HTTP requests and MCP tools.

Changes and retries

Writes require an Idempotency-Key header. Reuse it only when retrying the same operation and input. MCP writes use request_id.

Upload directly

Begin an upload, transfer the file directly to the returned storage URL, then commit its handle. Upload initiation must not be retried automatically.

Replies and limits

Replies contain ok and api_version. IDs are decimal strings and timestamps are Unix seconds. JSON request bodies are limited to 250,000 bytes.

Errors, rate limits and retries

API reference

Each endpoint has its own request fields, examples, response schema and matching MCP tool.

Jobs and scripts

GETList jobs/jobsGETRead a job/jobs/{job_id}POSTGet a script PDF/scripts/pdfPOSTAccept jobs/jobs/acceptPOSTDecline jobs/jobs/declinePOSTComplete jobs/jobs/completePOSTAcknowledge a script revision/jobs/{job_id}/acknowledge-script

Deliveries

GETRead deliveries/jobs/{job_id}/deliveriesPOSTBegin a take upload/jobs/{job_id}/uploadsPOSTDeliver a take/jobs/{job_id}/deliveriesPOSTResume a delivery/deliveries/{delivery_id}/resumePOSTWithdraw a take/deliveries/{delivery_id}/withdrawPOSTRetry audio checks/deliveries/{delivery_id}/retry-check

Attachments

GETGet an attachment link/attachments/{attachment_id}/downloadPOSTBegin a file upload/jobs/{job_id}/attachment-uploadsPOSTSend an attached file/jobs/{job_id}/attachmentsDELRemove an attached file/attachments/{attachment_id}

Earnings

GETRead earnings/earnings

Account

GETRead your integration identity/meGETRead availability/availabilityGETRead preferences/preferencesGETRead AI voice permissions/consentPUTSet availability/availabilityPUTSet preferences/preferencesPUTSet AI voice permissions/consent

Permissions

jobs:read: Read jobs and scripts. Selected by default.
jobs:write: Accept, decline and complete jobs. Choose explicitly.
deliveries:read: Read deliveries and audio checks. Selected by default.
deliveries:write: Upload, deliver and withdraw takes. Choose explicitly.
attachments:read: Read attached files. Selected by default.
attachments:write: Upload and remove attached files. Choose explicitly.
earnings:read: Read shared earnings. Choose explicitly.
account:read: Read availability and preferences. Selected by default.
account:write: Change availability and email preferences. Choose explicitly.
consent:write: Change AI voice permissions. Choose explicitly.

OpenAPI 3.1 document