> ## Documentation Index > Fetch the complete documentation index at: https://docs.neo.projectdiscovery.io/llms.txt > Use this file to discover all available pages before exploring further. # List user files > List all files in the user's workspace with optional filtering, search, and pagination. ## OpenAPI ````yaml https://neo.api.projectdiscovery.io/api/openapi.json get /api/v1/files openapi: 3.1.0 info: contact: name: ProjectDiscovery url: https://neo.projectdiscovery.io description: Neo API Server - Security agent orchestration platform license: name: Apache 2.0 url: https://www.apache.org/licenses/LICENSE-2.0 title: Neo API version: 1.0.0 servers: - description: Production url: https://neo.api.projectdiscovery.io - description: Local development url: http://localhost:8080 security: [] tags: - description: Task execution and management name: Tasks - description: Agent listing and management name: Agents - description: Public agent directory name: Agent Directory - description: User file storage management name: Files - description: User working memory management name: Memory - description: Scheduled and recurring task management name: Schedules - description: Knowledge base and semantic search name: Knowledge - description: Encrypted user credentials and API keys name: Secrets - description: Neo API key management for programmatic access name: API Keys - description: User profile and account information name: User - description: Task and LLM usage tracking name: Usage - description: Bring Your Own Key provider management name: BYOK - description: Model discovery and capabilities name: Models - description: Third-party integrations name: Integrations - description: Skill knowledge documents for agent prompts name: Skills - description: Team management and member invitations name: Teams - description: Prompt library management and discovery name: Prompts - description: Slack bot integration for workspace installation and OAuth name: Slack - description: GitHub integration for PR reviews and repository management name: GitHub - description: Vulnerability issue tracking and management name: Issues - description: Subscription billing and plans name: Billing - description: Project management and member assignments name: Projects - description: SSH key pair generation and management for remote server access name: SSH Keys - description: Codebase structural analysis and mapping name: Codemaps - description: AI-generated codebase documentation and security analysis name: CodeWiki - description: Captured HTTP traffic query and replay name: Network Events paths: /api/v1/files: get: tags: - Files summary: List user files description: >- List all files in the user's workspace with optional filtering, search, and pagination. operationId: get-v1-files parameters: - in: query name: page_size schema: default: 50 maximum: 10000 minimum: 1 type: integer - description: Pagination cursor from previous response in: query name: cursor schema: type: string - description: Filter by directory within workspace in: query name: directory schema: type: string - description: Search files by filename in: query name: search schema: type: string - description: Comma-separated file keys to retrieve in: query name: keys schema: type: string - description: Comma-separated file extensions to filter in: query name: types schema: type: string - description: Include signed URLs in response in: query name: include_url schema: default: false type: boolean - description: Filter by associated chat ID in: query name: chat_id schema: type: string - description: Include total count in response in: query name: include_total schema: default: false type: boolean - in: query name: sort_by schema: default: last_modified enum: - last_modified - base_name - size - key type: string - in: query name: order schema: default: desc enum: - asc - desc type: string - description: Optional project ID for project-scoped sandbox files in: query name: project_id schema: format: uuid type: string - description: > Route file operations to a specific sandbox (`cloud` or a self-hosted display name / hostname). When omitted, the user's pinned default is used. in: query name: sandbox required: false schema: type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/FileListResponse' description: File list '401': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Unauthorized security: - BearerAuth: [] - ApiKeyAuth: [] components: schemas: FileListResponse: properties: error: type: string items: items: $ref: '#/components/schemas/FileInfo' type: array next_cursor: type: string total: type: integer type: object ErrorResponse: properties: code: description: > Stable machine-readable error code — branch on this rather than matching the human `error`/`message` strings. Domain codes include `user_spending_cap_reached`, `project_spending_cap_reached`, and `insufficient_neo_credits`; otherwise it mirrors the error kind (e.g. `forbidden`, `invalid_request`, `not_exists`, `already_exists`). example: user_spending_cap_reached type: string error: example: Bad request type: string error_id: description: Correlation id for a specific error instance, when present. type: string kind: description: Coarse error category (e.g. "forbidden request", "invalid request"). example: forbidden request type: string message: description: | Human-readable detail (the kind prefixed to the error). For display, not for branching. type: string required: - error type: object FileInfo: properties: base_name: description: Basename extracted from key type: string chat_id: description: Associated chat ID type: string download_url: description: Signed URL to download the file type: string etag: type: string ext: description: File extension type: string file_name: description: Custom display name type: string file_url: description: Signed URL to view/access the file type: string key: description: File key/path for operations type: string last_modified: format: date-time type: string mime: description: MIME type type: string size: type: integer required: - key - base_name type: object securitySchemes: BearerAuth: bearerFormat: JWT description: JWT authentication token scheme: bearer type: http ApiKeyAuth: description: Neo API key (neo_sk_* prefix) in: header name: X-Api-Key type: apiKey ````