Docs
BetaThe V4 API is in beta — endpoints and functionality may change.
API Keysv4

Unassign a channel from an API key

DELETE/api-keys/{apiKey}/channels/{channel}

Removes the API key's ownership of a channel's line. The key can no longer send from it. Hybrid mode is re-evaluated for the key.

Blooio Apps (OAuth) only. Requires the apikeys:manage scope. API-key and dashboard authentication are rejected with 403 oauth_token_required.

Path parameters

apiKeyRequiredstring

The API key value (prefixed with api_), as returned when the key was created or by the List API keys endpoint.

channelRequiredstring

The channel reference — the same three forms from accepts: a phone number (URL-encode + as %2B), a channel alias, or the exact channel id (ch_...).

Headers

AuthorizationRequiredstring

Your API key, sent as a bearer token: Authorization: Bearer <api_key>. Editing this stays in sync with the API key box on the right.

Bearer

Returns

dataoptionalApiKeyChannelAssignment

Result of assigning/unassigning a channel to an API key.

api_keyoptionalstring
channel_idoptionalstring

The resolved channel id (ch_...) the line belongs to.

addressoptionalstring

The line in E.164 that was (un)assigned.

successoptionalboolean
reassignedoptionalboolean

Present on assign: true when the line was taken from a previous owner.

unchangedoptionalboolean

Present on assign: true when the key already owned the line (no-op).

Response codes

200The channel is no longer owned by the key.
400The request was malformed — check the path, query parameters, and body.
401Your API key is missing or invalid. Pass it as a bearer token.
403Your API key isn't allowed to access this api key (blocked key or plan limit).
404No api key was found with the provided `apiKey`.
422Validation failed — one or more fields in the request are invalid or missing.

Sends a live request with your values and shows the real response below. Your key is stored only in this browser.

Request
curl -X DELETE https://api.blooio.com/v4/api-keys/sk_live_a1b2c3d4/channels/string \
Response objectexample
{  "data": {    "api_key": "sk_live_a1b2c3d4",    "channel_id": "ch_a1b2c3d4",    "address": "123 Main St",    "success": false,    "reassigned": false,    "unchanged": false  }}