> ## Documentation Index > Fetch the complete documentation index at: https://docs.versuno.ai/llms.txt > Use this file to discover all available pages before exploring further. # List all assets > Returns all non-trashed assets belonging to the authenticated user, ordered by `created_at` descending. Assets are returned newest-first. Trashed assets are always excluded. Use the [Bulk Asset Trash](/api-reference/list-trashed-assets) endpoint to query deleted items. Pass `teamId` to scope results to a team workspace. Pass `projectId` to filter assets belonging to a specific project. Without either, only your personal root assets are returned. ## OpenAPI ````yaml /openapi.yaml get /assets openapi: 3.1.0 info: title: Versuno Public API description: > The Versuno Public API lets you manage AI assets, projects, and version history programmatically. All endpoints except key management require a Bearer API key in the `Authorization` header. API keys are formatted as `uk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`. version: 1.0.0 contact: email: support@versuno.ai servers: - url: https://versuno.ai/api/public description: Production - url: http://localhost:3000/api/public description: Local development security: - bearerAuth: [] tags: - name: Authentication description: Verify API key validity and retrieve the caller's identity. - name: Teams description: Teams the authenticated user owns or is an active member of. - name: Assets description: AI assets — prompts, personas, contexts, system prompts, and skills. - name: Asset Trash description: Single-asset soft-delete, restore, and permanent delete lifecycle. - name: Bulk Asset Trash description: Bulk trash operations across multiple assets at once. - name: Projects description: Project folders for organising assets and teams. - name: Project Trash description: Project trash lifecycle — trashing deletes the entire subtree. - name: Versioning description: Full-snapshot version history with non-destructive revert support. - name: Public Brains description: >- Graph-based knowledge structures composed of containers (folders/groups) and nodes (content items). Read the graph, or run semantic RAG queries against it. - name: Memory description: >- The universal agent-memory layer. Capture coding-agent memory, recall it semantically, and resolve contradictions. Capture-only, scoped to your API key's account. - name: Key Management description: >- Create, update, and delete API keys. These endpoints do not require a Bearer token. paths: /assets: get: tags: - Assets summary: List all assets description: >- Returns all non-trashed assets belonging to the authenticated user, ordered by `created_at` descending. operationId: listAssets parameters: - name: teamId in: query description: Filter assets belonging to a specific team. schema: type: string format: uuid - name: type in: query description: Filter assets by type. schema: type: string enum: - prompt - persona - context - system_prompt - skill - name: projectId in: query description: Filter assets belonging to a specific project. schema: type: string format: uuid responses: '200': description: Array of asset objects. content: application/json: schema: type: array items: $ref: '#/components/schemas/Asset' example: - id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 assetType: prompt title: Customer support assistant description: Handles tier-1 support tickets content: You are a friendly customer support agent... content_blocks: - id: b_11111111-1111-4111-8111-111111111111 type: heading meta: level: 2 content: Support Workflow - id: b_22222222-2222-4222-8222-222222222222 type: paragraph meta: {} content: >- Greet the user, ask clarifying questions, then propose next steps. emoji: 🤖 projectId: null teamId: null userId: b2c3d4e5-f6a7-8901-bcde-f12345678901 createdAt: '2026-01-15T10:30:00.000Z' updatedAt: '2026-01-20T14:45:00.000Z' deletedAt: null - id: e5f6a7b8-c9d0-1234-ef01-345678901234 assetType: system_prompt title: Coding assistant system prompt description: null content: You are an expert software engineer... content_blocks: - id: b_66666666-6666-4666-8666-666666666666 type: paragraph meta: {} content: Answer with concise steps and include runnable code. emoji: 💻 projectId: c3d4e5f6-a7b8-9012-cdef-123456789012 teamId: null userId: b2c3d4e5-f6a7-8901-bcde-f12345678901 createdAt: '2026-01-10T08:00:00.000Z' updatedAt: '2026-01-18T12:00:00.000Z' deletedAt: null '401': description: Unauthorized. content: application/json: schema: $ref: '#/components/schemas/Error401' components: schemas: Asset: type: object description: An AI asset — a prompt, persona, context, system prompt, or skill. required: [] properties: id: type: string format: uuid description: Unique identifier for the asset. example: a1b2c3d4-e5f6-7890-abcd-ef1234567890 assetType: type: string enum: - prompt - persona - context - system_prompt - skill description: Type of AI asset. Immutable after creation. example: prompt title: type: string description: Display name of the asset. example: Customer support assistant description: anyOf: - type: string - type: 'null' description: Short summary shown in the UI. example: Handles tier-1 support tickets content: type: string description: The main content body of the asset. example: >- You are a friendly customer support agent. Help users resolve their issues quickly and professionally. content_blocks: anyOf: - type: array items: $ref: '#/components/schemas/Block' - type: 'null' description: Structured block tree resolved from ai_asset_blocks. example: - id: b_11111111-1111-4111-8111-111111111111 type: heading meta: level: 2 content: Support Workflow - id: b_22222222-2222-4222-8222-222222222222 type: paragraph meta: {} content: >- Greet the user, ask clarifying questions, then propose next steps. - id: b_33333333-3333-4333-8333-333333333333 type: todo_list meta: {} content: null children: - id: b_44444444-4444-4444-8444-444444444444 type: paragraph meta: checked: false content: Confirm account email - id: b_55555555-5555-4555-8555-555555555555 type: paragraph meta: checked: true content: Acknowledge issue details emoji: anyOf: - type: string - type: 'null' description: Single emoji icon for the asset. example: 🤖 isPublic: type: boolean description: Whether the asset is publicly visible. example: false currentVersion: type: integer description: Latest version number of this asset (1 if no versions exist yet). example: 3 projectId: anyOf: - type: string format: uuid - type: 'null' description: ID of the project this asset belongs to, or null if unassigned. example: null teamId: anyOf: - type: string format: uuid - type: 'null' description: >- ID of the team workspace this asset belongs to, or null for personal. example: null userId: type: string format: uuid description: ID of the user who owns this asset. example: b2c3d4e5-f6a7-8901-bcde-f12345678901 createdAt: type: string format: date-time description: ISO 8601 timestamp when the asset was created. example: '2026-01-15T10:30:00.000Z' updatedAt: type: string format: date-time description: ISO 8601 timestamp of the last update. example: '2026-01-20T14:45:00.000Z' deletedAt: anyOf: - type: string format: date-time - type: 'null' description: ISO 8601 timestamp when the asset was trashed, or null if active. example: null Error401: type: object properties: error: type: string example: Invalid API key Block: type: object description: A single editor block in an asset's structured content tree. required: - id - type - meta properties: id: type: string description: Stable block identifier. example: b_35effee2-0c97-463b-9a0a-8973eca1b4da type: type: string enum: - paragraph - heading - code - divider - bullet_list - ordered_list - todo_list - toggle - quote - callout - table - block_snippet - block_ref - asset_ref example: paragraph content: anyOf: - type: string - type: 'null' description: Optional block textual content. example: This block was updated inline: type: array description: Optional inline span model. items: type: object additionalProperties: true meta: type: object additionalProperties: true description: Block metadata for type-specific attributes. example: {} children: type: array items: $ref: '#/components/schemas/Block' securitySchemes: bearerAuth: type: apiKey in: header name: Authorization description: >- Versuno API key. Must be prefixed with `Bearer`. Format: `Bearer uk_live_...` x-default: Bearer uk_live_your_api_key_here ````