Agents - Natural Docs

All error responses follow the standard error format. Validation errors (422) and rate limit errors (429) apply to all endpoints and are documented in the Error Handling guide.

Code	Status	Detail
`invalid_value`	400	The information you entered isn’t valid. Please check it and try again.
`invitation_self_not_allowed`	400	You can’t invite yourself. Enter a different customer’s email or phone number.
`unauthenticated`	401	Authentication is required.
`forbidden`	403	You do not have permission to perform this action.
`handle_human_session_required`	403	Agent handle slugs can only be set from a user session.
`party_not_active`	403	Only active accounts can change handles.
`party_not_verified`	403	Your account must be verified before it can change handles.
`agent_not_found`	404	Agent not found.
`already_exists`	409	The resource already exists.
`conflict`	409	The request conflicts with the current resource state.
`namespace_unavailable`	409	This handle is not available.
`slug_unavailable`	409	This handle is not available.
`namespace_invalid`	422	That handle is reserved or contains unsupported characters. Try another one.
`slug_invalid`	422	This agent slug is not valid. Use 1-30 lowercase letters, digits, or interior dots or underscores; hyphen is reserved as the party/agent separator and reserved words are rejected.
`rate_limited`	429	Too many requests. Please try again later.
`server_error`	500	Something went wrong.
`bad_gateway`	502	We couldn’t complete that request because one of Natural’s services returned an unexpected response. Please try again.
`service_unavailable`	503	The service is temporarily unavailable.

⌘I