> ## Documentation Index > Fetch the complete documentation index at: https://platform-docs.sarj.ai/llms.txt > Use this file to discover all available pages before exploring further. # Redirect to a fresh download URL for a Sarj.ai call recording > Resolve a Sarj.ai recording link to a freshly minted, short-lived download URL via a 302 redirect. Two ways to authenticate: an API key (the standard `/api/v1` Bearer credential — the request is authorized against the key's organization), or, when no API key is sent, a call-scoped recording token in the `X-Sarj-Recording-Token` header (preferred) or the `t` query parameter. The token exists for header-less consumers such as an HTML5 audio player; prefer the API key or the header, since the `t` query form places a credential in the URL. If an API key is present it always wins and the token is ignored. ## OpenAPI ````yaml /api-reference/openapi.json get /calls/{call_id}/recording openapi: 3.1.0 info: title: Sarj.ai Developer API description: > Public API for programmatic access to the **Sarj.ai voice platform**. > [!TIP] > **New here?** Start with the [Getting Started guide](https://platform-docs.sarj.ai/getting-started) > to go from API key to first call in under 5 minutes. > > **Building with AI agents?** See the [MCP Server guide](https://platform-docs.sarj.ai/mcp-server) > to connect Claude Code, Cursor, or any MCP-compatible agent. --- ## Authentication All authenticated endpoints require a **Bearer token** in the `Authorization` header: ``` Authorization: Bearer ``` Generate an API key from [platform.sarj.ai/api-keys](https://platform.sarj.ai/api-keys). > [!WARNING] > If you receive a `401 Unauthorized` response, your key may be invalid, > expired, or missing. Check the `error.type` field in the response body. --- ## Response Format **Success** ```json { "data": { ... }, "meta": { "request_id": "550e8400-e29b-41d4-a716-446655440000" } } ``` **Error** ```json { "error": { "type": "unauthorized", "message": "Authentication required." }, "meta": { "request_id": "550e8400-e29b-41d4-a716-446655440000" } } ``` Always branch on `error.type` — the `message` field is for humans only. --- ## Support Include `meta.request_id` in all support tickets for faster resolution. license: name: Apache 2.0 identifier: Apache-2.0 version: 1.0.0 servers: - url: https://platform-api.sarj.ai/api/v1 description: Production security: - ApiKeyAuth: [] tags: - name: System description: Service health and status. - name: Calls description: Create outbound voice calls and retrieve call details and transcripts. externalDocs: description: Sarj.ai Documentation url: https://platform-docs.sarj.ai paths: /calls/{call_id}/recording: get: tags: - Calls summary: Redirect to a fresh download URL for a Sarj.ai call recording description: >- Resolve a Sarj.ai recording link to a freshly minted, short-lived download URL via a 302 redirect. Two ways to authenticate: an API key (the standard `/api/v1` Bearer credential — the request is authorized against the key's organization), or, when no API key is sent, a call-scoped recording token in the `X-Sarj-Recording-Token` header (preferred) or the `t` query parameter. The token exists for header-less consumers such as an HTML5 audio player; prefer the API key or the header, since the `t` query form places a credential in the URL. If an API key is present it always wins and the token is ignored. operationId: getCallRecording parameters: - name: call_id in: path required: true schema: type: string title: Call Id - name: t in: query required: false schema: anyOf: - type: string - type: 'null' description: Call-scoped recording token (header/API-key alternative). title: T description: Call-scoped recording token (header/API-key alternative). - name: x-sarj-recording-token in: header required: false schema: anyOf: - type: string - type: 'null' title: X-Sarj-Recording-Token responses: '302': description: Redirect (Location header) to a short-lived recording download URL. content: {} '401': description: >- Invalid API key, or (token path) a missing/invalid/expired/mismatched token. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: API key not associated with an organization. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Call not found or recording unavailable. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - ApiKeyAuth: [] - {} components: schemas: ErrorResponse: properties: error: oneOf: - $ref: '#/components/schemas/ValidationErrorPayload' - $ref: '#/components/schemas/UnauthorizedPayload' - $ref: '#/components/schemas/NotFoundPayload' - $ref: '#/components/schemas/InternalErrorPayload' - $ref: '#/components/schemas/PhoneNumberBlockedPayload' - $ref: '#/components/schemas/CallLimitExceededPayload' - $ref: '#/components/schemas/OutboundCallFailedPayload' - $ref: '#/components/schemas/ScenarioNotFoundPayload' - $ref: '#/components/schemas/ScenarioForbiddenPayload' - $ref: '#/components/schemas/ScenarioInvalidConfigPayload' - $ref: '#/components/schemas/NoOrganizationPayload' - $ref: '#/components/schemas/CallNotFoundPayload' - $ref: '#/components/schemas/OauthInvalidRedirectUriPayload' title: Error discriminator: propertyName: type mapping: call_limit_exceeded: $ref: '#/components/schemas/CallLimitExceededPayload' call_not_found: $ref: '#/components/schemas/CallNotFoundPayload' internal_error: $ref: '#/components/schemas/InternalErrorPayload' no_organization: $ref: '#/components/schemas/NoOrganizationPayload' not_found: $ref: '#/components/schemas/NotFoundPayload' oauth_invalid_redirect_uri: $ref: '#/components/schemas/OauthInvalidRedirectUriPayload' outbound_call_failed: $ref: '#/components/schemas/OutboundCallFailedPayload' phone_number_blocked: $ref: '#/components/schemas/PhoneNumberBlockedPayload' scenario_forbidden: $ref: '#/components/schemas/ScenarioForbiddenPayload' scenario_invalid_config: $ref: '#/components/schemas/ScenarioInvalidConfigPayload' scenario_not_found: $ref: '#/components/schemas/ScenarioNotFoundPayload' unauthorized: $ref: '#/components/schemas/UnauthorizedPayload' validation_error: $ref: '#/components/schemas/ValidationErrorPayload' meta: $ref: '#/components/schemas/ResponseMeta' additionalProperties: false type: object required: - error title: ErrorResponse description: |- Standard envelope for all public API error responses. `error` is a discriminated union — branch on `error.type` to access variant-specific fields. Clients MUST treat unknown `type` values as retryable internal errors to preserve forward compatibility. ValidationErrorPayload: properties: message: type: string title: Message description: >- Human-readable summary. Do not parse programmatically — branch on `type`. type: type: string const: validation_error title: Type default: validation_error field_violations: items: $ref: '#/components/schemas/FieldViolation' type: array title: Field Violations description: Per-field validation details. additionalProperties: false type: object required: - message - field_violations title: ValidationErrorPayload UnauthorizedPayload: properties: message: type: string title: Message description: >- Human-readable summary. Do not parse programmatically — branch on `type`. type: type: string const: unauthorized title: Type default: unauthorized additionalProperties: false type: object required: - message title: UnauthorizedPayload NotFoundPayload: properties: message: type: string title: Message description: >- Human-readable summary. Do not parse programmatically — branch on `type`. type: type: string const: not_found title: Type default: not_found additionalProperties: false type: object required: - message title: NotFoundPayload InternalErrorPayload: properties: message: type: string title: Message description: >- Human-readable summary. Do not parse programmatically — branch on `type`. type: type: string const: internal_error title: Type default: internal_error additionalProperties: false type: object required: - message title: InternalErrorPayload PhoneNumberBlockedPayload: properties: message: type: string title: Message description: >- Human-readable summary. Do not parse programmatically — branch on `type`. type: type: string const: phone_number_blocked title: Type default: phone_number_blocked phone_number: type: string title: Phone Number description: The phone number that is blocked. additionalProperties: false type: object required: - message - phone_number title: PhoneNumberBlockedPayload CallLimitExceededPayload: properties: message: type: string title: Message description: >- Human-readable summary. Do not parse programmatically — branch on `type`. type: type: string const: call_limit_exceeded title: Type default: call_limit_exceeded phone_number: type: string title: Phone Number description: The phone number that hit the limit. call_limit: type: integer title: Call Limit description: The per-number call limit that was reached. additionalProperties: false type: object required: - message - phone_number - call_limit title: CallLimitExceededPayload OutboundCallFailedPayload: properties: message: type: string title: Message description: >- Human-readable summary. Do not parse programmatically — branch on `type`. type: type: string const: outbound_call_failed title: Type default: outbound_call_failed reason: type: string title: Reason description: Stable-ish reason string from the call service. additionalProperties: false type: object required: - message - reason title: OutboundCallFailedPayload ScenarioNotFoundPayload: properties: message: type: string title: Message description: >- Human-readable summary. Do not parse programmatically — branch on `type`. type: type: string const: scenario_not_found title: Type default: scenario_not_found scenario_id: type: string title: Scenario Id additionalProperties: false type: object required: - message - scenario_id title: ScenarioNotFoundPayload ScenarioForbiddenPayload: properties: message: type: string title: Message description: >- Human-readable summary. Do not parse programmatically — branch on `type`. type: type: string const: scenario_forbidden title: Type default: scenario_forbidden scenario_id: type: string title: Scenario Id additionalProperties: false type: object required: - message - scenario_id title: ScenarioForbiddenPayload ScenarioInvalidConfigPayload: properties: message: type: string title: Message description: >- Human-readable summary. Do not parse programmatically — branch on `type`. type: type: string const: scenario_invalid_config title: Type default: scenario_invalid_config scenario_id: type: string title: Scenario Id additionalProperties: false type: object required: - message - scenario_id title: ScenarioInvalidConfigPayload NoOrganizationPayload: properties: message: type: string title: Message description: >- Human-readable summary. Do not parse programmatically — branch on `type`. type: type: string const: no_organization title: Type default: no_organization additionalProperties: false type: object required: - message title: NoOrganizationPayload CallNotFoundPayload: properties: message: type: string title: Message description: >- Human-readable summary. Do not parse programmatically — branch on `type`. type: type: string const: call_not_found title: Type default: call_not_found call_id: type: string title: Call Id additionalProperties: false type: object required: - message - call_id title: CallNotFoundPayload OauthInvalidRedirectUriPayload: properties: message: type: string title: Message description: >- Human-readable summary. Do not parse programmatically — branch on `type`. type: type: string const: oauth_invalid_redirect_uri title: Type default: oauth_invalid_redirect_uri redirect_uri: type: string title: Redirect Uri additionalProperties: false type: object required: - message - redirect_uri title: OauthInvalidRedirectUriPayload ResponseMeta: properties: request_id: anyOf: - type: string - type: 'null' title: Request Id description: >- Unique identifier for this request, mirrored in the `X-Request-ID` response header. Supply your own via the `X-Request-ID` request header (max 128 chars, ASCII printable); otherwise the server generates a UUID v4. Include in support tickets. examples: - 550e8400-e29b-41d4-a716-446655440000 additionalProperties: false type: object title: ResponseMeta description: Contains request-level metadata included with every public API response. FieldViolation: properties: field: type: string title: Field description: >- Dot-separated path to the invalid field (e.g. `phone_number.country_code`). examples: - phone_number.country_code message: type: string title: Message description: Human-readable description of the violation. examples: - Must start with + additionalProperties: false type: object required: - field - message title: FieldViolation securitySchemes: ApiKeyAuth: type: http scheme: bearer description: >- API key from your Sarj.ai dashboard. Pass as: Authorization: Bearer ````