Pular para o conteúdo principal
POST
/
v3beta1
/
enterprise
/
service-users
Provisionar usuário de serviço do Enterprise
curl --request POST \
  --url https://api.devin.ai/v3beta1/enterprise/service-users \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "role_id": "<string>",
  "ttl_seconds": 123
}
'
{
  "service_user": {
    "expires_at": 123,
    "name": "<string>",
    "role_assignments": [
      {
        "role": {
          "role_id": "<string>",
          "role_name": "<string>",
          "role_type": "enterprise"
        },
        "org_id": "<string>"
      }
    ],
    "service_user_id": "<string>"
  },
  "token": "<string>"
}

Permissões

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

Restrições de segurança

O role_id especificado deve se referir a um papel no nível da conta.

Autorizações

Authorization
string
header
obrigatório

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

Corpo

application/json
name
string
obrigatório
Required string length: 1 - 256
role_id
string
obrigatório
Minimum string length: 1
ttl_seconds
integer
obrigatório
Intervalo obrigatório: x <= 31536000

Resposta

Resposta bem-sucedida

service_user
ServiceUser · object
obrigatório
token
string
obrigatório

O token de API do usuário de serviço. Ele é exibido apenas uma vez, no momento da criação.