Docs

Update Event Role Availability

PUT /eventRoles/{roleId}/availability

PUT/eventRoles/{roleId}/availability

Required Tokens

FieldTypeRequiredDescription
BearerAuthorization: Bearer <api-key>OptionalYour API key. Pass it as the Bearer token on every request.
Organization tokenx-Organization-TokenOptionalRun **Authorize Organization** in the Authorization folder.

Replaces a role's Options list: the org crew or collaborator records its occupant pickers offer. The whole list is replaced. An empty list clears it, so pickers offer the whole roster again.

Occupants are not checked against the list and are never removed. Ids are not checked for existence; one that matches no record in the roster is never offered. GET eventRoles returns the list as availability: { recordIds } | null, and POST eventRoles accepts the same object as an optional availability.

Returns 200 OK, or 404 when the role is not in this organization.

Requires OrganizationAdmin permission.

Path Parameters

FieldTypeRequiredDescription
roleIdGuidRequiredThe role to update.

Request Body

FieldTypeRequiredDescription
recordIdsGuid[]RequiredOrg crew ids (`Crew` roles) or collaborator record ids (`Collaborator` roles). Duplicates collapse. Empty clears.