Sign in
public-api-tokens

Changed on

Update a token's resource grants via PATCH (full replacement).

PATCH and PUT behave identically for this endpoint: both require the full available_resources list and replace grants completely.

Accepts available_resources (a non-empty list of valid resource values). Reconciles ResourceAccess rows: adds new, removes dropped, de-duplicates. integration_name and token are never mutated; if sent in the body, they are silently ignored.

Returns HTTP 200 with the updated token serialized via SystemUserTokenSerializer. HTTP 400 is returned for invalid resource values or empty list. HTTP 403 is returned for non-admin callers; HTTP 404 if the token does not exist or belongs to another organization; HTTP 401 for unauthenticated.

patch/public-api-tokens/{id}/

Request

  • The document declares no server URL.
  • Auth: one of:
    • HTTP bearer
    • API key in cookie sessionid

Path parameters

idstring required

Headers

X-Organization-Idstring

Selects the active organization for this request. Optional for callers that belong to exactly one active organization — the single membership is resolved implicitly. Required when the caller has two or more active memberships; omitting it in that case returns 400. If the header names an organization the caller is not an active member of, the server returns 403.

Request body

available_resourcesAvailableResourcesEnum[]

Response

idinteger required
integration_namestring required
is_activeboolean required

Indicates if the user is active.

available_resourcesstring[] required

Return a list of resource_name values from the prefetched ResourceAccess rows.

scoped_to_userinteger nullable required

Return the owner's User id from the denormalized membership column, or None.

scoped_to_membership_user_id is a concrete column already storing the membership's user_id, so the value is returned directly with no extra query.

Changes

  • e92afcb6b029Revision changes
    • ▲

      removed the enum value batch_upsert_group_scoped_availability_windows of the request property / (media type: application/json)

    • ▲

      removed the enum value batch_upsert_group_scoped_availability_windows of the request property / (media type: application/x-www-form-urlencoded)

    • ▲

      removed the enum value batch_upsert_group_scoped_availability_windows of the request property / (media type: multipart/form-data)

    • ▲

      removed the enum value batch_upsert_group_scoped_blocked_times of the request property / (media type: application/json)

    • ▲

      removed the enum value batch_upsert_group_scoped_blocked_times of the request property / (media type: application/x-www-form-urlencoded)

    • ▲

      removed the enum value batch_upsert_group_scoped_blocked_times of the request property / (media type: multipart/form-data)

    • ▲

      removed the enum value batch_upsert_group_scoped_quota_rules of the request property / (media type: application/json)

    • ▲

      removed the enum value batch_upsert_group_scoped_quota_rules of the request property / (media type: application/x-www-form-urlencoded)

    • ▲

      removed the enum value batch_upsert_group_scoped_quota_rules of the request property / (media type: multipart/form-data)

    • ▲

      removed the enum value calendar_group of the request property / (media type: application/json)

    • ▲

      removed the enum value calendar_group of the request property / (media type: application/x-www-form-urlencoded)

    • ▲

      removed the enum value calendar_group of the request property / (media type: multipart/form-data)

    • ▲

      removed the enum value group_scoped_availability_windows of the request property / (media type: application/json)

    • ▲

      removed the enum value group_scoped_availability_windows of the request property / (media type: application/x-www-form-urlencoded)

    • ▲

      removed the enum value group_scoped_availability_windows of the request property / (media type: multipart/form-data)

    • ▲

      removed the enum value group_scoped_blocked_times of the request property / (media type: application/json)

    • ▲

      removed the enum value group_scoped_blocked_times of the request property / (media type: application/x-www-form-urlencoded)

    • ▲

      removed the enum value group_scoped_blocked_times of the request property / (media type: multipart/form-data)

    • ▲

      removed the enum value group_scoped_quota_rules of the request property / (media type: application/json)

    • ▲

      removed the enum value group_scoped_quota_rules of the request property / (media type: application/x-www-form-urlencoded)

    • ▲

      removed the enum value group_scoped_quota_rules of the request property / (media type: multipart/form-data)

    • ○

      added the new appointment_type enum value to the request property / (media type: application/json)

    • ○

      added the new appointment_type enum value to the request property / (media type: application/x-www-form-urlencoded)

    • ○

      added the new appointment_type enum value to the request property / (media type: multipart/form-data)

    • ○

      added the new appointment_type_scoped_availability_windows enum value to the request property / (media type: application/json)

    • ○

      added the new appointment_type_scoped_availability_windows enum value to the request property / (media type: application/x-www-form-urlencoded)

    • ○

      added the new appointment_type_scoped_availability_windows enum value to the request property / (media type: multipart/form-data)

    • ○

      added the new appointment_type_scoped_blocked_times enum value to the request property / (media type: application/json)

    • ○

      added the new appointment_type_scoped_blocked_times enum value to the request property / (media type: application/x-www-form-urlencoded)

    • ○

      added the new appointment_type_scoped_blocked_times enum value to the request property / (media type: multipart/form-data)

    • ○

      added the new appointment_type_scoped_quota_rules enum value to the request property / (media type: application/json)

    • ○

      added the new appointment_type_scoped_quota_rules enum value to the request property / (media type: application/x-www-form-urlencoded)

    • ○

      added the new appointment_type_scoped_quota_rules enum value to the request property / (media type: multipart/form-data)

    • ○

      added the new batch_upsert_appointment_type_scoped_availability_windows enum value to the request property / (media type: application/json)

    • ○

      added the new batch_upsert_appointment_type_scoped_availability_windows enum value to the request property / (media type: application/x-www-form-urlencoded)

    • ○

      added the new batch_upsert_appointment_type_scoped_availability_windows enum value to the request property / (media type: multipart/form-data)

    • ○

      added the new batch_upsert_appointment_type_scoped_blocked_times enum value to the request property / (media type: application/json)

    • ○

      added the new batch_upsert_appointment_type_scoped_blocked_times enum value to the request property / (media type: application/x-www-form-urlencoded)

    • ○

      added the new batch_upsert_appointment_type_scoped_blocked_times enum value to the request property / (media type: multipart/form-data)

    • ○

      added the new batch_upsert_appointment_type_scoped_quota_rules enum value to the request property / (media type: application/json)

    • ○

      added the new batch_upsert_appointment_type_scoped_quota_rules enum value to the request property / (media type: application/x-www-form-urlencoded)

    • ○

      added the new batch_upsert_appointment_type_scoped_quota_rules enum value to the request property / (media type: multipart/form-data)

  • 722e2911db6eRevision changes
    • ○

      added the new calendar_pool enum value to the request property / (media type: application/json)

    • ○

      added the new calendar_pool enum value to the request property / (media type: application/x-www-form-urlencoded)

    • ○

      added the new calendar_pool enum value to the request property / (media type: multipart/form-data)