跳转到主要内容
POST
/
v3beta1
/
organizations
/
{org_id}
/
service-users
预配组织服务用户
curl --request POST \
  --url https://api.devin.ai/v3beta1/organizations/{org_id}/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>"
}

权限

需要一个在组织级别具有 ManageOrgServiceUsers 权限的服务用户。

安全约束

指定的 role_id 必须指向组织级别的角色。

授权

Authorization
string
header
必填

服务用户凭据(前缀:cog_)

请求体

application/json
name
string
必填
Required string length: 1 - 256
role_id
string
必填
Minimum string length: 1
ttl_seconds
integer
必填
必填范围: x <= 31536000

响应

成功响应

service_user
ServiceUser · object
必填
token
string
必填

服务用户的 API 访问令牌,仅在创建时显示一次。