---
title: "Set Agent Incoming Call Action"
method: PUT
path: "/api/v1/phone/incoming-call-action"
tags: ["Phone Calls"]
---

# Set Agent Incoming Call Action

`PUT /api/v1/phone/incoming-call-action`

## Headers

- `Idempotency-Key` string, nullable

## Request body

- IncomingCallActionRequest
  - `incoming_call_action` 'auto_accept' | 'auto_reject' | 'webhook' | 'hosted_agent' | 'forward', required
  - `agent_identity_id` string, uuid, nullable
  - `client_websocket_url` string, nullable
  - `incoming_call_webhook_url` string, nullable
  - `forwarding_target_type` 'phone' | 'sip'
  - `forwarding_phone_number` string, nullable — Phone number in E.164 format (e.g. '+15551234567').
  - `forwarding_sip_uri` string, nullable — Complete SIP destination in sip:user@host format.

## Response `200`

Successful Response

- IncomingCallActionResponse
  - `agent_identity_id` string, uuid, required
  - `incoming_call_action` 'auto_accept' | 'auto_reject' | 'webhook' | 'hosted_agent' | 'forward', required
  - `client_websocket_url` string, nullable, required
  - `incoming_call_webhook_url` string, nullable, required
  - `forwarding_target_type` 'phone' | 'sip'
  - `forwarding_phone_number` string, nullable
  - `forwarding_sip_uri` string, nullable

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