---
title: "Update Inbound Number Intent Context"
method: PUT
path: "/api/v1/routing-environment/inbound-numbers/{phone_number_id}/intent-context"
tags: ["Routing Environment"]
---

# Update Inbound Number Intent Context

`PUT /api/v1/routing-environment/inbound-numbers/{phone_number_id}/intent-context`

## Request

- Base URL: `https://api.getanana.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getanana.com/api/v1/routing-environment/inbound-numbers/{phone_number_id}/intent-context`
- Auth: none declared

Set why callers ring this number. Touches no other configuration.

## Path parameters

- `phone_number_id` string, uuid, required

## Request body

- InboundNumberIntentWrite: Why callers ring one inbound number, in the operator's words. A prompt bias, never a routing gate — the agent is told what callers on this line usually want, and nothing is gated on it. Carries the same guards as ``PhoneNumberUpdateAPI.intent_context``, because this text reaches the system prompt: no ``##`` delimiter, no newlines, and a length cap so a prior stays a sentence or two rather than drowning the rest of the prompt.
  - `intent_context` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `404`: No such phone number in this tenant.
- `422`: Validation Error

## Changes

> 55 revisions in range; 1 not diffed.

- **2026-09-03** `d65b8fefae34`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Operation history](https://skmtc.dev/getanana/apis/cleon-api/changes/api/v1/routing-environment/inbound-numbers/:phone_number_id/intent-context/put.md)

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) · [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getanana/apis/cleon-api/revisions/4d9d38769a75?raw)