---
title: "Changes to Place a call"
method: POST
path: "/calls"
---

# Changes to Place a call

`POST /calls`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 9 of 20 revisions.

- **2026-10-30** `7199881ed19e`: 1 breaking, 7 info
- **2026-10-29** `03b7688c4c40`: 2 info
- **2026-10-27** `71ab98c75193`: 2 info
- **2026-10-26** `3c5e8c7fa80a`: 1 info
- **2026-10-21** `870e2821385f`: 2 breaking, 8 info
- **2026-10-17** `59969558f36a`: 3 breaking, 1 warning, 16 info
- **2026-10-15** `2f4d9658b334`: 4 warning, 6 info
- **2026-09-16** `892990bd38e1`: 10 breaking, 8 warning
- **2026-09-10** `ac1802a0ec54`: 1 warning

## Changes

- **2026-10-30** `7199881ed19e`: 1 breaking, 7 info
  - removed `subschema #1: Freeform, subschema #2: Structured` from the request body `anyOf` list
  - `header` request parameter `Idempotency-Key` list-of-types was widened by adding types `null`
  - for the `header` request parameter `Idempotency-Key`, the type was generalized from `string` to no type
  - request property `target_phone` list-of-types was widened by adding types `null` to media type `application/json`
  - added `#/components/schemas/CallResponse, #/components/schemas/SkillRunResponse` to the response body `anyOf` list for the response status `201`
  - added `#/components/schemas/QueuedCallResponse, #/components/schemas/SkillRunResponse` to the response body `anyOf` list for the response status `202`
  - removed `#/components/schemas/CallResponse, #/components/schemas/SkillRunResponse` from the response body `oneOf` list for the response status `201`
  - removed `#/components/schemas/QueuedCallResponse, #/components/schemas/SkillRunResponse` from the response body `oneOf` list for the response status `202`
- **2026-10-29** `03b7688c4c40`: 2 info
  - added the new optional `header` request parameter `X-Client-Surface`
  - added the required property `oneOf[subschema #1: QueuedCallResponse]/call` to the response with the `202` status
- **2026-10-27** `71ab98c75193`: 2 info
  - added the optional property `oneOf[subschema #1: CallResponse]/call/pending_questions` to the response with the `201` status
  - added the optional property `oneOf[subschema #1: CallResponse]/call/pending_questions_unavailable` to the response with the `201` status
- **2026-10-26** `3c5e8c7fa80a`: 1 info
  - the `mention_ai` request property default value changed from `false` to `true`
- **2026-10-21** `870e2821385f`: 2 breaking, 8 info
  - the response property `oneOf[subschema #1: CallResponse]/call/transcript_full/anyOf[subschema #1]/items/text` became optional for the status `201`
  - the `oneOf[subschema #1: CallResponse]/call/transcript_full/anyOf[subschema #1]/items/ts` response's property type changed from `string` to `number`, and format from `date-time` to no format for status `201`
  - added the optional property `oneOf[subschema #1: CallResponse]/call/transcript_full/anyOf[subschema #1]/items/audio` to the response with the `201` status
  - added the optional property `oneOf[subschema #1: CallResponse]/call/transcript_full/anyOf[subschema #1]/items/confidence` to the response with the `201` status
  - added the optional property `oneOf[subschema #1: CallResponse]/call/transcript_full/anyOf[subschema #1]/items/heard` to the response with the `201` status
  - added the optional property `oneOf[subschema #1: CallResponse]/call/transcript_full/anyOf[subschema #1]/items/interrupted` to the response with the `201` status
  - added the optional property `oneOf[subschema #1: CallResponse]/call/transcript_full/anyOf[subschema #1]/items/salvaged` to the response with the `201` status
  - added the optional property `oneOf[subschema #1: CallResponse]/call/transcript_status` to the response with the `201` status
  - removed the `supervisor_stt` enum value from the `oneOf[subschema #1: CallResponse]/call/transcript_full/anyOf[subschema #1]/items/role` response property for the response status `201`
  - removed the `system` enum value from the `oneOf[subschema #1: CallResponse]/call/transcript_full/anyOf[subschema #1]/items/role` response property for the response status `201`
- **2026-10-17** `59969558f36a`: 3 breaking, 1 warning, 16 info
  - removed the enum value `cancellation` of the request property `intent/anyOf[subschema #1]/`
  - response property `oneOf[subschema #1: CallResponse]/call/duration_sec` list-of-types was widened by adding types `number` to media type `application/json` of response `201`
  - the `oneOf[subschema #1: CallResponse]/call/duration_sec/anyOf[subschema #1]/` response's property type changed from `integer` to `number` for status `201`
  - the `brief/anyOf[subschema #1]/` request property's maxLength was set to `4000`
  - added the new optional `header` request parameter `Idempotency-Key`
  - added the new optional request property `suggestion_id`
  - added the new optional request property `voice`
  - added the new `webhook` enum value to the request property `ask_user_mode`
  - added the non-success response with the status `400`
  - added the non-success response with the status `502`
  - added the optional property `oneOf[subschema #1: CallResponse]/call/answer_offset_ms` to the response with the `201` status
  - added the optional property `oneOf[subschema #1: CallResponse]/call/answered_at` to the response with the `201` status
  - added the optional property `oneOf[subschema #1: CallResponse]/call/ended_by` to the response with the `201` status
  - added the optional property `oneOf[subschema #1: CallResponse]/call/line_kind` to the response with the `201` status
  - added the optional property `oneOf[subschema #1: CallResponse]/call/recording_started_at` to the response with the `201` status
  - added the optional property `oneOf[subschema #1: CallResponse]/call/recording_status` to the response with the `201` status
  - added the optional property `oneOf[subschema #1: CallResponse]/call/result` to the response with the `201` status
  - added the optional property `oneOf[subschema #1: CallResponse]/call/result_reason` to the response with the `201` status
  - added the optional property `oneOf[subschema #1: CallResponse]/call/voice` to the response with the `201` status
  - response property `oneOf[subschema #1: CallResponse]/call/outcome_type` deprecated
- **2026-10-15** `2f4d9658b334`: 4 warning, 6 info
  - added the new `failed_ivr_no_agent` enum value to the `oneOf[subschema #1: CallResponse]/call/outcome_type/anyOf[subschema #1]/` response property for the response status `201`
  - added the new `failed_language_barrier` enum value to the `oneOf[subschema #1: CallResponse]/call/outcome_type/anyOf[subschema #1]/` response property for the response status `201`
  - added the new `failed_recorded_announcement` enum value to the `oneOf[subschema #1: CallResponse]/call/outcome_type/anyOf[subschema #1]/` response property for the response status `201`
  - added the new `success_booking_cancelled` enum value to the `oneOf[subschema #1: CallResponse]/call/outcome_type/anyOf[subschema #1]/` response property for the response status `201`
  - added the new optional request property `disclosure`
  - added the new optional request property `record_call`
  - added the optional property `oneOf[subschema #1: CallResponse]/call/disclosure_mode` to the response with the `201` status
  - added the optional property `oneOf[subschema #1: CallResponse]/call/disclosure_text` to the response with the `201` status
  - added the optional property `oneOf[subschema #1: CallResponse]/call/record_call` to the response with the `201` status
  - added the optional property `oneOf[subschema #1: CallResponse]/call/recording_declined` to the response with the `201` status
- **2026-09-16** `892990bd38e1`: 10 breaking, 8 warning
  - removed the required property `oneOf[subschema #1: CallResponse]/call/task_id` from the response with the `201` status
  - removed the required property `oneOf[subschema #1: CallResponse]/owner_pod` from the response with the `201` status
  - removed the required property `oneOf[subschema #1: CallResponse]/task_id` from the response with the `201` status
  - removed the required property `oneOf[subschema #1: QueuedCallResponse]/queue_id` from the response with the `202` status
  - removed the required property `oneOf[subschema #2: SkillRunResponse]/call_sid` from the response with the `201` status
  - removed the required property `oneOf[subschema #2: SkillRunResponse]/call_sid` from the response with the `202` status
  - removed the required property `oneOf[subschema #2: SkillRunResponse]/owner_pod` from the response with the `201` status
  - removed the required property `oneOf[subschema #2: SkillRunResponse]/owner_pod` from the response with the `202` status
  - removed the required property `oneOf[subschema #2: SkillRunResponse]/skill_run_id` from the response with the `201` status
  - removed the required property `oneOf[subschema #2: SkillRunResponse]/skill_run_id` from the response with the `202` status
  - removed the optional property `oneOf[subschema #1: CallResponse]/call/call_sid` from the response with the `201` status
  - removed the optional property `oneOf[subschema #1: CallResponse]/call/supervisor_decisions` from the response with the `201` status
  - added the new `failed_agent_mute` enum value to the `oneOf[subschema #1: CallResponse]/call/outcome_type/anyOf[subschema #1]/` response property for the response status `201`
  - added the new `failed_call_dropped` enum value to the `oneOf[subschema #1: CallResponse]/call/outcome_type/anyOf[subschema #1]/` response property for the response status `201`
  - added the new `failed_cancelled` enum value to the `oneOf[subschema #1: CallResponse]/call/outcome_type/anyOf[subschema #1]/` response property for the response status `201`
  - added the new `failed_no_disclosure` enum value to the `oneOf[subschema #1: CallResponse]/call/outcome_type/anyOf[subschema #1]/` response property for the response status `201`
  - added the new `failed_no_engagement` enum value to the `oneOf[subschema #1: CallResponse]/call/outcome_type/anyOf[subschema #1]/` response property for the response status `201`
  - added the new `failed_wrong_number` enum value to the `oneOf[subschema #1: CallResponse]/call/outcome_type/anyOf[subschema #1]/` response property for the response status `201`
- **2026-09-10** `ac1802a0ec54`: 1 warning
  - deleted the `header` request parameter `X-API-Key`

---

[Operation](https://skmtc.dev/voygr/apis/voygr-calls-api/docs/calls/post.md) - [API](https://skmtc.dev/voygr/apis/voygr-calls-api.md) - [Page](https://skmtc.dev/voygr/apis/voygr-calls-api/changes/calls/post)
