Skip to main content
Use this path to verify a bearer credential against the REST API by listing the projects it can access.

​
1. Choose the API root

Use the regional API root shown by your hosted project, or your self-hosted app origin with /api/v1 appended:

​
2. Create a credential

Create a project API key in Project Settings -> API keys for one-project automation, or a personal access token in Account -> Security for user or cross-project automation. Authentication explains the choice, permissions, and secret lifecycle. Store the credential in your secret manager, then expose it to this shell:

​
3. List projects

A successful request returns 200 OK with a data array of projects and pagination metadata. A project API key returns its one project; a personal access token returns the projects available through the user’s memberships. For the exact request and response contract, see the GET projects API reference. For a rejected request, use the authentication troubleshooting table.