OAuth
OAuth PKCE user-scoped key issuance for third-party apps
Authorization
bearer AuthorizationBearer <token>
In: header
Path Parameters
client_id*string
Response Body
application/json
application/json
curl -X GET "https://example.com/v1/oauth/app/string"{ "id": "app_01J9ZK2K4Q7Q3M3QX1V0F1APP1", "slug": "my-chatbot", "name": "My Chatbot", "category": "chat"}Authorization
bearer AuthorizationBearer <token>
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/v1/oauth/authorize" \ -H "Content-Type: application/json" \ -d '{ "client_id": "app_01J9ZK2K4Q7Q3M3QX1V0F1APP1", "code_challenge": "E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM", "code_challenge_method": "S256", "scopes": [ "inference" ], "max_daily_usd": 5, "redirect_uri": "https://app.example/callback" }'{ "code": "8f3c2b1a…", "redirect_uri": "https://app.example/callback", "expires_in": 300, "app": { "id": "app_01J9ZK2K4Q7Q3M3QX1V0F1APP1", "slug": "my-chatbot", "name": "My Chatbot", "category": "chat" }}Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/v1/oauth/token" \ -H "Content-Type: application/json" \ -d '{ "grant_type": "authorization_code", "code": "8f3c2b1a…", "code_verifier": "dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk", "client_id": "app_01J9ZK2K4Q7Q3M3QX1V0F1APP1" }'{ "api_key": "sk-aiml-live-Ab12Cd34EfGhIjKlMnOpQrStUvWxYz0123456789ab", "key_id": "key_01J9ZK2K4Q7Q3M3QX1V0F1KEY9", "app_id": "app_01J9ZK2K4Q7Q3M3QX1V0F1APP1", "token_type": "bearer", "scopes": [ "inference" ], "project_id": "prj_01J9ZK2K4Q7Q3M3QX1V0F1PRJ1"}