Pular para o conteúdo principal
POST
/
v3beta1
/
enterprise
/
service-users
/
{service_user_id}
/
api-keys
/
{api_key_id}
/
rotate
Rotacionar Chave de API do usuário de serviço
curl --request POST \
  --url https://api.devin.ai/v3beta1/enterprise/service-users/{service_user_id}/api-keys/{api_key_id}/rotate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "new_key_expires_at": 123,
  "revoke_current": true
}
'
{
  "api_key_id": "<string>",
  "api_key_name": "<string>",
  "token": "<string>"
}

Permissões

Requer um usuário de serviço com a permissão ManageServiceUsers no nível Enterprise.

Autorizações

Authorization
string
header
obrigatório

Credencial de usuário de serviço (prefixo: cog_)

Parâmetros de caminho

service_user_id
string
obrigatório

ID do usuário de serviço (prefixo: service-user-)

Exemplo:

"service-user-abc123def456"

api_key_id
string
obrigatório

Corpo

application/json
new_key_expires_at
integer | null

Expiração opcional da nova chave como um timestamp UNIX em segundos. Null para sem expiração.

revoke_current
boolean
padrão:true

Indica se a chave atual deve ser revogada. Defina como False para uma substituição gradual.

Resposta

Resposta bem-sucedida

Modelo de resposta compartilhado para criação/rotação da Chave de API (inclui token de uso único).

api_key_id
string
obrigatório
api_key_name
string
obrigatório
token
string
obrigatório

O token bruto da API. Ele é exibido apenas uma vez no momento da criação/rotação.