# Turn on or off

> Puts the receptionist on the line ( ACTIVE ) or takes it off ( FORWARDING , which sends calls to your business phone instead). This reprograms how a live…

`PUT /v2/api/numbers/{number}/agent/status`

<Note>
**Required scope:** `AGENTS_WRITE`
</Note>

## Behavior

Puts the AI receptionist on the line or takes it off, and returns the whole configuration with the new status.

- `ACTIVE`: the receptionist answers incoming calls.
- `FORWARDING`: it does not, and calls go to your business phone instead.

<Warning>
This reprograms how a live line routes real calls. It is deliberately its own endpoint, so a configuration write can never flip it by accident. Configure the receptionist fully before switching it on, and confirm with a person before calling it.
</Warning>

Turning the receptionist off forwards calls to your workspace's business phone number, so one has to be set. That number is not the receptionist's `business_phone` and is not writable through this API.

## Errors

- `400 AGENT_NO_FORWARDING_NUMBER`: `FORWARDING` was requested and no business phone is set on the workspace. Until one is, the receptionist can only stay `ACTIVE`.
- `409 AGENT_LINE_NOT_ASSIGNED`: the line has no phone number assigned, so it can neither answer nor forward.
- `404 PHONE_NUMBER_NOT_FOUND`: the number is not one you have access to.
