> ## Documentation Index > Fetch the complete documentation index at: https://docs.revoengine.com/llms.txt > Use this file to discover all available pages before exploring further. # Explore an Agent workspace > Explore an Agent workspace. The request enforces Agent roles, ownership, workspace boundaries, and lifecycle state. ## OpenAPI ````yaml /api-reference/openapi.json get /api/v1/agents/{agentId}/storage openapi: 3.0.0 info: title: RevoEngine Platform API description: Official RevoEngine Platform API documentation. version: 1.3.0 contact: name: Support email: support@revoengine.com termsOfService: https://docs.revoengine.com/tos servers: - url: https://api.revoengine.com description: Production security: [] tags: - name: Accounts description: Users, service accounts, API keys, status, and platform access. externalDocs: description: Identity and access guide url: https://docs.revoengine.com/operate/identity-and-access - name: Activity description: Snapshot-backed activity and version history. externalDocs: description: Observability guide url: https://docs.revoengine.com/operate/observability - name: Agent Memory description: Administrative access to durable Agent memory. externalDocs: description: Agent memory and workspaces guide url: https://docs.revoengine.com/ai/memory-and-workspaces - name: Agent Plugins description: Agent plugin definitions, synchronization, testing, and lifecycle. externalDocs: description: Agent plugins guide url: https://docs.revoengine.com/ai/plugins - name: Agents description: >- Agent definitions, runs, sessions, inboxes, memory, tools, workspaces, and lifecycle. externalDocs: description: Autonomous Agents guide url: https://docs.revoengine.com/ai/agents - name: Assistant description: >- Assistant threads, messages, responses, goals, reports, sharing, attachments, and control. externalDocs: description: Assistant guide url: https://docs.revoengine.com/ai/assistant - name: Automation description: >- Jobs, templates, schedules, events, webhooks, execution history, and lifecycle. externalDocs: description: Automation guide url: https://docs.revoengine.com/operate/automation - name: Chat description: Collaborative chat threads, messages, reactions, uploads, and attachments. externalDocs: description: Team Chat guide url: https://docs.revoengine.com/operate/chat - name: Component deployments description: >- Custom Node.js runtime deployment attempts, readiness, activation, and rollback. externalDocs: description: Custom Node.js guide url: https://docs.revoengine.com/build/custom-nodejs - name: Components description: Components, elements, versions, validation, activation, and lifecycle. externalDocs: description: Components guide url: https://docs.revoengine.com/build/components - name: Config description: Instance configuration, usage, logs, and cache administration. externalDocs: description: Instance settings guide url: https://docs.revoengine.com/platform/instance-settings - name: Database Cache description: Instance Database cache values and statistics. externalDocs: description: Database Cache guide url: https://docs.revoengine.com/operate/database-cache - name: Database Views description: Database Views, previews, refreshes, exports, and controlled data actions. externalDocs: description: Database Views guide url: https://docs.revoengine.com/operate/database-views - name: Databases description: Database definitions, data, audits, exports, cloning, and lifecycle. externalDocs: description: Databases guide url: https://docs.revoengine.com/operate/databases - name: Endpoints description: >- Endpoint definitions, activation, validation, generated OpenAPI, and statistics. externalDocs: description: Endpoints guide url: https://docs.revoengine.com/operate/endpoints - name: Files description: Compatibility file listing, preview, download, and deletion operations. externalDocs: description: Files compatibility guide url: https://docs.revoengine.com/operate/files - name: Groups description: Groups, membership, avatars, and lifecycle. externalDocs: description: Groups guide url: https://docs.revoengine.com/operate/groups - name: Me description: Current user profile, keys, avatar, and session information. externalDocs: description: Authentication guide url: https://docs.revoengine.com/developers/authentication - name: Preferences description: User and instance preference values. externalDocs: description: Platform UI guide url: https://docs.revoengine.com/platform/ui-tour - name: Role Groups description: Role groups, members, assigned roles, and lifecycle. externalDocs: description: Permissions guide url: https://docs.revoengine.com/operate/permissions - name: Roles description: Available platform roles and role details. externalDocs: description: Permissions guide url: https://docs.revoengine.com/operate/permissions - name: Search description: Cross-domain search over objects visible to the caller. externalDocs: description: Search and discovery guide url: https://docs.revoengine.com/platform/search - name: Secrets description: >- Secret definitions, revisions, activation, reveal, disable, and destruction. externalDocs: description: Secrets guide url: https://docs.revoengine.com/operate/secrets - name: Storage description: >- Storage workspaces, folders, objects, upload sessions, signed access, and lifecycle. externalDocs: description: Storage guide url: https://docs.revoengine.com/operate/storage externalDocs: description: Documentation url: https://docs.revoengine.com paths: /api/v1/agents/{agentId}/storage: get: tags: - Agents summary: Explore an Agent workspace description: >- Explore an Agent workspace. The request enforces Agent roles, ownership, workspace boundaries, and lifecycle state. operationId: AgentController_listStorage parameters: - name: agentId required: true in: path schema: type: string - name: parentStorageEntryId required: false in: query description: Current folder id. Omit for root. schema: type: string - name: flat required: false in: query description: >- Disable implicit parent-folder scoping and use the explorer in flat query mode. Useful together with explicit filters on parentStorageEntryId. schema: type: boolean - name: storageProviderConfigId required: false in: query description: >- Optional storage scope for root exploration. Omit to include every configured storage, pass an empty value for managed default storage, or pass a configured storage id. schema: type: string - name: term required: false in: query description: Optional name search within the current folder. schema: type: string - name: skip required: false in: query description: Result offset. schema: type: number minimum: 0 - name: take required: false in: query description: >- Result page size. Use 0 with count=true for count-only explorer requests. schema: minimum: 0 maximum: 200 type: number - name: includeArchived required: false in: query description: Include archived entries in the listing. schema: type: boolean - name: includeDeleted required: false in: query description: Include permanently deleted tombstones in the listing. schema: type: boolean - name: includeTotal required: false in: query description: >- Include total count. Disabled by default because it is expensive for explorer listings. schema: type: boolean - name: filter required: false in: query description: >- QueryWrapper filter tree as a JSON string or bracket-style query object for advanced storage explorer filtering, including JSON metadata lookups. schema: example: '{"field":"metadata","op":"contains","value":{"source":"ui"}}' type: string - name: sort required: false in: query description: >- QueryWrapper sort definition as a JSON string, indexed array query object, array, or legacy CSV. JSON object values should be ASC or DESC. CSV supports descending fields with a leading dash, for example kind,-name. schema: example: '{"kind":"DESC","name":"ASC"}' type: string - name: distinct required: false in: query description: >- Optional QueryWrapper DISTINCT ON fields as a JSON array string, indexed array query object, array, or legacy CSV for custom explorer projections. schema: example: kind type: string - name: fields required: false in: query description: >- Optional QueryWrapper fields selection as a JSON array string, indexed array query object, array, or legacy CSV for custom explorer projections and aggregates. schema: example: >- [{"field":"kind"},{"fn":"SUM","args":[{"field":"size"}],"as":"totalSize"}] type: string - name: groupBy required: false in: query description: >- Optional QueryWrapper GROUP BY fields as a JSON array string, indexed array query object, array, or legacy CSV for custom explorer aggregates. schema: example: '["kind"]' type: string - name: cast required: false in: query description: >- Optional QueryWrapper cast mapping as a JSON string or bracket-style query object for aggregate projections. schema: example: '{"totalSize":"BIGINT"}' type: string - name: count required: false in: query description: Enable total count using the query-service count path. schema: type: boolean - name: debug required: false in: query description: Enable QueryService debug output for the explorer query. schema: type: boolean responses: '200': description: '' security: - bearer: [] components: securitySchemes: bearer: scheme: bearer bearerFormat: JWT description: Bearer JWT token or API Key (sk-*). type: http ````