Docs

Authentication

Learn how to authenticate with the Trace API.

API Tokens

API tokens are used to authenticate requests. You can generate tokens from your dashboard at buildwithtrace.com/dashboard/settings.

Using Tokens

Include your token in the Authorization header of all API requests:

curl -X GET "https://api.buildwithtrace.com/v1/user/profile" \ -H "Authorization: Bearer YOUR_API_TOKEN"

Token Security

  • Never expose tokens in client-side code or public repositories
  • Use environment variables to store tokens
  • Rotate tokens periodically
  • Revoke compromised tokens immediately from your dashboard

OAuth Flow

For applications that need to act on behalf of users, Trace supports OAuth 2.0. Contact support for OAuth application credentials.

Authorization URL

https://buildwithtrace.com/oauth/authorize

Token URL

https://api.buildwithtrace.com/v1/oauth/token

Scopes

ScopeDescription
readRead access to projects and designs
writeCreate and modify projects
aiAccess to AI assistant features