Auth

Revoke a message return line

Revokes a provider-owned message return line for the acting agent. Future message URL requests using that phone are rejected until the line is registered again.

delete/v1/auth/sign-in/message-lines

Request

  • Base URL: https://api.configure.dev
  • URL: https://api.configure.dev/v1/auth/sign-in/message-lines
  • Auth: API key in header X-API-Key

Headers

X-Agentstring
Example:your-agent

Required when the API key's developer account owns more than one active agent.

Request body

channelstring
phonestring required

Current provider-owned message return line in E.164 format.

labelstring nullable
metadataobject

Small server-side metadata object for provider bookkeeping.

Example request

{
  "channel": "sms",
  "phone": "+14155550123",
  "label": "Primary SMS line"
}

Response

Message return line revocation result.

deletedboolean required

Example response

{
  "lines": [
    {
      "channel": "sms",
      "phoneLast4": "0123",
      "label": "Primary SMS line"
    }
  ]
}

Changes

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