> ## Documentation Index > Fetch the complete documentation index at: https://chatbase.co/docs/llms.txt > Use this file to discover all available pages before exploring further. # Create file source > Upload a file as a knowledge source for an agent. Accepts PDF, DOC, DOCX, and TXT files up to 20 MB. **Base URL:** `https://files.chatbase.co/api/v2` — this endpoint uses a different host from all other Sources endpoints. ## OpenAPI ````yaml /api-v2-merged-openapi.json post /api/v2/agents/{agentId}/sources openapi: 3.1.0 info: title: Chatbase API v2 version: 2.0.0 description: >- Chatbase API v2 - A robust, structured API for managing agents and conversations. servers: - url: https://www.chatbase.co/api/v2 description: Chatbase API v2 security: [] paths: /api/v2/agents/{agentId}/sources: post: tags: - Sources summary: Create file source description: >- Upload a file as a knowledge source for an agent. Accepts PDF, DOC, DOCX, and TXT files up to 20 MB. **Base URL:** `https://files.chatbase.co/api/v2` — this endpoint uses a different host from all other Sources endpoints. operationId: createFileSource parameters: - name: agentId in: path required: true description: The agent ID schema: type: string minLength: 1 example: 5QHA6VB-DIAbBhxwqxfdi requestBody: required: true content: multipart/form-data: schema: type: object required: - name - file properties: name: type: string minLength: 1 description: Display name for the source. example: Employee Handbook file: type: string format: binary description: 'File to upload. Formats: .pdf, .doc, .docx, .txt. Max 20 MB.' responses: '201': description: >- File source created. Status is `untrained` until the agent is retrained. content: application/json: schema: $ref: '#/components/schemas/SourceListItem' example: id: a63a69a5-e7a9-4757-b73b-2041854d435d type: file name: Employee Handbook size: 245760 createdAt: '2025-01-15T10:30:00.000Z' status: untrained metadata: null '400': description: Missing required field or unsupported file type. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: VALIDATION_INVALID_BODY message: Missing required field or unsupported file type. '401': description: No Authorization header present. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: AUTH_MISSING_API_KEY message: No Authorization header present. '403': description: Standard plan or higher required. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: SUBSCRIPTION_API_RESTRICTED_PLAN message: Standard plan or higher required. '404': description: Agent not found. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: AGENT_NOT_FOUND message: Agent not found. '422': description: File would exceed the plan storage limit. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: SOURCE_SIZE_LIMIT_EXCEEDED message: File would exceed the plan storage limit. '429': description: Rate limit exceeded. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: RATE_LIMIT_TOO_MANY_REQUESTS message: Rate limit exceeded. '500': description: Unhandled server error. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: INTERNAL_SERVER_ERROR message: Unhandled server error. security: - bearerAuth: [] servers: - url: https://files.chatbase.co description: Chatbase file upload server components: schemas: SourceListItem: type: object properties: id: type: string description: Source ID type: type: string enum: - link - file - qna - notionPage - text description: Source type name: type: - string - 'null' description: Source name or URL size: type: number description: Source size in bytes createdAt: type: string description: ISO 8601 creation timestamp status: type: string enum: - untrained - trained - toBeDeleted - updated description: Training status of the source metadata: $ref: '#/components/schemas/LinkMetadata' required: - id - type - name - size - createdAt - status - metadata ErrorResponse: type: object properties: error: type: object properties: code: type: string description: Machine-readable error code message: type: string description: Human-readable error message details: type: object additionalProperties: type: string description: Field-level validation errors required: - code - message required: - error LinkMetadata: anyOf: - type: object properties: type: type: string enum: - individual required: - type - type: object properties: type: type: string enum: - crawl - sitemap excludePaths: type: array items: type: string description: Regex patterns for excluded URL paths includeOnlyPaths: type: array items: type: string description: Regex patterns for included URL paths slowScraping: type: boolean description: Whether slow scraping mode is enabled crawlStatus: type: string enum: - fetching - fetched - failed description: Crawl progress status. children: $ref: '#/components/schemas/LinkChildren' required: - type - excludePaths - includeOnlyPaths - slowScraping - crawlStatus - children - type: 'null' description: Link-specific metadata. Present only for type="link". LinkChildren: type: object properties: included: type: number description: Non-excluded, non-failed links excluded: type: number description: Explicitly excluded links failed: type: number description: Failed or discarded links required: - included - excluded - failed description: Child link counts securitySchemes: bearerAuth: type: http scheme: bearer description: API key from your account settings ````