API explorer
API explorer

Theme switcher

Update department members (async)

Header Parameters

Authorizationstring

Path Parameters

departmentIdstring Required

Stable department ID. Unchanged by rename or reparent.

Body Parameters

dataobject Required

Single op — add or remove — plus the user IDs to apply it to.

Response

202
Object

Request queued for async processing. Poll GET /v2/admin/jobs/{jobId} using data.id to read per-ID outcomes.

Response Attributes

dataobject Required
400
Object

Whole-request validation failure — errors-only, no job created.

Response Attributes

errorsarray Required
Min items
1
401
Object

Access token is missing or invalid.

Response Attributes

errorsarray Required
Min items
1
403
Object

Authenticated but not permitted — caller is not an admin/super-admin, or the LaunchDarkly flag public-acl-api-ekp-55221 is off.

Response Attributes

errorsarray Required
Min items
1
404
Object

URL {departmentId} is not visible to this caller (unknown, or in another tenant). Per-ID USER_NOT_FOUND does NOT surface here — it surfaces as outcome.failed[] on GET /v2/admin/jobs/{jobId}.

Response Attributes

errorsarray Required
Min items
1
500
Object

Unexpected server error.

Response Attributes

errorsarray Required
Min items
1
Was this section helpful?

PATCH

/

Select
1

Response

Was this section helpful?