Numbers & Inventory

Update purchased number settings

Update a purchased DID number's identity association or call recording setting.

Important notes:

  • New identity must contain required documents for the number
  • call_recording_enabled requires the account-level "Allow call recording" setting to be on; returns 422 otherwise

Other normalizations applied silently on number purchase/update:

  • Webphone destinations (transport=10) are resolved server-side.
  • Boolean-like fields are coerced to booleans.
  • Destination strings are normalized.
  • SMS delivery-receipt (dlr) and Sender-ID settings follow account defaults when omitted.
put/api/v2/numbers/purchase

Request

  • Base URL: https://app.didlogic.com
  • URL: https://app.didlogic.com/api/v2/numbers/purchase
  • Auth: HTTP bearer

Request body

idinteger

DID ID from numbers_index, numbers_purchase_create

identity_idinteger

Identity ID to associate with the number, from identities_index, identities_create

call_recording_enabledboolean

Enable or disable inbound call recording for this DID

Example request

{
  "id": 357,
  "identity_id": 215
}

Response

updates purchased number

invalid_doc_typesobject required

Document types that are invalid or missing

Example response

{
  "purchase": {
    "id": 354,
    "number": "1234567890",
    "country": "US",
    "area": "Fake city for 1234567890",
    "channels": 1,
    "activation": 1.17,
    "monthly_fee": 1.17,
    "per_minute": 0.117,
    "status": "pending_docs",
    "commitment_months": 12,
    "identity_id": 206
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.