Skip to main content
PATCH
Update Organization Service User

Permissions

Requires a service user or personal access token with the ManageAccountMembership permission at the enterprise level.

Authorizations

Authorization
string
header
required

Service User credential (prefix: cog_)

Path Parameters

org_id
string
required

Organization ID (prefix: org-)

Example:

"org-abc123def456"

service_user_id
string
required

Service user ID (prefix: service-user-)

Example:

"service-user-abc123def456"

Body

application/json
preferences
ServiceUserPreferences · object | null

Switches to change; fields left out keep their value. A service user's preferences apply across the whole enterprise.

role_id
string | null

Role to assign the service user at this scope.

Response

Successful Response

deleted_at
integer | null
required
expires_at
integer | null
required
name
string
required
preferences
ServiceUserPreferences · object
required

Per-service-user switches; a field left null means its default.

role_assignments
RoleAssignment · object[]
required
service_user_id
string
required