ZaplinDocs
GuiasReferência da APIMCPChangelogAbrir o app

Editar número

PATCH
/v1/numbers/{id}

Renomeia um número ou muda suas equipes, equipe padrão, etapa e horários; nunca a sua conexão.

Escopo: numbers:write

Autorização

bearer numbers:write
headerAutorizaçãoBearer <token>

A chave de API de uma conta de serviço (sk_live_…, 600 requisições por minuto cada) ou um access token OAuth para o recurso /api/v1 (600 requisições por minuto por conexão).

Escopo: numbers:write

Parâmetros de caminho

id*string

O id.

Cabeçalhos

Idempotency-Key?string

Até 200 letras, dígitos, - ou _. A primeira resposta a uma chave é repetida por 24 horas.

Tamanholength <= 200

Corpo da requisição

application/json
  1. body
name?string
Tamanho1 <= length <= 60
team_ids?array<>
Itens1 <= items <= 100
default_team_id?string
Tamanho1 <= length <= 100
stage_id?|null
hours?unknown

Corpo da resposta

Feito.

application/json
  1. response
id*string
name*string
phone*string|null
status*string
Valor em"provisioning""awaiting_pairing""connected""degraded""disconnected""suspended""error"
default_team_id*string|null
created_at*string
Formatodate-time
team_ids*array<string>
stage_id*string|null
hours*array<>|null
Exemplo de requisição
curl -X PATCH 'https://app.zaplin.com.br/api/v1/numbers/string' \  -H 'Authorization: Bearer sk_live_...' \  -H 'Content-Type: application/json' \  -d '{}'
Exemplo de resposta
{  "id": "string",  "name": "string",  "phone": "string",  "status": "provisioning",  "default_team_id": "string",  "created_at": "2026-10-17T12:00:00.000Z",  "team_ids": [    "string"  ],  "stage_id": "string",  "hours": [    {      "open": false,      "from": "string",      "to": "string"    }  ]}