Grist Octri Preview
POST/service-accounts

Create a service account

This creates a new service account with a new API key.

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

3 body fields
descriptionstringoptional
Description of service account's purpose
expiresAtstringrequired
The service account's expiration date
labelstringoptional
The service account's display name

2 status codes
200The service account created
descriptionstringrequired
expiresAtdaterequired
hasValidKeybooleanrequired
idnumberrequired
labelstringrequired
loginstringrequired
keystringoptional
403The caller is not allowed to create service accounts

Error handling

A 403 is returned: The caller is not allowed to create service accounts.