> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getnexor.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Assign an iMessage Number

> This operation lets you assign an iMessage number for the authenticated Nexor account. This reference documents verified path, query, and top-level JSON body fields, observed response status codes, and top-level response fields. Provider-owned or deeply nested response shapes may remain open.

<Warning>
  **Safety and behavior notes**

  * A malformed workflow\_id is not guaranteed to produce a clean HTTP 400 response.
  * Assigning an agent group releases any other number already assigned to that group.
  * Omitting workflow\_id unbinds the number; omission is not a no-op.
  * Unbinding leaves the number active and billed, so review the optional workflow\_id field before submission.
  * The route's id pattern is weaker than full UUID validation.
  * Unbinding does not cancel ownership or recurring charges.
</Warning>


## API Specification

The full API specification for this endpoint is available in the [documentation index](https://docs.getnexor.ai/llms.txt).