Set or clear this address's own action or actor
PUT/v1/projects/:project_id/addresses/:identifier
Upserts the address with its action, the actor it speaks as, or both; a field left out is left alone. action: null forgets the exception and defers back to the route table; any other action requires the same fields a route or channel default would (agent_id for agent, text for message).
actor_id binds an actor of this project, so the address speaks as the same actor your own sessions use. A changed actor deletes the address's conversations and their sessions — a session's actor is fixed — and the next message opens a fresh one; the actor naturali created for the address is deleted with them. An actor you bind is never deleted here.
An identifier no channel kind produces is 400.
Request
Responses
- 200
- 201
- 400
- 401
- 403
- 404
- 409
Action updated.
Address created with this action.
The request was malformed or failed validation.
Missing or invalid credentials.
The credential is scoped to a different project, or the caller's role in the project does not carry this action.
The resource does not exist (existence is not leaked).
ACTOR_MINTED_FOR_ADDRESS: actor_id names the actor naturali created for another address, which erasing that address would delete.