aimldocs

OAuth

OAuth PKCE user-scoped key issuance for third-party apps

GET
/v1/oauth/app/{client_id}
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"}
POST
/v1/oauth/authorize
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"  }}
POST
/v1/oauth/token

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"}