Vorbal API Documentation

Send the raw audio body for a previously accepted Session Playback with type: push. Use the URL, method, and headers returned in the Playback response, and also send the application’s normal Authorization: Bearer <app_uuid>:<api_key> header. The operation must belong to the authenticated application, remain active, and the one-shot request must be opened before ingest.expires_at; an accepted request may continue streaming afterward. Send exactly one unframed stream and close the request body at EOF. A 204 means the complete request body was accepted; playback completion is reported separately by lifecycle webhooks.

Send the raw audio body for a previously accepted Session Playback with `type: push`. Use the URL, method, and headers returned in the Playback response, and also send the application's normal `Authorization: Bearer <app_uuid>:<api_key>` header. The operation must belong to the authenticated application, remain active, and the one-shot request must be opened before `ingest.expires_at`; an accepted request may continue streaming afterward. Send exactly one unframed stream and close the request body at EOF. A `204` means the complete request body was accepted; playback completion is reported separately by lifecycle webhooks.

Authentication

AuthorizationBearer

Application auth. Send Authorization: Bearer <app_uuid>:<api_key> using any active key in the app’s collection. See Authentication for details.

Application auth. Send `Authorization: Bearer <app_uuid>:<api_key>` using any active key in the app's collection. See [Authentication](https://voice-platform.docs.buildwithfern.com/api/authentication) for details.

Path parameters

operation_uuidstringRequiredformat: "uuid"

Operation UUID returned by the accepted push Playback command.

Request

This endpoint expects binary data of type application/octet-stream.

Response

The complete audio body was accepted.

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

409

Conflict Error

415

Unsupported Media Type Error

429

Too Many Requests Error

503

Service Unavailable Error