---
title: "Put Hosted Agent Authority Mode"
method: PUT
path: "/api/v1/phone/hosted-agent-config/authority-mode"
tags: ["Hosted Call Agent"]
---

# Put Hosted Agent Authority Mode

`PUT /api/v1/phone/hosted-agent-config/authority-mode`

## Request body

- HostedAgentAuthorityModeInput
  - `agent_identity_id` string, required
  - `authority_mode` 'contact_scoped' | 'yolo', required

## Response `200`

Successful Response

- HostedAgentConfig
  - `agent_identity_id` string, required
  - `voice` 'alloy' | 'ash' | 'ballad' | 'coral' | 'echo' | 'sage' | 'shimmer' | 'verse' | 'marin' | 'cedar'
  - `model` string, nullable — Compatibility field; accepted values are not stored or used.
  - `effective_voice` 'alloy' | 'ash' | 'ballad' | 'coral' | 'echo' | 'sage' | 'shimmer' | 'verse' | 'marin' | 'cedar', required
  - `effective_model` string, required — Server-selected model used for hosted calls.
  - `instructions` string, nullable
  - `authority_mode` 'contact_scoped' | 'yolo'

## Other responses

- `422` — Validation Error
- `4XX` — Client error with Support Agent information.
- `5XX` — Server error with Support Agent information.

---

[API](https://skmtc.dev/inkbox/apis/inkbox-api.md) · [All operations](https://skmtc.dev/inkbox/apis/inkbox-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/inkbox/inkbox-api/revisions/31f357e7e6f8/schema)