> ## 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 agents > List personal CREAO agents for the authenticated account. ## OpenAPI ````yaml /developer-api/developer-v1.openapi.yaml get /v1/agents 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: Runs description: Create, stream, fetch, and list Developer API runs. - 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/agents: get: tags: - Agents summary: List agents description: | List personal, active, non-deleted agents owned by the Account key owner. Team, shared, and deleted agents are omitted. Responses include metadata only — use `GET /v1/agents/{agent_id}` for skill and config content. Workflow-kind apps may appear; they are not runnable via `POST /v1/runs` (`WORKFLOW_APP_NOT_SUPPORTED`). operationId: listAgents parameters: - name: limit in: query required: false description: Page size. Defaults to 20. Maximum 100. schema: type: integer minimum: 1 maximum: 100 default: 20 - name: offset in: query required: false description: Number of agents to skip. Defaults to 0. schema: type: integer minimum: 0 default: 0 responses: '200': description: Personal agent list. content: application/json: schema: $ref: '#/components/schemas/AgentList' examples: list: value: agents: - agent_id: 00000000-0000-4000-8000-000000000000 name: Equity Research Agent description: Builds a stock analysis memo from public filings. version: '0.1' status: active write_autonomy: full_auto created_at: '2026-07-02T00:00:00.000Z' updated_at: '2026-07-03T00:00:00.000Z' limit: 20 offset: 0 '401': $ref: '#/components/responses/AuthenticationRequired' '429': $ref: '#/components/responses/RateLimited' components: schemas: AgentList: type: object required: - agents - limit - offset properties: agents: type: array items: $ref: '#/components/schemas/Agent' limit: type: integer offset: type: integer Agent: type: object required: - agent_id - name - description - version - status - write_autonomy - created_at - updated_at properties: agent_id: type: string format: uuid description: Personal CREAO agent ID. name: type: string description: oneOf: - type: string - type: 'null' version: type: string status: type: string description: Current agent status. Created agents return `active`. write_autonomy: $ref: '#/components/schemas/WriteAutonomy' created_at: type: string format: date-time updated_at: type: string format: date-time skill_content: oneOf: - type: string - type: 'null' description: >- Full SKILL.md. Present on GET-by-id and PATCH. Omitted from list responses. config_content: oneOf: - type: string - type: 'null' description: >- Raw config YAML. Present on GET-by-id and PATCH. Omitted from list responses. config: oneOf: - type: object additionalProperties: true - type: 'null' description: >- Parsed config object. Present on GET-by-id and PATCH. Omitted from list responses. dashboard_template: oneOf: - $ref: '#/components/schemas/DashboardTemplate' - type: 'null' description: >- Dashboard template. Present on GET-by-id and PATCH. Omitted from list responses. 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. WriteAutonomy: type: string enum: - full_auto - approval_required - blocked description: External write autonomy for guarded connector actions. DashboardTemplate: type: object additionalProperties: true description: >- JSON-render dashboard template. Serialized JSON must be 512 KB or smaller. responses: 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 ````