openai-api — quality + safety report

---
name: openai-api
description: "OpenAI API skill. Use when working with OpenAI for assistants, audio, batches. Covers 148 endpoints."
version: 1.0.0
generator: lapsh
---

# OpenAI API
API version: 2.3.0

## Auth
Bearer bearer

## Base URL
https://api.openai.com/v1

## Setup
1. Set Authorization header with your Bearer token
2. GET /assistants -- verify access
3. POST /assistants -- create first assistants

## Endpoints

148 endpoints across 18 groups. See references/api-spec.lap for full details.

### assistants
| Method | Path | Description |
|--------|------|-------------|
| GET | /assistants | Returns a list of assistants. |
| POST | /assistants | Create an assistant with a model and instructions. |
| GET | /assistants/{assistant_id} | Retrieves an assistant. |
| POST | /assistants/{assistant_id} | Modifies an assistant. |
| DELETE | /assistants/{assistant_id} | Delete an assistant. |

### audio
| Method | Path | Description |
|--------|------|-------------|
| POST | /audio/speech | Generates audio from the input text. |
| POST | /audio/transcriptions | Transcribes audio into the input language. |
| POST | /audio/translations | Translates audio into English. |

### batches
| Method | Path | Description |
|--------|------|-------------|
| POST | /batches | Creates and executes a batch from an uploaded file of requests |
| GET | /batches | List your organization's batches. |
| GET | /batches/{batch_id} | Retrieves a batch. |
| POST | /batches/{batch_id}/cancel | Cancels an in-progress batch. The batch will be in status `cancelling` for up to 10 minutes, before changing to `cancelled`, where it will have partial results (if any) available in the output file. |

### chat
| Method | Path | Description |
|--------|------|-------------|
| GET | /chat/completions | List stored Chat Completions. Only Chat Completions that have been stored |
| POST | /chat/completions | **Starting a new project?** We recommend trying [Responses](/docs/api-reference/responses) |
| GET | /chat/completions/{completion_id} | Get a stored chat completion. Only Chat Completions that have been created |
| POST | /chat/completions/{completion_id} | Modify a stored chat completion. Only Chat Completions that have been |
| DELETE | /chat/completions/{completion_id} | Delete a stored chat completion. Only Chat Completions that have been |
| GET | /chat/completions/{completion_id}/messages | Get the messages in a stored chat completion. Only Chat Completions that |

### completions
| Method | Path | Description |
|--------|------|-------------|
| POST | /completions | Creates a completion for the provided prompt and parameters. |

### embeddings
| Method | Path | Description |
|--------|------|-------------|
| POST | /embeddings | Creates an embedding vector representing the input text. |

### evals
| Method | Path | Description |
|--------|------|-------------|
| GET | /evals | List evaluations for a project. |
| POST | /evals | Create the structure of an evaluation that can be used to test a model's performance. |
| GET | /evals/{eval_id} | Get an evaluation by ID. |
| POST | /evals/{eval_id} | Update certain properties of an evaluation. |
| DELETE | /evals/{eval_id} | Delete an evaluation. |
| GET | /evals/{eval_id}/runs | Get a list of runs for an evaluation. |
| POST | /evals/{eval_id}/runs | Create a new evaluation run. This is the endpoint that will kick off grading. |
| GET | /evals/{eval_id}/runs/{run_id} | Get an evaluation run by ID. |
| POST | /evals/{eval_id}/runs/{run_id} | Cancel an ongoing evaluation run. |
| DELETE | /evals/{eval_id}/runs/{run_id} | Delete an eval run. |
| GET | /evals/{eval_id}/runs/{run_id}/output_items | Get a list of output items for an evaluation run. |
| GET | /evals/{eval_id}/runs/{run_id}/output_items/{output_item_id} | Get an evaluation run output item by ID. |

### files
| Method | Path | Description |
|--------|------|-------------|
| GET | /files | Returns a list of files. |
| POST | /files | Upload a file that can be used across various endpoints. Individual files can be up to 512 MB, and the size of all files uploaded by one organization can be up to 100 GB. |
| DELETE | /files/{file_id} | Delete a file. |
| GET | /files/{file_id} | Returns information about a specific file. |
| GET | /files/{file_id}/content | Returns the contents of the specified file. |

### fine_tuning
| Method | Path | Description |
|--------|------|-------------|
| GET | /fine_tuning/checkpoints/{fine_tuned_model_checkpoint}/permissions | **NOTE:** This endpoint requires an [admin API key](../admin-api-keys). |
| POST | /fine_tuning/checkpoints/{fine_tuned_model_checkpoint}/permissions | **NOTE:** Calling this endpoint requires an [admin API key](../admin-api-keys). |
| DELETE | /fine_tuning/checkpoints/{fine_tuned_model_checkpoint}/permissions/{permission_id} | **NOTE:** This endpoint requires an [admin API key](../admin-api-keys). |
| POST | /fine_tuning/jobs | Creates a fine-tuning job which begins the process of creating a new model from a given dataset. |
| GET | /fine_tuning/jobs | List your organization's fine-tuning jobs |
| GET | /fine_tuning/jobs/{fine_tuning_job_id} | Get info about a fine-tuning job. |
| POST | /fine_tuning/jobs/{fine_tuning_job_id}/cancel | Immediately cancel a fine-tune job. |
| GET | /fine_tuning/jobs/{fine_tuning_job_id}/checkpoints | List checkpoints for a fine-tuning job. |
| GET | /fine_tuning/jobs/{fine_tuning_job_id}/events | Get status updates for a fine-tuning job. |

### images
| Method | Path | Description |
|--------|------|-------------|
| POST | /images/edits | Creates an edited or extended image given one or more source images and a prompt. This endpoint only supports `gpt-image-1` and `dall-e-2`. |
| POST | /images/generations | Creates an image given a prompt. [Learn more](/docs/guides/images). |
| POST | /images/variations | Creates a variation of a given image. This endpoint only supports `dall-e-2`. |

### models
| Method | Path | Description |
|--------|------|-------------|
| GET | /models | Lists the currently available models, and provides basic information about each one such as the owner and availability. |
| GET | /models/{model} | Retrieves a model instance, providing basic information about the model such as the owner and permissioning. |
| DELETE | /models/{model} | Delete a fine-tuned model. You must have the Owner role in your organization to delete a model. |

### moderations
| Method | Path | Description |
|--------|------|-------------|
| POST | /moderations | Classifies if text and/or image inputs are potentially harmful. Learn |

### organization
| Method | Path | Description |
|--------|------|-------------|
| GET | /organization/admin_api_keys | List organization API keys |
| POST | /organization/admin_api_keys | Create an organization admin API key |
| GET | /organization/admin_api_keys/{key_id} | Retrieve a single organization API key |
| DELETE | /organization/admin_api_keys/{key_id} | Delete an organization admin API key |
| GET | /organization/audit_logs | List user actions and configuration changes within this organization. |
| GET | /organization/certificates | List uploaded certificates for this organization. |
| POST | /organization/certificates | Upload a certificate to the organization. This does **not** automatically activate the certificate. |
| POST | /organization/certificates/activate | Activate certificates at the organization level. |
| POST | /organization/certificates/deactivate | Deactivate certificates at the organization level. |
| GET | /organization/certificates/{certificate_id} | Get a certificate that has been uploaded to the organization. |
| POST | /organization/certificates/{certificate_id} | Modify a certificate. Note that only the name can be modified. |
| DELETE | /organization/certificates/{certificate_id} | Delete a certificate from the organization. |
| GET | /organization/costs | Get costs details for the organization. |
| GET | /organization/invites | Returns a list of invites in the organization. |
| POST | /organization/invites | Create an invite for a user to the organization. The invite must be accepted by the user before they have access to the organization. |
| GET | /organization/invites/{invite_id} | Retrieves an invite. |
| DELETE | /organization/invites/{invite_id} | Delete an invite. If the invite has already been accepted, it cannot be deleted. |
| GET | /organization/projects | Returns a list of projects. |
| POST | /organization/projects | Create a new project in the organization. Projects can be created and archived, but cannot be deleted. |
| GET | /organization/projects/{project_id} | Retrieves a project. |
| POST | /organization/projects/{project_id} | Modifies a project in the organization. |
| GET | /organization/projects/{project_id}/api_keys | Returns a list of API keys in the project. |
| GET | /organization/projects/{project_id}/api_keys/{key_id} | Retrieves an API key in the project. |
| DELETE | /organization/projects/{project_id}/api_keys/{key_id} | Deletes an API key from the project. |
| POST | /organization/projects/{project_id}/archive | Archives a project in the organization. Archived projects cannot be used or updated. |
| GET | /organization/projects/{project_id}/certificates | List certificates for this project. |
| POST | /organization/projects/{project_id}/certificates/activate | Activate certificates at the project level. |
| POST | /organization/projects/{project_id}/certificates/deactivate | Deactivate certificates at the project level. |
| GET | /organization/projects/{project_id}/rate_limits | Returns the rate limits per model for a project. |
| POST | /organization/projects/{project_id}/rate_limits/{rate_limit_id} | Updates a project rate limit. |
| GET | /organization/projects/{project_id}/service_accounts | Returns a list of service accounts in the project. |
| POST | /organization/projects/{project_id}/service_accounts | Creates a new service account in the project. This also returns an unredacted API key for the service account. |
| GET | /organization/projects/{project_id}/service_accounts/{service_account_id} | Retrieves a service account in the project. |
| DELETE | /organization/projects/{project_id}/service_accounts/{service_account_id} | Deletes a service account from the project. |
| GET | /organization/projects/{project_id}/users | Returns a list of users in the project. |
| POST | /organization/projects/{project_id}/users | Adds a user to the project. Users must already be members of the organization to be added to a project. |
| GET | /organization/projects/{project_id}/users/{user_id} | Retrieves a user in the project. |
| POST | /organization/projects/{project_id}/users/{user_id} | Modifies a user's role in the project. |
| DELETE | /organization/projects/{project_id}/users/{user_id} | Deletes a user from the project. |
| GET | /organization/usage/audio_speeches | Get audio speeches usage details for the organization. |
| GET | /organization/usage/audio_transcriptions | Get audio transcriptions usage details for the organization. |
| GET | /organization/usage/code_interpreter_sessions | Get code interpreter sessions usage details for the organization. |
| GET | /organization/usage/completions | Get completions usage details for the organization. |
| GET | /organization/usage/embeddings | Get embeddings usage details for the organization. |
| GET | /organization/usage/images | Get images usage details for the organization. |
| GET | /organization/usage/moderations | Get moderations usage details for the organization. |
| GET | /organization/usage/vector_stores | Get vector stores usage details for the organization. |
| GET | /organization/users | Lists all of the users in the organization. |
| GET | /organization/users/{user_id} | Retrieves a user by their identifier. |
| POST | /organization/users/{user_id} | Modifies a user's role in the organization. |
| DELETE | /organization/users/{user_id} | Deletes a user from th

… (truncated)