Cliente revoca (desactiva) su propia API key
POST
/v1/client/keys/{id}/revoke
const url = 'https://api.mailerdash.com/v1/client/keys/example/revoke';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"password":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.mailerdash.com/v1/client/keys/example/revoke \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "password": "example" }'El usuario cliente desactiva una key vinculada a su cuenta (active=0). No es hard-delete — preserva auditoría y evita dominios huérfanos. Password-gated. 403 si la key no está vinculada al usuario autenticado.
Authorizations
Sección titulada «Authorizations »Parameters
Sección titulada « Parameters »Path Parameters
Sección titulada «Path Parameters » id
required
string
Request Body required
Sección titulada «Request Body required » Media type application/json
object
password
required
Re-auth password del cliente
string
Example generated
{ "password": "example"}Responses
Sección titulada « Responses »Key revocada (active=false)
Media type application/json
object
id
string
active
boolean
Example generated
{ "id": "example", "active": true}Password incorrecto
La key no está vinculada al usuario autenticado
Key no encontrada
Key ya estaba revocada
Error interno