Skip to content
For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Primary navigation

Suggested
Overview Models Agents Tools Audio & voice Production API reference

Organization

OrganizationAdmin API Keys

Create admin API key
admin.organization.admin_api_keys.create(**kwargs) -> AdminAPIKeyCreateResponse
POST
/organization/admin_api_keys
Delete admin API key
admin.organization.admin_api_keys.delete(key_id) -> AdminAPIKeyDeleteResponse
DELETE
/organization/admin_api_keys/{key_id}
List all organization and project API keys.
admin.organization.admin_api_keys.list(**kwargs) -> SyncCursorPage[AdminAPIKey]
GET
/organization/admin_api_keys
Retrieve admin API key
admin.organization.admin_api_keys.retrieve(key_id) -> AdminAPIKey
GET
/organization/admin_api_keys/{key_id}
Models
class AdminAPIKey: …

Represents an individual Admin API key in an org.

class AdminAPIKeyCreateResponse: …

Represents an individual Admin API key in an org.

class AdminAPIKeyDeleteResponse: …

OrganizationAudit Logs

List user actions and configuration changes within this organization.

List audit logs
admin.organization.audit_logs.list(**kwargs) -> SyncConversationCursorPage[AuditLogListResponse]
GET
/organization/audit_logs
Models
class AuditLogListResponse: …

A log of a user action or configuration change within this organization.

OrganizationCertificates

Activate certificates for organization
admin.organization.certificates.activate(**kwargs) -> SyncPage[CertificateActivateResponse]
POST
/organization/certificates/activate
Upload certificate
admin.organization.certificates.create(**kwargs) -> Certificate
POST
/organization/certificates
Deactivate certificates for organization
admin.organization.certificates.deactivate(**kwargs) -> SyncPage[CertificateDeactivateResponse]
POST
/organization/certificates/deactivate
Delete certificate
admin.organization.certificates.delete(certificate_id) -> CertificateDeleteResponse
DELETE
/organization/certificates/{certificate_id}
List organization certificates
admin.organization.certificates.list(**kwargs) -> SyncConversationCursorPage[CertificateListResponse]
GET
/organization/certificates
Get certificate
admin.organization.certificates.retrieve(certificate_id, **kwargs) -> Certificate
GET
/organization/certificates/{certificate_id}
Modify certificate
admin.organization.certificates.update(certificate_id, **kwargs) -> Certificate
POST
/organization/certificates/{certificate_id}
Models
class Certificate: …

Represents an individual certificate uploaded to the organization.

class CertificateActivateResponse: …

Represents an individual certificate configured at the organization level.

class CertificateDeactivateResponse: …

Represents an individual certificate configured at the organization level.

class CertificateDeleteResponse: …
class CertificateListResponse: …

Represents an individual certificate configured at the organization level.

OrganizationData Retention

Retrieve organization data retention
admin.organization.data_retention.retrieve() -> OrganizationDataRetention
GET
/organization/data_retention
Update organization data retention
admin.organization.data_retention.update(**kwargs) -> OrganizationDataRetention
POST
/organization/data_retention
Models
class OrganizationDataRetention: …

Represents the organization’s data retention control setting.

OrganizationExternal Storage

Create an external storage configuration
admin.organization.external_storage.create(**kwargs) -> ExternalStorageConfiguration
POST
/organization/external_storage
Delete an external storage configuration
admin.organization.external_storage.delete(external_storage_id) -> ExternalStorageDeleted
DELETE
/organization/external_storage/{external_storage_id}
List external storage configurations
admin.organization.external_storage.list(**kwargs) -> SyncCursorPage[ExternalStorageConfiguration]
GET
/organization/external_storage
Get an external storage configuration
admin.organization.external_storage.retrieve(external_storage_id) -> ExternalStorageConfiguration
GET
/organization/external_storage/{external_storage_id}
Validate an external storage configuration
admin.organization.external_storage.validate(external_storage_id) -> ExternalStorageConfiguration
POST
/organization/external_storage/{external_storage_id}/validate
Models
class AwsExternalStorageProvider: …
class AzureExternalStorageProvider: …
class ExternalStorageConfiguration: …
class ExternalStorageDeleted: …
class GcpExternalStorageProvider: …
class OciExternalStorageProvider: …

OrganizationGroups

Create group
admin.organization.groups.create(**kwargs) -> Group
POST
/organization/groups
Delete group
admin.organization.groups.delete(group_id) -> GroupDeleteResponse
DELETE
/organization/groups/{group_id}
List groups
admin.organization.groups.list(**kwargs) -> SyncNextCursorPage[Group]
GET
/organization/groups
Retrieve group
admin.organization.groups.retrieve(group_id) -> Group
GET
/organization/groups/{group_id}
Update group
admin.organization.groups.update(group_id, **kwargs) -> GroupUpdateResponse
POST
/organization/groups/{group_id}
Models
class Group: …

Details about an organization group.

class GroupDeleteResponse: …

Confirmation payload returned after deleting a group.

class GroupUpdateResponse: …

Response returned after updating a group.

OrganizationGroupsRoles

Assign organization role to group
admin.organization.groups.roles.create(group_id, **kwargs) -> RoleCreateResponse
POST
/organization/groups/{group_id}/roles
Unassign organization role from group
admin.organization.groups.roles.delete(role_id, **kwargs) -> RoleDeleteResponse
DELETE
/organization/groups/{group_id}/roles/{role_id}
List group organization role assignments
admin.organization.groups.roles.list(group_id, **kwargs) -> SyncNextCursorPage[RoleListResponse]
GET
/organization/groups/{group_id}/roles
Retrieve group organization role
admin.organization.groups.roles.retrieve(role_id, **kwargs) -> RoleRetrieveResponse
GET
/organization/groups/{group_id}/roles/{role_id}
Models
class RoleCreateResponse: …

Role assignment linking a group to a role.

class RoleDeleteResponse: …

Confirmation payload returned after unassigning a role.

class RoleListResponse: …

Detailed information about a role assignment entry returned when listing assignments.

class RoleRetrieveResponse: …

Detailed information about a role assignment entry returned when listing assignments.

OrganizationGroupsUsers

Add group user
admin.organization.groups.users.create(group_id, **kwargs) -> UserCreateResponse
POST
/organization/groups/{group_id}/users
Remove group user
admin.organization.groups.users.delete(user_id, **kwargs) -> UserDeleteResponse
DELETE
/organization/groups/{group_id}/users/{user_id}
List group users
admin.organization.groups.users.list(group_id, **kwargs) -> SyncNextCursorPage[OrganizationGroupUser]
GET
/organization/groups/{group_id}/users
Retrieve group user
admin.organization.groups.users.retrieve(user_id, **kwargs) -> UserRetrieveResponse
GET
/organization/groups/{group_id}/users/{user_id}
Models
class OrganizationGroupUser: …

Represents an individual user returned when inspecting group membership.

class UserCreateResponse: …

Confirmation payload returned after adding a user to a group.

class UserDeleteResponse: …

Confirmation payload returned after removing a user from a group.

class UserRetrieveResponse: …

Details about a user returned from an organization group membership lookup.

OrganizationInvites

Create invite
admin.organization.invites.create(**kwargs) -> Invite
POST
/organization/invites
Delete invite
admin.organization.invites.delete(invite_id) -> InviteDeleteResponse
DELETE
/organization/invites/{invite_id}
List invites
admin.organization.invites.list(**kwargs) -> SyncConversationCursorPage[Invite]
GET
/organization/invites
Retrieve invite
admin.organization.invites.retrieve(invite_id) -> Invite
GET
/organization/invites/{invite_id}
Models
class Invite: …

Represents an individual invite to the organization.

class InviteDeleteResponse: …

OrganizationProjects

Archive project
admin.organization.projects.archive(project_id) -> Project
POST
/organization/projects/{project_id}/archive
Create project
admin.organization.projects.create(**kwargs) -> Project
POST
/organization/projects
List projects
admin.organization.projects.list(**kwargs) -> SyncConversationCursorPage[Project]
GET
/organization/projects
Retrieve project
admin.organization.projects.retrieve(project_id) -> Project
GET
/organization/projects/{project_id}
Modify project
admin.organization.projects.update(project_id, **kwargs) -> Project
POST
/organization/projects/{project_id}
Models
class Project: …

Represents an individual project.

Literal["GLOBAL", "US_STORAGE_PROCESSING", "EU_STORAGE_PROCESSING", 12 more]

OrganizationProjectsAPI Keys

Delete project API key
admin.organization.projects.api_keys.delete(api_key_id, **kwargs) -> APIKeyDeleteResponse
DELETE
/organization/projects/{project_id}/api_keys/{api_key_id}
List project API keys
admin.organization.projects.api_keys.list(project_id, **kwargs) -> SyncConversationCursorPage[ProjectAPIKey]
GET
/organization/projects/{project_id}/api_keys
Retrieve project API key
admin.organization.projects.api_keys.retrieve(api_key_id, **kwargs) -> ProjectAPIKey
GET
/organization/projects/{project_id}/api_keys/{api_key_id}
Update project API key
admin.organization.projects.api_keys.update(api_key_id, **kwargs) -> ProjectAPIKey
POST
/organization/projects/{project_id}/api_keys/{api_key_id}
Models
class APIKeyDeleteResponse: …
class ProjectAPIKey: …

Represents an individual API key in a project.

OrganizationProjectsCertificates

Activate certificates for project
admin.organization.projects.certificates.activate(project_id, **kwargs) -> SyncPage[CertificateActivateResponse]
POST
/organization/projects/{project_id}/certificates/activate
Deactivate certificates for project
admin.organization.projects.certificates.deactivate(project_id, **kwargs) -> SyncPage[CertificateDeactivateResponse]
POST
/organization/projects/{project_id}/certificates/deactivate
List project certificates
admin.organization.projects.certificates.list(project_id, **kwargs) -> SyncConversationCursorPage[CertificateListResponse]
GET
/organization/projects/{project_id}/certificates
Models
class CertificateActivateResponse: …

Represents an individual certificate configured at the project level.

class CertificateDeactivateResponse: …

Represents an individual certificate configured at the project level.

class CertificateListResponse: …

Represents an individual certificate configured at the project level.

OrganizationProjectsData Retention

Retrieve project data retention
admin.organization.projects.data_retention.retrieve(project_id) -> ProjectDataRetention
GET
/organization/projects/{project_id}/data_retention
Update project data retention
admin.organization.projects.data_retention.update(project_id, **kwargs) -> ProjectDataRetention
POST
/organization/projects/{project_id}/data_retention
Models
class ProjectDataRetention: …

Represents a project’s data retention control setting.

OrganizationProjectsGroups

Add project group
admin.organization.projects.groups.create(project_id, **kwargs) -> ProjectGroup
POST
/organization/projects/{project_id}/groups
Remove project group
admin.organization.projects.groups.delete(group_id, **kwargs) -> GroupDeleteResponse
DELETE
/organization/projects/{project_id}/groups/{group_id}
List project groups
admin.organization.projects.groups.list(project_id, **kwargs) -> SyncNextCursorPage[ProjectGroup]
GET
/organization/projects/{project_id}/groups
Retrieve project group
admin.organization.projects.groups.retrieve(group_id, **kwargs) -> ProjectGroup
GET
/organization/projects/{project_id}/groups/{group_id}
Models
class GroupDeleteResponse: …

Confirmation payload returned after removing a group from a project.

class ProjectGroup: …

Details about a group’s membership in a project.

OrganizationProjectsGroupsRoles

Assign project role to group
admin.organization.projects.groups.roles.create(group_id, **kwargs) -> RoleCreateResponse
POST
/projects/{project_id}/groups/{group_id}/roles
Unassign project role from group
admin.organization.projects.groups.roles.delete(role_id, **kwargs) -> RoleDeleteResponse
DELETE
/projects/{project_id}/groups/{group_id}/roles/{role_id}
List project group role assignments
admin.organization.projects.groups.roles.list(group_id, **kwargs) -> SyncNextCursorPage[RoleListResponse]
GET
/projects/{project_id}/groups/{group_id}/roles
Retrieve project group role
admin.organization.projects.groups.roles.retrieve(role_id, **kwargs) -> RoleRetrieveResponse
GET
/projects/{project_id}/groups/{group_id}/roles/{role_id}
Models
class RoleCreateResponse: …

Role assignment linking a group to a role.

class RoleDeleteResponse: …

Confirmation payload returned after unassigning a role.

class RoleListResponse: …

Detailed information about a role assignment entry returned when listing assignments.

class RoleRetrieveResponse: …

Detailed information about a role assignment entry returned when listing assignments.

OrganizationProjectsHosted Tool Permissions

Retrieve project hosted tool permissions
admin.organization.projects.hosted_tool_permissions.retrieve(project_id) -> ProjectHostedToolPermissions
GET
/organization/projects/{project_id}/hosted_tool_permissions
Modify project hosted tool permissions
admin.organization.projects.hosted_tool_permissions.update(project_id, **kwargs) -> ProjectHostedToolPermissions
POST
/organization/projects/{project_id}/hosted_tool_permissions
Models
class ProjectHostedToolPermissions: …

Represents hosted tool permissions for a project.

OrganizationProjectsModel Permissions

Delete project model permissions
admin.organization.projects.model_permissions.delete(project_id) -> ProjectModelPermissionsDeleted
DELETE
/organization/projects/{project_id}/model_permissions
Retrieve project model permissions
admin.organization.projects.model_permissions.retrieve(project_id) -> ProjectModelPermissions
GET
/organization/projects/{project_id}/model_permissions
Modify project model permissions
admin.organization.projects.model_permissions.update(project_id, **kwargs) -> ProjectModelPermissions
POST
/organization/projects/{project_id}/model_permissions
Models
class ProjectModelPermissions: …

Represents the model allowlist or denylist policy for a project.

class ProjectModelPermissionsDeleted: …

Confirmation payload returned after deleting project model permissions.

OrganizationProjectsRate Limits

List project rate limits
admin.organization.projects.rate_limits.list_rate_limits(project_id, **kwargs) -> SyncConversationCursorPage[ProjectRateLimit]
GET
/organization/projects/{project_id}/rate_limits
Modify project rate limit
admin.organization.projects.rate_limits.update_rate_limit(rate_limit_id, **kwargs) -> ProjectRateLimit
POST
/organization/projects/{project_id}/rate_limits/{rate_limit_id}
Models
class ProjectRateLimit: …

Represents a project rate limit config.

OrganizationProjectsRoles

Create project role
admin.organization.projects.roles.create(project_id, **kwargs) -> Role
POST
/projects/{project_id}/roles
Delete project role
admin.organization.projects.roles.delete(role_id, **kwargs) -> RoleDeleteResponse
DELETE
/projects/{project_id}/roles/{role_id}
List project roles
admin.organization.projects.roles.list(project_id, **kwargs) -> SyncNextCursorPage[Role]
GET
/projects/{project_id}/roles
Retrieve project role
admin.organization.projects.roles.retrieve(role_id, **kwargs) -> Role
GET
/projects/{project_id}/roles/{role_id}
Update project role
admin.organization.projects.roles.update(role_id, **kwargs) -> Role
POST
/projects/{project_id}/roles/{role_id}
Models
class RoleDeleteResponse: …

Confirmation payload returned after deleting a role.

OrganizationProjectsService Accounts

Create project service account
admin.organization.projects.service_accounts.create(project_id, **kwargs) -> ServiceAccountCreateResponse
POST
/organization/projects/{project_id}/service_accounts
Delete project service account
admin.organization.projects.service_accounts.delete(service_account_id, **kwargs) -> ServiceAccountDeleteResponse
DELETE
/organization/projects/{project_id}/service_accounts/{service_account_id}
List project service accounts
admin.organization.projects.service_accounts.list(project_id, **kwargs) -> SyncConversationCursorPage[ProjectServiceAccount]
GET
/organization/projects/{project_id}/service_accounts
Retrieve project service account
admin.organization.projects.service_accounts.retrieve(service_account_id, **kwargs) -> ProjectServiceAccount
GET
/organization/projects/{project_id}/service_accounts/{service_account_id}
Update project service account
admin.organization.projects.service_accounts.update(service_account_id, **kwargs) -> ProjectServiceAccount
POST
/organization/projects/{project_id}/service_accounts/{service_account_id}
Models
class ProjectServiceAccount: …

Represents an individual service account in a project.

class ServiceAccountCreateResponse: …
class ServiceAccountDeleteResponse: …

OrganizationProjectsService AccountsAPI Keys

Create an API key for a service account
admin.organization.projects.service_accounts.api_keys.create(service_account_id, **kwargs) -> APIKeyCreateResponse
POST
/organization/projects/{project_id}/service_accounts/{service_account_id}/api_keys
Models
class APIKeyCreateResponse: …

OrganizationProjectsSpend Alerts

Create project spend alert
admin.organization.projects.spend_alerts.create(project_id, **kwargs) -> ProjectSpendAlert
POST
/organization/projects/{project_id}/spend_alerts
Delete project spend alert
admin.organization.projects.spend_alerts.delete(alert_id, **kwargs) -> ProjectSpendAlertDeleted
DELETE
/organization/projects/{project_id}/spend_alerts/{alert_id}
List project spend alerts
admin.organization.projects.spend_alerts.list(project_id, **kwargs) -> SyncConversationCursorPage[ProjectSpendAlert]
GET
/organization/projects/{project_id}/spend_alerts
Retrieve project spend alert
admin.organization.projects.spend_alerts.retrieve(alert_id, **kwargs) -> ProjectSpendAlert
GET
/organization/projects/{project_id}/spend_alerts/{alert_id}
Update project spend alert
admin.organization.projects.spend_alerts.update(alert_id, **kwargs) -> ProjectSpendAlert
POST
/organization/projects/{project_id}/spend_alerts/{alert_id}
Models
class ProjectSpendAlert: …

Represents a spend alert configured at the project level.

class ProjectSpendAlertDeleted: …

Confirmation payload returned after deleting a project spend alert.

OrganizationProjectsSpend Limit

Delete project spend limit
admin.organization.projects.spend_limit.delete(project_id) -> ProjectSpendLimitDeleted
DELETE
/organization/projects/{project_id}/spend_limit
Get project spend limit
admin.organization.projects.spend_limit.retrieve(project_id) -> ProjectSpendLimit
GET
/organization/projects/{project_id}/spend_limit
Update project spend limit
admin.organization.projects.spend_limit.update(project_id, **kwargs) -> ProjectSpendLimit
POST
/organization/projects/{project_id}/spend_limit
Models
class ProjectSpendLimit: …

Represents a hard spend limit configured at the project level.

class ProjectSpendLimitDeleted: …

Confirmation payload returned after deleting a project hard spend limit.

OrganizationProjectsUsers

Create project user
admin.organization.projects.users.create(project_id, **kwargs) -> ProjectUser
POST
/organization/projects/{project_id}/users
Delete project user
admin.organization.projects.users.delete(user_id, **kwargs) -> UserDeleteResponse
DELETE
/organization/projects/{project_id}/users/{user_id}
List project users
admin.organization.projects.users.list(project_id, **kwargs) -> SyncConversationCursorPage[ProjectUser]
GET
/organization/projects/{project_id}/users
Retrieve project user
admin.organization.projects.users.retrieve(user_id, **kwargs) -> ProjectUser
GET
/organization/projects/{project_id}/users/{user_id}
Modify project user
admin.organization.projects.users.update(user_id, **kwargs) -> ProjectUser
POST
/organization/projects/{project_id}/users/{user_id}
Models
class ProjectUser: …

Represents an individual user in a project.

class UserDeleteResponse: …

OrganizationProjectsUsersRoles

Assign project role to user
admin.organization.projects.users.roles.create(user_id, **kwargs) -> RoleCreateResponse
POST
/projects/{project_id}/users/{user_id}/roles
Unassign project role from user
admin.organization.projects.users.roles.delete(role_id, **kwargs) -> RoleDeleteResponse
DELETE
/projects/{project_id}/users/{user_id}/roles/{role_id}
List project user role assignments
admin.organization.projects.users.roles.list(user_id, **kwargs) -> SyncNextCursorPage[RoleListResponse]
GET
/projects/{project_id}/users/{user_id}/roles
Retrieve project user role
admin.organization.projects.users.roles.retrieve(role_id, **kwargs) -> RoleRetrieveResponse
GET
/projects/{project_id}/users/{user_id}/roles/{role_id}
Models
class RoleCreateResponse: …

Role assignment linking a user to a role.

class RoleDeleteResponse: …

Confirmation payload returned after unassigning a role.

class RoleListResponse: …

Detailed information about a role assignment entry returned when listing assignments.

class RoleRetrieveResponse: …

Detailed information about a role assignment entry returned when listing assignments.

OrganizationRoles

Create organization role
admin.organization.roles.create(**kwargs) -> Role
POST
/organization/roles
Delete organization role
admin.organization.roles.delete(role_id) -> RoleDeleteResponse
DELETE
/organization/roles/{role_id}
List organization roles
admin.organization.roles.list(**kwargs) -> SyncNextCursorPage[Role]
GET
/organization/roles
Retrieve organization role
admin.organization.roles.retrieve(role_id) -> Role
GET
/organization/roles/{role_id}
Update organization role
admin.organization.roles.update(role_id, **kwargs) -> Role
POST
/organization/roles/{role_id}
Models
class Role: …

Details about a role that can be assigned through the public Roles API.

class RoleDeleteResponse: …

Confirmation payload returned after deleting a role.

OrganizationSpend Alerts

Create organization spend alert
admin.organization.spend_alerts.create(**kwargs) -> OrganizationSpendAlert
POST
/organization/spend_alerts
Delete organization spend alert
admin.organization.spend_alerts.delete(alert_id) -> OrganizationSpendAlertDeleted
DELETE
/organization/spend_alerts/{alert_id}
List organization spend alerts
admin.organization.spend_alerts.list(**kwargs) -> SyncConversationCursorPage[OrganizationSpendAlert]
GET
/organization/spend_alerts
Retrieve organization spend alert
admin.organization.spend_alerts.retrieve(alert_id) -> OrganizationSpendAlert
GET
/organization/spend_alerts/{alert_id}
Update organization spend alert
admin.organization.spend_alerts.update(alert_id, **kwargs) -> OrganizationSpendAlert
POST
/organization/spend_alerts/{alert_id}
Models
class OrganizationSpendAlert: …

Represents a spend alert configured at the organization level.

class OrganizationSpendAlertDeleted: …

Confirmation payload returned after deleting an organization spend alert.

OrganizationSpend Limit

Delete organization spend limit
admin.organization.spend_limit.delete() -> OrganizationSpendLimitDeleted
DELETE
/organization/spend_limit
Get organization spend limit
admin.organization.spend_limit.retrieve() -> OrganizationSpendLimit
GET
/organization/spend_limit
Update organization spend limit
admin.organization.spend_limit.update(**kwargs) -> OrganizationSpendLimit
POST
/organization/spend_limit
Models
class OrganizationSpendLimit: …

Represents a hard spend limit configured at the organization level.

class OrganizationSpendLimitDeleted: …

Confirmation payload returned after deleting an organization hard spend limit.

OrganizationUsage

Audio speeches
admin.organization.usage.audio_speeches(**kwargs) -> UsageAudioSpeechesResponse
GET
/organization/usage/audio_speeches
Audio transcriptions
admin.organization.usage.audio_transcriptions(**kwargs) -> UsageAudioTranscriptionsResponse
GET
/organization/usage/audio_transcriptions
Code interpreter sessions
admin.organization.usage.code_interpreter_sessions(**kwargs) -> UsageCodeInterpreterSessionsResponse
GET
/organization/usage/code_interpreter_sessions
Completions
admin.organization.usage.completions(**kwargs) -> UsageCompletionsResponse
GET
/organization/usage/completions
Costs
admin.organization.usage.costs(**kwargs) -> UsageCostsResponse
GET
/organization/costs
Decisions
admin.organization.usage.decisions(**kwargs) -> UsageDecisionsResponse
GET
/organization/usage/decisions
Embeddings
admin.organization.usage.embeddings(**kwargs) -> UsageEmbeddingsResponse
GET
/organization/usage/embeddings
File search calls
admin.organization.usage.file_search_calls(**kwargs) -> UsageFileSearchCallsResponse
GET
/organization/usage/file_search_calls
Images
admin.organization.usage.images(**kwargs) -> UsageImagesResponse
GET
/organization/usage/images
Moderations
admin.organization.usage.moderations(**kwargs) -> UsageModerationsResponse
GET
/organization/usage/moderations
Vector stores
admin.organization.usage.vector_stores(**kwargs) -> UsageVectorStoresResponse
GET
/organization/usage/vector_stores
Web search calls
admin.organization.usage.web_search_calls(**kwargs) -> UsageWebSearchCallsResponse
GET
/organization/usage/web_search_calls
Models
Union[str, Literal["tokens", "1000_tokens", "duration_seconds", 5 more], null]

The unit of the quantity value. If no single supported unit applies to the result, this field is null.

class UsageAudioSpeechesResponse: …
class UsageAudioTranscriptionsResponse: …
class UsageCodeInterpreterSessionsResponse: …
class UsageCompletionsResponse: …
class UsageCostsResponse: …
class UsageDecisionsResponse: …
class UsageEmbeddingsResponse: …
class UsageFileSearchCallsResponse: …
class UsageImagesResponse: …
class UsageModerationsResponse: …
class UsageVectorStoresResponse: …
class UsageWebSearchCallsResponse: …

OrganizationUsers

Delete user
admin.organization.users.delete(user_id) -> UserDeleteResponse
DELETE
/organization/users/{user_id}
List users
admin.organization.users.list(**kwargs) -> SyncConversationCursorPage[OrganizationUser]
GET
/organization/users
Retrieve user
admin.organization.users.retrieve(user_id) -> OrganizationUser
GET
/organization/users/{user_id}
Modify user
admin.organization.users.update(user_id, **kwargs) -> OrganizationUser
POST
/organization/users/{user_id}
Models
class OrganizationUser: …

Represents an individual user within an organization.

class UserDeleteResponse: …

OrganizationUsersRoles

Assign organization role to user
admin.organization.users.roles.create(user_id, **kwargs) -> RoleCreateResponse
POST
/organization/users/{user_id}/roles
Unassign organization role from user
admin.organization.users.roles.delete(role_id, **kwargs) -> RoleDeleteResponse
DELETE
/organization/users/{user_id}/roles/{role_id}
List user organization role assignments
admin.organization.users.roles.list(user_id, **kwargs) -> SyncNextCursorPage[RoleListResponse]
GET
/organization/users/{user_id}/roles
Retrieve user organization role
admin.organization.users.roles.retrieve(role_id, **kwargs) -> RoleRetrieveResponse
GET
/organization/users/{user_id}/roles/{role_id}
Models
class RoleCreateResponse: …

Role assignment linking a user to a role.

class RoleDeleteResponse: …

Confirmation payload returned after unassigning a role.

class RoleListResponse: …

Detailed information about a role assignment entry returned when listing assignments.

class RoleRetrieveResponse: …

Detailed information about a role assignment entry returned when listing assignments.