{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/orq/json-schema/orq-list-files-response-schema.json",
  "title": "ListFilesResponse",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/orq-files-api-openapi.yml#/components/schemas/ListFilesResponse",
  "required": [
    "object",
    "data",
    "has_more"
  ],
  "type": "object",
  "properties": {
    "object": {
      "type": "string",
      "description": "Object discriminator for list responses; always `list`."
    },
    "data": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/File"
      },
      "description": "Page of files."
    },
    "has_more": {
      "type": "boolean",
      "description": "Whether more files are available in the selected pagination direction."
    }
  },
  "$defs": {
    "File": {
      "required": [
        "file_id",
        "purpose",
        "file_name",
        "bytes",
        "created_at",
        "project_id"
      ],
      "type": "object",
      "properties": {
        "file_id": {
          "type": "string",
          "description": "Unique file identifier assigned by ORQ."
        },
        "purpose": {
          "description": "Declared usage category for the file.",
          "$ref": "#/$defs/FilePurpose"
        },
        "file_name": {
          "type": "string",
          "description": "Display file name, including extension when available."
        },
        "bytes": {
          "type": "string",
          "description": "Size of the uploaded file in bytes."
        },
        "created_at": {
          "type": "string",
          "description": "Time when the file was created.",
          "format": "date-time"
        },
        "project_id": {
          "type": "string",
          "description": "Identifier of the project the file belongs to. Files are project-scoped; an API key may only access files in projects it is authorized for."
        }
      }
    },
    "FilePurpose": {
      "type": "string",
      "enum": [
        "FILE_PURPOSE_RETRIEVAL",
        "FILE_PURPOSE_KNOWLEDGE_DATASOURCE",
        "FILE_PURPOSE_BATCH",
        "FILE_PURPOSE_CODE_INTERPRETER"
      ]
    }
  }
}