> ## Documentation Index > Fetch the complete documentation index at: https://docs.creao.ai/llms.txt > Use this file to discover all available pages before exploring further. # Create a Super Agent realtime run > Start a Super Agent conversation and stream public events. ## OpenAPI ````yaml /developer-api/developer-v1.openapi.yaml post /v1/super-agent/realtime/runs openapi: 3.1.0 info: title: CREAO Developer API version: 1.0.0 description: | Create, update, and run personal CREAO agents from your backend with Account API keys. The v1 API uses stable `agent_id`, `conversation_id`, and `run_id` identifiers and is served from `developer.creao.ai`. servers: - url: https://developer.creao.ai description: Production security: - bearerAuth: [] - apiKeyQuery: [] tags: - name: Agents description: >- Create, list, get, update, and edit personal agents for the authenticated account. - name: Agent Memory description: >- Read, overwrite, and clear long-term memory (playbooks) for a personal agent. - name: Agent Files description: List, download, and delete files in a personal agent's skill file space. - name: Product Profile description: Once-per-account Super Agent persona and brand context. - name: Agent Runs description: >- Create, stream, fetch, and list runs for created personal agents. Super Agent rows are excluded. - name: Super Agent description: >- Chat with CREAO Super Agent from your backend. Same SSE vocabulary as Agent Runs. Requires an allowlisted account. - name: Models description: Discover supported model ids and account-specific availability. - name: Workspaces description: Create and list personal workspaces, and add or remove personal agents. - name: Workspace Files description: Upload, list, download, and delete files in a personal workspace. - name: Secrets description: Add, update, and list account secret keys. Values are write-only. - name: Skills description: Install, list, and enable account-level Agent Brain skills. paths: /v1/super-agent/realtime/runs: post: tags: - Super Agent summary: Create a Super Agent realtime run description: | Chat with CREAO Super Agent and receive the same Server-Sent Events vocabulary as Agent Runs. Failed terminals include `usage.credits` when the run incurred cost. operationId: createSuperAgentRealtimeRun requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateSuperAgentRealtimeRunRequest' examples: realtimeResearch: summary: Realtime research value: input: query: Summarize recent Solana TVL changes. model: anthropic/claude-haiku-4-5 responses: '200': description: Server-Sent Events stream. headers: Cache-Control: schema: type: string description: Always `no-cache`. X-Accel-Buffering: schema: type: string description: Always `no`. content: text/event-stream: schema: type: string examples: stream: value: > event: run.created data: {"run_id":"11111111-1111-4111-8111-111111111111","agent_id":null,"conversation_id":"22222222-2222-4222-8222-222222222222","model":"anthropic/claude-haiku-4-5"} event: output_text.delta data: {"delta":"Hello"} event: run.completed data: {"run_id":"11111111-1111-4111-8111-111111111111","status":"completed","result":{"text":"Hello"},"usage":{"credits":1.2}} '400': $ref: '#/components/responses/RealtimeInvalidInput' '401': $ref: '#/components/responses/AuthenticationRequired' '402': $ref: '#/components/responses/InsufficientCredits' '403': $ref: '#/components/responses/AccountBlocked' '404': description: The conversation does not exist for this account. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '409': description: The conversation is already bound to a different workspace. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: workspaceMismatch: value: error: WORKSPACE_MISMATCH '429': $ref: '#/components/responses/RateLimited' '503': $ref: '#/components/responses/ServiceUnavailable' components: schemas: CreateSuperAgentRealtimeRunRequest: type: object additionalProperties: false required: - input properties: input: description: >- JSON input for Super Agent. Serialized input must be 256 KB or smaller. model: type: string maxLength: 100 description: >- Model id to run with. Omit to use the default model, currently `anthropic/claude-sonnet-5`. conversation_id: type: string format: uuid description: Existing Super Agent conversation to continue. workspace_id: type: string format: uuid description: Personal workspace whose root uploads Super Agent can read. ErrorResponse: type: object additionalProperties: true required: - error properties: error: type: string description: Stable machine-readable error code. message: type: string description: Debug message. Do not rely on this field in production clients. available: type: number description: Available credits, when returned for credit errors. required: type: number description: Required credits, when returned for credit errors. retryAfterSeconds: type: integer description: Retry delay, when returned for hourly cap errors. responses: RealtimeInvalidInput: description: >- Invalid realtime run request shape, invalid UUID, unsupported field, unsupported model, or oversized input. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: invalidInput: value: error: INVALID_INPUT modelNotSupported: value: error: MODEL_NOT_SUPPORTED inputTooLarge: value: error: INPUT_TOO_LARGE AuthenticationRequired: description: Missing, malformed, revoked, or unknown Account API key. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: missingKey: value: error: AUTHENTICATION_REQUIRED InsufficientCredits: description: Account does not have enough credits to start the run. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: insufficientCredits: value: error: INSUFFICIENT_CREDITS available: 0 required: 1000 AccountBlocked: description: >- Account is blocked from starting new runs, or the selected model is blocked by plan or entitlement access. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: accountBlocked: value: error: ACCOUNT_BLOCKED modelNotAllowed: value: error: MODEL_NOT_ALLOWED RateLimited: description: Account-level or IP-level rate limit exceeded. headers: Retry-After: description: Seconds to wait before retrying. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: rateLimited: value: error: RATE_LIMITED ServiceUnavailable: description: Agent execution service was unavailable before the run was accepted. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: unavailable: value: error: SERVICE_UNAVAILABLE securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: cr_sk description: Account API key from Developer Console. Keys start with `cr_sk_`. x-default: cr_sk_your_key_here apiKeyQuery: type: apiKey in: query name: creao-api-key description: | Account API key passed as a query parameter, for platforms that cannot set a custom Authorization header. The bearerAuth header takes precedence when both are present. x-default: cr_sk_your_key_here ````