--- title: Overview | Luma Agents --- ## Luma Agents API v1 Open sessions with Luma's creative agent, stream its event log, start runs, upload attachments, and manage skills, fonts and workflow apps. Session routes take a session token minted with `POST /v1/auth/token`; the token route, `/v1/credits` and `/v1/usage` take your API key. Information - OpenAPI version: `3.1.0` ## Operations POST [/v1/auth/token](/api/agents/operations/exchange-token/index.md) GET [/v1/scopes](/api/agents/operations/list-scopes/index.md) POST [/v1/scopes](/api/agents/operations/create-scope/index.md) GET [/v1/scopes/{scope\_id}](/api/agents/operations/get-scope/index.md) DELETE [/v1/scopes/{scope\_id}](/api/agents/operations/delete-scope/index.md) GET [/v1/sessions](/api/agents/operations/list-sessions/index.md) POST [/v1/sessions](/api/agents/operations/create-session/index.md) GET [/v1/sessions/{session\_id}](/api/agents/operations/session-snapshot/index.md) DELETE [/v1/sessions/{session\_id}](/api/agents/operations/end-session/index.md) POST [/v1/sessions/{session\_id}/read-token](/api/agents/operations/mint-session-read-token/index.md) GET [/v1/sessions/{session\_id}/usage](/api/agents/operations/session-usage/index.md) GET [/v1/sessions/{session\_id}/events](/api/agents/operations/session-events/index.md) POST [/v1/sessions/{session\_id}/events](/api/agents/operations/send-session-events/index.md) GET [/v1/sessions/{session\_id}/events/stream](/api/agents/operations/session-event-stream/index.md) POST [/v1/sessions/{session\_id}/events/token](/api/agents/operations/mint-session-stream-token/index.md) GET [/v1/sessions/{session\_id}/runs](/api/agents/operations/list-session-runs/index.md) POST [/v1/sessions/{session\_id}/runs](/api/agents/operations/start-run/index.md) GET [/v1/sessions/{session\_id}/runs/{run\_id}](/api/agents/operations/get-session-run/index.md) POST [/v1/sessions/{session\_id}/runs/{run\_id}/cancel](/api/agents/operations/cancel-session-run/index.md) POST [/v1/sessions/{session\_id}/runs/{run\_id}/tool-response](/api/agents/operations/session-run-tool-response/index.md) GET [/v1/sessions/{session\_id}/assets/{asset\_id}](/api/agents/operations/read-session-asset/index.md) POST [/v1/sessions/{session\_id}/deliveries](/api/agents/operations/deliver-session-artifact/index.md) GET [/v1/sessions/{session\_id}/jobs](/api/agents/operations/list-session-jobs/index.md) GET [/v1/sessions/{session\_id}/jobs/{job\_id}](/api/agents/operations/get-session-job/index.md) GET [/v1/sessions/{session\_id}/plan-artifact/patches](/api/agents/operations/session-plan-artifact-patches/index.md) POST [/v1/attachments](/api/agents/operations/upload-attachment/index.md) GET [/v1/attachments/{attachment\_id}](/api/agents/operations/get-attachment-status/index.md) GET [/v1/skills](/api/agents/operations/list-skills/index.md) POST [/v1/skills](/api/agents/operations/create-skill/index.md) GET [/v1/skills/{skill\_id}](/api/agents/operations/get-skill/index.md) DELETE [/v1/skills/{skill\_id}](/api/agents/operations/delete-skill/index.md) GET [/v1/skills/{skill\_id}/versions](/api/agents/operations/list-versions/index.md) POST [/v1/skills/{skill\_id}/versions](/api/agents/operations/publish-version/index.md) GET [/v1/skills/{skill\_id}/versions/{version}](/api/agents/operations/get-version/index.md) GET [/v1/skills/{skill\_id}/versions/{version}/files/{path}](/api/agents/operations/read-file/index.md) GET [/v1/fonts](/api/agents/operations/list-fonts/index.md) DELETE [/v1/fonts/faces/{face\_id}](/api/agents/operations/delete-font-face/index.md) GET [/v1/fonts/families/{family\_id}](/api/agents/operations/get-font-family/index.md) DELETE [/v1/fonts/families/{family\_id}](/api/agents/operations/delete-font-family/index.md) POST [/v1/fonts/uploads](/api/agents/operations/create-font-upload/index.md) POST [/v1/fonts/uploads/{face\_id}/complete](/api/agents/operations/complete-font-upload/index.md) GET [/v1/apps](/api/agents/operations/list-apps/index.md) GET [/v1/apps/{app\_slug}](/api/agents/operations/get-app/index.md) GET [/v1/apps/{app\_slug}/artifact-schema](/api/agents/operations/get-app-artifact-schema/index.md) GET [/v1/apps/{app\_slug}/releases](/api/agents/operations/list-app-releases/index.md) GET [/v1/apps/{app\_slug}/surface-template](/api/agents/operations/get-app-surface-template/index.md) GET [/v1/models](/api/agents/operations/list-models/index.md) GET [/v1/models/{model\_id}](/api/agents/operations/get-model/index.md) GET [/v1/credits](/api/agents/operations/get-credit-balance/index.md) GET [/v1/usage](/api/agents/operations/get-usage/index.md) ## Authentication ### BearerAuth **Security scheme type: **http