---
title: "Register where recordings go (a presigned-URL callback endpoint)"
method: POST
path: "/api/recording/targets"
tags: ["Recording"]
---

# Register where recordings go (a presigned-URL callback endpoint)

`POST /api/recording/targets`

## Request

- Base URL: `https://api.wordis-bond.com`
- URL: `https://api.wordis-bond.com/api/recording/targets`
- Auth: HTTP bearer

The `callbackUrl` must be a public https URL and is SSRF-validated at registration. A run records to the account’s first enabled target when it opts in with `record: true`.

## Request body

- RecordingTargetInput: Where BYOS recordings go. `callbackUrl` must be a public https URL (SSRF-validated at registration): wordis-bond POSTs it for a presigned PUT URL per recording, so wordis-bond never holds your cloud credentials.
  - `name` string, required
  - `model` 'presigned_callback'
  - `callbackUrl` string, uri, required
  - `track` 'inbound' | 'outbound' | 'both'
  - `enabled` boolean

## Response `201`

Created

- object
  - `data` RecordingTarget, required: Where BYOS recordings go. `callbackUrl` must be a public https URL (SSRF-validated at registration): wordis-bond POSTs it for a presigned PUT URL per recording, so wordis-bond never holds your cloud credentials.
    - `name` string, required
    - `model` 'presigned_callback'
    - `callbackUrl` string, uri, required
    - `track` 'inbound' | 'outbound' | 'both'
    - `enabled` boolean
    - `id` string, uuid, required
    - `createdAt` string, date-time
  - `error` union, required
    - object
    - string

## Other responses

- `401`: Missing, invalid, or revoked credentials.
- `402`: The plan does not permit this action, or the monthly quota is spent with no overage (e.g. a starter plan attempting a PSTN run). Body carries an upgrade hint; see GET /api/billing/plans.
- `422`: The request body failed validation.

---

[API](https://skmtc.dev/wordis-bond/apis/word-is-bond-voice-agent-testing-api.md) · [All operations](https://skmtc.dev/wordis-bond/apis/word-is-bond-voice-agent-testing-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wordis-bond/apis/word-is-bond-voice-agent-testing-api/revisions/66c2d5480d84?raw)