Saltar al contenido principal
POST
/
v3beta1
/
enterprise
/
service-users
Provisionar usuario de servicio de 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>"
}

Permisos

Requiere un usuario de servicio con el permiso ManageAccountServiceUsers a nivel Enterprise.

Restricciones de seguridad

El role_id especificado debe hacer referencia a un rol definido a nivel de cuenta.

Autorizaciones

Authorization
string
header
requerido

Credencial de usuario de servicio (prefijo: cog_)

Cuerpo

application/json
name
string
requerido
Required string length: 1 - 256
role_id
string
requerido
Minimum string length: 1
ttl_seconds
integer
requerido
Rango requerido: x <= 31536000

Respuesta

Respuesta correcta

service_user
ServiceUser · object
requerido
token
string
requerido

El token de API para el usuario de servicio. Solo se muestra una vez, en el momento de su creación.