> ## 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. # List Super Agent runs > Fetch recent Super Agent runs with optional status filtering. ## OpenAPI ````yaml /developer-api/developer-v1.openapi.yaml get /v1/super-agent/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/runs: get: tags: - Super Agent summary: List Super Agent runs description: List recent Super Agent runs. Agent Runs are omitted. operationId: listSuperAgentRuns parameters: - name: status in: query required: false description: Filter by run status. schema: $ref: '#/components/schemas/RunStatus' - name: limit in: query required: false description: Number of runs to return. Values above 100 are capped at 100. schema: type: integer minimum: 1 maximum: 100 default: 20 - name: offset in: query required: false description: Number of runs to skip. schema: type: integer minimum: 0 default: 0 responses: '200': description: Super Agent run list. content: application/json: schema: $ref: '#/components/schemas/RunList' '400': $ref: '#/components/responses/InvalidInput' '401': $ref: '#/components/responses/AuthenticationRequired' '429': $ref: '#/components/responses/RateLimited' components: schemas: RunStatus: type: string enum: - pending - running - completed - failed - cancelled RunList: type: object required: - runs - limit - offset properties: runs: type: array items: $ref: '#/components/schemas/Run' limit: type: integer offset: type: integer Run: type: object required: - run_id - status - agent_id - conversation_id - model properties: run_id: type: string format: uuid description: Developer API run ID. status: $ref: '#/components/schemas/RunStatus' agent_id: oneOf: - type: string format: uuid - type: 'null' description: >- Agent that ran. Creation runs return `null` until the agent is created, then the completed run includes the new agent ID. conversation_id: oneOf: - type: string format: uuid - type: 'null' description: Conversation ID for follow-up runs. workspace_id: oneOf: - type: string format: uuid - type: 'null' description: Personal workspace bound to this conversation, when set. model: oneOf: - type: string - type: 'null' description: >- Model id this run executed with. `null` only for runs created before model selection shipped. result: $ref: '#/components/schemas/RunResult' usage: $ref: '#/components/schemas/Usage' error: $ref: '#/components/schemas/RunError' created_at: type: string format: date-time started_at: oneOf: - type: string format: date-time - type: 'null' completed_at: oneOf: - type: string format: date-time - type: 'null' webhook_delivered_at: oneOf: - type: string format: date-time - type: 'null' 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. RunResult: type: object additionalProperties: true description: >- Final agent output. Completed runs commonly include `text`; agent-creation runs also include `agent_id`. properties: agent_id: type: string format: uuid description: New agent ID when a `POST /v1/agents` creation run completes. agent_name: type: string text: type: string description: >- Terminal result text. When the agent recorded a session summary, this is that summary JSON. Otherwise it is the full assistant transcript. Use `raw_output=true` on GET to prefer `chat_text`. chat_text: type: string description: >- Full assistant transcript when it differs from `text`. Present on newly completed runs that also stored a session summary. Historical runs may omit this field. artifacts: type: array items: $ref: '#/components/schemas/Artifact' Usage: type: object required: - credits properties: credits: type: number description: Credits attributed to this Developer API run. RunError: type: object required: - code properties: code: type: string description: Stable machine-readable failure code. Artifact: type: object additionalProperties: true properties: id: type: string title: type: string type: type: string url: oneOf: - type: string format: uri - type: 'null' description: >- Short-lived download URL issued when fetching a run. `null` when the artifact has no durable file or the key cannot be signed. url_expires_at: type: string format: date-time description: Expiry of `url`. Omitted when `url` is null. responses: InvalidInput: description: >- Invalid request shape, invalid UUID, unsupported model, or unsupported status filter. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: invalidInput: value: error: INVALID_INPUT modelNotSupported: value: error: MODEL_NOT_SUPPORTED AuthenticationRequired: description: Missing, malformed, revoked, or unknown Account API key. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: missingKey: value: error: AUTHENTICATION_REQUIRED 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 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 ````