The Identity and Access API authenticates callers and manages account and project access. Authentication identifies the caller. Permissions determine what they can do.
Credentials
A user session identifies a signed-in person. An API key identifies an API client within its owner's access and the key's scopes. A project-bound key is restricted to its project.
Some operations require a signed-in user and reject API keys. Each operation's reference defines its accepted credentials. The Execution API explains the specialized credentials used to report and complete runtime work.
Accounts and projects
Accounts have members and roles. Projects have their own ownership, membership, and invitation lifecycle.
Account access does not imply every permission on every project resource. Private conversations and external-service connections can impose additional access checks.
Resource permissions
A project reference, conversation ID, or run ID selects a resource. It does not grant access. The API checks the resource involved in each request, including reads and streams.
Project access does not open every private conversation. A parent run does not grant access to its children. For a denied request, check the credential, its scopes, and the caller's resource permissions.
Invitations and ownership
Account invitations and project invitations are separate resources. Their creation, delivery, acceptance, and seat behavior follow their own contracts.
Ownership changes can require stronger authority than ordinary membership changes. The API prevents removal of the last account owner.
A team can invite a person and issue a separate key for a backend service. The invitation establishes membership. The key authenticates calls under its owner and scopes.
External accounts and usage
The Integrations API manages OAuth access to external services. API key usage and inference limits are described in the Billing and Usage API reference.
Get started
Authenticate API requests covers credential setup. Manage project access explains invitations and service keys.