admin.staff.remove
Remove alguém da equipe. Tira o acesso de equipe de uma pessoa (o usuário continua existindo). Só o dono remove donos; ninguém se remove; o último dono não pode ser removido.
- Endpoint:
POST https://app.atomiks.com.br/api/v1/admin.staff.remove(corpo JSON) - Quem pode chamar: super-admin da plataforma
- Escopo da chave:
admin:write - Grava dados: sim
- Pela chave de API: não (só pela interface)
- Ferramenta MCP: não
- Ficha em JSON:
https://app.atomiks.com.br/api/v1/openapi.json(operationIdadmin.staff.remove)
Entrada
| Campo | Tipo | Obrigatório | Nota |
|---|---|---|---|
userId | string (uuid) | sim |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"userId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"required": [
"userId"
]
}Exemplo
curl -X POST https://app.atomiks.com.br/api/v1/admin.staff.remove \
-H "Authorization: Bearer $ATOMIKS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"userId":"00000000-0000-0000-0000-000000000000"}'Saída
Sucesso: {"data": ...} com o formato abaixo.
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"ok": {
"type": "boolean",
"const": true
}
},
"required": [
"ok"
],
"additionalProperties": false
}Erros
{"error": {"code", "message", "requestId"}}. Códigos: invalid_input (400), unauthorized (401), forbidden / account_pending / scope_missing (403), not_found (404), limit_reached (409), internal (500).