OpenAI

OpenAI Projects API

The Projects API from OpenAI — 11 operation(s) for projects.

GitHub OpenAPI
Business capability
Identity & Access Management BC-620.20

Operations 23

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /organization/projects List the projects in my organization · List projects #
Ask an LLM
“Which projects exist in my OpenAI organization?”
“Can I include archived projects when listing everything in the org?”
Tell an agent
List every project in my organization.
List projects including archived ones, {limit} at a time.
POST /organization/projects Create a new project in the organization · Create project #
Ask an LLM
“How do I set up a new project in my organization?”
“Can I pick a data residency geography when I create a project?”
Tell an agent
Create a new project called {name}.
Create project {name} in the {geography} geography.
GET /organization/projects/{project_id} Get the details of one project · Retrieve project #
Ask an LLM
“What are the name and status of a specific project?”
“Can I check whether a particular project has been archived?”
Tell an agent
Show me project {project_id}.
Look up the status of project {project_id}.
POST /organization/projects/{project_id} Rename or reconfigure an existing project · Modify project #
Ask an LLM
“How do I rename a project that already exists?”
“Can I change the encryption key used by an existing project?”
Tell an agent
Rename project {project_id} to {name}.
Switch project {project_id} to external key {external_key_id}.
GET /organization/projects/{project_id}/api_keys List the API keys in a project · List project API keys #
Ask an LLM
“Which API keys have been issued inside one of my projects?”
“Can I audit all the keys that exist for a single project?”
Tell an agent
List the API keys in project {project_id}.
Show {limit} API keys from project {project_id}.
GET /organization/projects/{project_id}/api_keys/{api_key_id} Get details of one project API key · Retrieve project API key #
Ask an LLM
“Who owns a particular API key in my project and when was it created?”
“Can I look up one project API key by its ID?”
Tell an agent
Show API key {api_key_id} in project {project_id}.
Check who owns key {api_key_id} in project {project_id}.
DELETE /organization/projects/{project_id}/api_keys/{api_key_id} Delete an API key from a project · Delete project API key #
Ask an LLM
“How do I revoke a leaked API key in one of my projects?”
“Why can't I delete a project key that belongs to a service account?”
Tell an agent destructive · confirm first
Delete API key {api_key_id} from project {project_id}.
Revoke project {project_id}'s key {api_key_id} right away.
POST /organization/projects/{project_id}/archive Archive a project · Archive project #
Ask an LLM
“How do I retire a project I no longer use, since projects can't be deleted?”
“What happens to a project once it is archived?”
Tell an agent destructive · confirm first
Archive project {project_id}.
Retire project {project_id} so nobody can use it anymore.
GET /organization/projects/{project_id}/model_permissions Retrieve project model permissions #
POST /organization/projects/{project_id}/model_permissions Modify project model permissions #
DELETE /organization/projects/{project_id}/model_permissions Delete project model permissions #
GET /organization/projects/{project_id}/rate_limits List per-model rate limits for a project · List project rate limits #
Ask an LLM
“What are the per-model rate limits for my project?”
“Can I see the tokens-per-minute cap each model has in a project?”
Tell an agent
List the model rate limits for project {project_id}.
Show the next page of rate limits for project {project_id} after {after}.
POST /organization/projects/{project_id}/rate_limits/{rate_limit_id} Change a project's rate limit for a model · Modify project rate limit #
Ask an LLM
“How do I lower the requests per minute a project can make to one model?”
“Can I cap the daily batch input tokens for a project?”
Tell an agent
Set rate limit {rate_limit_id} in project {project_id} to {max_requests_per_1_minute} requests per minute.
Cap tokens per minute at {max_tokens_per_1_minute} for rate limit {rate_limit_id} in project {project_id}.
GET /organization/projects/{project_id}/service_accounts List service accounts in a project · List project service accounts #
Ask an LLM
“Which service accounts exist in one of my projects?”
“Can I see all the bot accounts attached to a project?”
Tell an agent
List the service accounts in project {project_id}.
Show {limit} service accounts from project {project_id}.
POST /organization/projects/{project_id}/service_accounts Create a service account in a project · Create project service account #
Ask an LLM
“How do I create a non-human account for a project that gets its own API key?”
“Does creating a service account return its API key in the clear?”
Tell an agent
Create a service account named {name} in project {project_id}.
Add a service account {name} to project {project_id} and give me its key.
GET /organization/projects/{project_id}/service_accounts/{service_account_id} Get details of one project service account · Retrieve project service account #
Ask an LLM
“What role does a specific service account have in my project?”
“Can I look up a project service account by its ID?”
Tell an agent
Show service account {service_account_id} in project {project_id}.
Check the role of service account {service_account_id} in project {project_id}.
POST /organization/projects/{project_id}/service_accounts/{service_account_id} Update project service account #
DELETE /organization/projects/{project_id}/service_accounts/{service_account_id} Delete a service account from a project · Delete project service account #
Ask an LLM
“How do I remove a service account from a project?”
“Why does deleting a service account fail on an archived project?”
Tell an agent destructive · confirm first
Delete service account {service_account_id} from project {project_id}.
Remove bot account {service_account_id} from project {project_id}.
GET /organization/projects/{project_id}/users List the users in a project · List project users #
Ask an LLM
“Who are the members of a particular project?”
“Can I page through every person who has access to a project?”
Tell an agent
List the users in project {project_id}.
Show the next page of project {project_id} members after {after}.
POST /organization/projects/{project_id}/users Add an organization member to a project · Create project user #
Ask an LLM
“How do I give a teammate access to one of my projects?”
“Does someone have to be in the organization before I add them to a project?”
Tell an agent
Add user {user_id} to project {project_id} as {role}.
Add {email} to project {project_id} with the {role} role.
GET /organization/projects/{project_id}/users/{user_id} Get one user's membership in a project · Retrieve project user #
Ask an LLM
“What role does a specific person have in my project?”
“Can I check whether a given user is a member of a project?”
Tell an agent
Show user {user_id} in project {project_id}.
Check the project role of user {user_id} in project {project_id}.
POST /organization/projects/{project_id}/users/{user_id} Change a user's role in a project · Modify project user #
Ask an LLM
“How do I promote a project member to project owner?”
“Can I downgrade someone's role within a single project?”
Tell an agent
Change user {user_id}'s role in project {project_id} to {role}.
Make user {user_id} an owner of project {project_id}.
DELETE /organization/projects/{project_id}/users/{user_id} Remove a user from a project · Delete project user #
Ask an LLM
“How do I take away someone's access to a project without removing them from the org?”
“Why can't I remove users from an archived project?”
Tell an agent destructive · confirm first
Remove user {user_id} from project {project_id}.
Revoke user {user_id}'s membership in project {project_id}.

Documentation

📖
Documentation
https://platform.openai.com/docs/assistants/overview
📖
Documentation
https://platform.openai.com/docs/api-reference/assistants
📖
Documentation
https://platform.openai.com/docs/guides/text-to-speech
📖
Documentation
https://platform.openai.com/docs/api-reference/audio
📖
Documentation
https://platform.openai.com/docs/guides/speech-to-text
📖
Documentation
https://developers.openai.com/api/docs/guides/audio/
📖
Documentation
https://developers.openai.com/api/docs/guides/voice-agents/
📖
Documentation
https://platform.openai.com/docs/api-reference/chat
📖
Documentation
https://platform.openai.com/docs/guides/embeddings
📖
Documentation
https://platform.openai.com/docs/api-reference/embeddings
📖
Documentation
https://platform.openai.com/docs/api-reference/files
📖
Documentation
https://platform.openai.com/docs/guides/fine-tuning
📖
Documentation
https://platform.openai.com/docs/api-reference/fine-tuning
📖
Documentation
https://platform.openai.com/docs/guides/images
📖
Documentation
https://platform.openai.com/docs/api-reference/images
📖
Documentation
https://platform.openai.com/docs/guides/image-generation
📖
Documentation
https://platform.openai.com/docs/guides/images-vision
📖
Documentation
https://platform.openai.com/docs/models
📖
Documentation
https://platform.openai.com/docs/api-reference/models
📖
Documentation
https://platform.openai.com/docs/assistants/how-it-works/managing-threads-and-messages
📖
Documentation
https://platform.openai.com/docs/api-reference/threads
📖
Documentation
https://platform.openai.com/docs/api-reference/completions

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/openai/refs/heads/main/openapi/openai-projects-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/openai/refs/heads/main/json-schema/openai-chat-completion-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/openai/refs/heads/main/json-schema/openai-embedding-schema.json

Other Resources

🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/openai/refs/heads/main/json-ld/openai-context.jsonld

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/openai:openai-projects-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openai-projects-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: OpenAI Projects API
  description: The OpenAI REST API. Please see https://platform.openai.com/docs/api-reference for more details.
  version: 2.3.0
  termsOfService: https://openai.com/policies/terms-of-use
  contact:
    name: OpenAI Support
    url: https://help.openai.com/
  license:
    name: MIT
    identifier: MIT
servers:
- url: https://api.openai.com/v1
security:
- ApiKeyAuth: []
tags:


# --- truncated at 32 KB (95 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/openai/refs/heads/main/openapi/openai-projects-api-openapi.yml