Grist Octri Preview
PATCH/service-accounts/{saId}

Modify a service account

This updates a service account's label, description or expiration date.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter · 3 body fields
saIdintegeroptional
A service account id
descriptionstringoptional
Description of service account's purpose
expiresAtstringoptional
The service account's expiration date
labelstringoptional
The service account's display name

3 status codes
200Success (empty body)
403The caller is not allowed to modify this service account
404Service account not found

Error handling

A 403 is returned: The caller is not allowed to modify this service account. A 404 is returned: Service account not found.