The API key description. TIP: Useful when you have multiple API keys.
keystring
The API key. TIP: Since the API key is returned only once, save it in a safe place.
creation_datestring · format: date-timerequired
The date/time for when the API key is created.
expiration_datestring · format: date-time
The date/time when the API key expires.
role_assignmentsobject
Roles assigned to users, API keys or organization invitations. Currently unavailable in self-hosted ECE.
platformobject[]
Assignments for roles with platform scope.
role_idstringrequired
The ID of the role that is assigned.
organizationobject[]
Assignments for roles with organization scope.
role_idstringrequired
The ID of the role that is assigned.
organization_idstringrequired
The ID of the organization the role is scoped to.
application_rolesstring[]
If provided, the user assigned this role assignment will be granted this application role when signing in to a deployment or project
deploymentobject[]
Assignments for roles with deployment scope.
role_idstringrequired
The ID of the role that is assigned.
organization_idstringrequired
The ID of the organization the role is scoped to.
allboolean
When true, the role applies to all deployments in the organization, otherwise the role is scoped to the deployments specified in deployment_ids.
deployment_idsstring[]
The IDs of the deployments the role is scoped to. Must be absent if all is true, and present if all is false.
application_rolesstring[]
If provided, the user assigned this role assignment will be granted this application role when signing in to the deployment(s) specified in the role assignment.
projectobject
Assignments for roles with project scope.
elasticsearchobject[]
The Elasticsearch project-scoped role assignments to set
role_idstringrequired
The ID of the role that is assigned.
organization_idstringrequired
The ID of the organization the role is scoped to.
allboolean
When true, the role applies to all projects in the organization, otherwise the role is scoped to the projects specified in project_ids.
project_idsstring[]
The IDs of the projects the role is scoped to. Must be absent if all is true, and present if all is false.
application_rolesstring[]
If provided, the user assigned this role assignment will be granted this application role when signing in to the project(s) specified in the role assignment.
observabilityobject[]
The Observability project-scoped role assignments to set
role_idstringrequired
The ID of the role that is assigned.
organization_idstringrequired
The ID of the organization the role is scoped to.
allboolean
When true, the role applies to all projects in the organization, otherwise the role is scoped to the projects specified in project_ids.
project_idsstring[]
The IDs of the projects the role is scoped to. Must be absent if all is true, and present if all is false.
application_rolesstring[]
If provided, the user assigned this role assignment will be granted this application role when signing in to the project(s) specified in the role assignment.
securityobject[]
The Security project-scoped role assignments to set
role_idstringrequired
The ID of the role that is assigned.
organization_idstringrequired
The ID of the organization the role is scoped to.
allboolean
When true, the role applies to all projects in the organization, otherwise the role is scoped to the projects specified in project_ids.
project_idsstring[]
The IDs of the projects the role is scoped to. Must be absent if all is true, and present if all is false.
application_rolesstring[]
If provided, the user assigned this role assignment will be granted this application role when signing in to the project(s) specified in the role assignment.
workplaceaiobject[]
The WorkplaceAI project-scoped role assignments to set
role_idstringrequired
The ID of the role that is assigned.
organization_idstringrequired
The ID of the organization the role is scoped to.
allboolean
When true, the role applies to all projects in the organization, otherwise the role is scoped to the projects specified in project_ids.
project_idsstring[]
The IDs of the projects the role is scoped to. Must be absent if all is true, and present if all is false.
application_rolesstring[]
If provided, the user assigned this role assignment will be granted this application role when signing in to the project(s) specified in the role assignment.
vectordbobject[]
The VectorDB project-scoped role assignments to set
role_idstringrequired
The ID of the role that is assigned.
organization_idstringrequired
The ID of the organization the role is scoped to.
allboolean
When true, the role applies to all projects in the organization, otherwise the role is scoped to the projects specified in project_ids.
project_idsstring[]
The IDs of the projects the role is scoped to. Must be absent if all is true, and present if all is false.
application_rolesstring[]
If provided, the user assigned this role assignment will be granted this application role when signing in to the project(s) specified in the role assignment.
next_pagestring
A cursor to get the next page of results
The {user_id} can't be found. (code: api_keys.user_not_found)
application/json
errorsobject[]required
A list of errors that occurred in the failing request
codestringrequired
A structured code representing the error type that occurred
messagestringrequired
A human readable message describing the error that occurred
fieldsstring[]
If the error can be tied to a specific field or fields in the user request, this lists those fields