---
title: "Update customer-facing Number rules for a phone number"
method: PATCH
path: "/v1/phone-numbers/{number_id}/number-rules"
---

# Update customer-facing Number rules for a phone number

`PATCH /v1/phone-numbers/{number_id}/number-rules`

## Request

- Base URL: `https://api.skysay.ai`
- URL: `https://api.skysay.ai/v1/phone-numbers/{number_id}/number-rules`
- Auth: none declared

## Request body

- NumberRules
  - `incoming` object
    - `agent_endpoint_id` string
    - `agent_id` string
    - `fallback` object: Stored with the rule but not yet applied to calls: a call the number cannot take is not forwarded to the fallback today.
    - `phone_number` string: Forward target when forwarding to another phone number.
    - `phone_server_id` string
    - `when_called` 'answer_with_skysay_agent' | 'send_live_audio_to_my_app' | 'send_to_my_phone_server' | 'forward_to_phone_number' | 'disabled'
  - `outgoing` object
    - `allowed_agents` string[]
    - `allowed_countries` string[]
    - `can_be_used_as_caller_id` boolean
    - `max_concurrent_calls` integer: 0 means no explicit Number rule cap.
  - `recording` object
    - `consent_state` string
    - `enabled` boolean
    - `retention_days` integer

## Response `200`

Number rules

---

[API](https://skmtc.dev/skysay/apis/skysay-api.md) · [All operations](https://skmtc.dev/skysay/apis/skysay-api/llms.txt) · [OpenAPI document](https://skmtc.dev/skysay/apis/skysay-api/revisions/95b8c66f99aa?raw)