Skip to main content
PUT
/
api-keys
/
{api_key_id}
{
  "id": 1,
  "api_key_id": "ak_1234567890abcdef",
  "name": "Nome Atualizado",
  "permissions": [
    "read:emails"
  ],
  "is_active": true,
  "last_used_at": "2025-01-21T16:30:00Z",
  "expires_at": "2025-12-31T23:59:59Z",
  "created_at": "2025-01-21T16:30:00Z",
  "updated_at": "2025-01-21T16:30:00Z",
  "user_id": "user_123",
  "domain_name": 1
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
api_key_id
integer
required

ID da API Key

Required range: x >= 1

Body

application/json

Modelo para atualização de API Key

​
name
string | null

Nome da API Key

Required string length: 1 - 255
Example:

"Nome Atualizado"

​
permissions
enum<string>[] | null

Lista de permissões

Permissões disponíveis para API Keys

Available options:
read:emails,
write:emails,
read:webhooks,
write:webhooks,
read:stats,
read:suppressions,
write:suppressions,
admin
Example:
["read:emails"]
​
is_active
boolean | null

Status ativo

Example:

true

​
expires_at
string<date-time> | null

Data de expiração

Example:

"2025-12-31T23:59:59Z"

Response

API Key atualizada com sucesso

Modelo de resposta para API Key

​
id
integer
required

ID da API Key

​
api_key_id
string
required

ID único da API Key

Example:

"ak_1234567890abcdef"

​
name
string
required

Nome da API Key

Example:

"Minha API Key"

​
permissions
string[]
required

Lista de permissões

Example:
["read:emails", "write:emails"]
​
is_active
boolean
required

Status ativo

Example:

true

​
created_at
string<date-time>
required

Data de criação

Example:

"2025-01-21T16:30:00Z"

​
updated_at
string<date-time>
required

Data de atualização

Example:

"2025-01-21T16:30:00Z"

​
user_id
string
required

ID do usuário proprietário

Example:

"user_123"

​
last_used_at
string<date-time> | null

Último uso

Example:

"2025-01-21T16:30:00Z"

​
expires_at
string<date-time> | null

Data de expiração

Example:

"2025-12-31T23:59:59Z"

​
domain_name
integer | null

ID do domínio

Example:

1