Skip to main content

AllocateDID allocates a specific DID to an organization.

POST 
/api/v1/voice/admin/did-pool/:didPoolId/allocate

Assigns a known available DID to a customer organization. Optionally links to a billing subscription.

Parameters​

  • did_pool_id: Required, pool item to allocate
  • organization_id: Required, target organization
  • subscription_id: Optional, billing subscription link
  • subscription_item_id: Optional, billing item link

Side Effects​

  • Changes pool item status to allocated
  • Creates DID record in organization's voice service
  • Records allocation in audit log

Errors​

  • NOT_FOUND: Pool item does not exist
  • FAILED_PRECONDITION: DID not available for allocation
  • NOT_FOUND: Organization does not exist
  • PERMISSION_DENIED: Caller lacks voice:admin permission

Request​

Responses​

A successful response.