---
title: "Get Call Settings Projection"
method: GET
path: "/api/v1/phone/call-settings"
tags: ["Phone Calls"]
---

# Get Call Settings Projection

`GET /api/v1/phone/call-settings`

## Query parameters

- `agent_identity_id` string, uuid, nullable

## Response `200`

Successful Response

- CallSettingsProjection
  - `agent_identity_id` string, uuid, required
  - `incoming_call_action` string, nullable, required
  - `client_websocket_configured` boolean, required
  - `incoming_webhook_configured` boolean, required
  - `forwarding_target_type` 'phone' | 'sip', nullable
  - `forwarding_target` string, nullable
  - `hosted_agent` HostedAgentSettingsProjection, required
    - `model` string, nullable, required — Compatibility field; always null.
    - `voice` string, nullable, required
    - `effective_model` string, required — Server-selected model used for hosted calls.
    - `effective_voice` string, required
    - `instructions_configured` boolean, required

## 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)