cURL
curl --request PUT \ --url https://api.example.com/api/v1/organizations/{organizationID}/serviceaccounts/{serviceAccountID} \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "metadata": { "name": "my-service-account", "description": "A service account for doing stuff." }, "spec": { "groupIDs": [ "0aaba80d-67ef-4799-b6d9-59f37e2ce2ad" ] } } '
{ "metadata": { "id": "ee45f34b-9685-40d8-8724-23c31252ca46", "name": "my-service-account", "organizationId": "d4600d6e-e965-4b44-a808-84fb2fa36702", "creationTime": "2024-05-31T14:11:00Z", "provisioningStatus": "provisioned", "healthStatus": "healthy" }, "spec": { "groupIDs": [ "f2000047-19f8-426e-93b9-9f0a5bfa0edd" ] }, "status": { "expiry": "2025-03-14T16:10:00Z" } }
Updates a service account.
Operation requires OAuth 2.0 bearer token authentication.
An organization ID.
A service account ID.
Body required to create a service account.
A service account creation request.
Metadata required for all API resource reads and writes.
Show child attributes
A valid Kubernetes label value, typically used for resource names that can be indexed in the database.
The resource description, this optionally augments the name with more context.
A list of tags.
A unique tag name.
The value of the tag.
A service account specification.
A list of group IDs.
A group ID.
A service accounts.
A service account.
Metadata required by organization scoped resource reads.
The unique resource ID.
The time the resource was created.
The provisioning state of a resource.
unknown
provisioning
provisioned
deprovisioning
error
The health state of a resource.
healthy
degraded
The organization identifier the resource belongs to.
The user who created the resource.
The time a resource was updated.
The user who updated the resource.
The time the resource was deleted.
A service account status.
When the service token is due to expire.
A long lived access token that can be exchanged for an API access token.