receptionist_candidate_number_in_use
The chosen number already has an inbound route (another agent, a voicemail route, or an answering policy). A candidate is staged only on an unrouted number or on its own candidate line; a working line is never replaced.
Problem shape
Every non-2xx response is an RFC 9457 application/problem+json body. The type URI below is stable and machine-matchable, so branch on the final path segment (the code) and treat the status as redundant confirmation. See the error-handling guide.
{
"type": "https://docs.vocapable.com/errors/receptionist_candidate_number_in_use",
"title": "…",
"status": 409,
"detail": "…",
"instance": "/v1/…"
}