Skip to main content
PUT
Set Users' Billing Organizations
Sets the billing organization for up to 100 users in one request. Only the users you submit change; the rest of the enterprise is untouched. For one user at a time, the beta user settings endpoint also accepts billing_org_id.

Partial success

Valid assignments are saved together even when other rows in the same request are invalid, so a 200 response can include failures. Always read failed: each entry names the user, the requested organization, and a reason. Those users’ billing organizations did not change; fix the rows and resend them. New reasons may be added over time, so treat unknown values as a failure rather than an error. An error response (4xx or 5xx) means nothing in the request was saved. Requests with no assignments, more than 100 assignments, or the same user_id more than once are rejected with 422. Resending an assignment overwrites the user’s current billing organization and records another audit log entry, so repeated calls are safe but not free.

Permissions

Requires a service user or personal access token with both the ManageBilling and ViewOrganizations permissions at the enterprise level. ManageOrganizations also satisfies ViewOrganizations, since it includes it.

Authorizations

Authorization
string
header
required

Service User credential (prefix: cog_)

Body

application/json
assignments
UserBillingOrgAssignmentRequest · object[]
required

Billing organization to set for each user. A user may appear only once.

Required array length: 1 - 100 elements

Response

Successful Response

assigned
UserBillingOrgAssignmentResponse · object[]
required

Assignments that were applied.

failed
UserBillingOrgFailureResponse · object[]
required

Assignments that were skipped, with the reason. These users' billing organizations did not change.