Skip to main content
Assign API Key Permissions
Updated over a week ago

As of March 11, 2025, we’ve released the building blocks of our new Agents platform. For details, see our API docs for our Responses API, Tools including Web Search, File Search, and Computer Use, and our Agents SDK with Tracing.

You can set permissions for each of your API when you create a new secret key or by editing an existing key.

To create a new secret key, select Create new secret key in API Keys page of the Developer Platform. You can also select the Edit key button next to a secret key to edit its permissions.

Three levels of permissions are available: All, Restricted, and Read Only.

  • All Full permissions are set for the secret key. This is the default setting.

  • Restricted Enables the user to set None, Read, and Write permissions for each endpoint.

    • For example, you create an API key that specifically does not have permission to Read or Write to the /v1/assistants endpoint:

  • Read Only Read permissions are set for all endpoints.

Did this answer your question?