> ## Documentation Index > Fetch the complete documentation index at: https://agno-v2.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Upload Remote Content > Upload content from a remote source (S3, GCS, SharePoint, GitHub) to the knowledge base. Content is processed asynchronously in the background. ## OpenAPI ````yaml post /knowledge/remote-content openapi: 3.1.0 info: title: Agno API Reference description: The all-in-one, private, secure agent platform that runs in your cloud. version: 3.0.4 servers: [] security: [] paths: /knowledge/remote-content: post: tags: - Knowledge summary: Upload Remote Content description: >- Upload content from a remote source (S3, GCS, SharePoint, GitHub) to the knowledge base. Content is processed asynchronously in the background. operationId: upload_remote_content parameters: - name: db_id in: query required: false schema: anyOf: - type: string - type: 'null' description: Database ID to use for content storage title: Db Id description: Database ID to use for content storage - name: knowledge_id in: query required: false schema: anyOf: - type: string - type: 'null' description: Knowledge base ID to upload to title: Knowledge Id description: Knowledge base ID to upload to requestBody: required: true content: application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/Body_upload_remote_content' responses: '202': description: Remote content upload accepted for processing content: application/json: schema: $ref: '#/components/schemas/ContentResponseSchema' example: id: content-456 name: reports/q1-2024.pdf description: Q1 Report from S3 metadata: source: s3-docs status: processing '400': description: Invalid request - unknown config or missing path content: application/json: schema: $ref: '#/components/schemas/BadRequestResponse' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/UnauthenticatedResponse' '403': description: 'Insufficient permissions. Required scope(s): knowledge:write' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/NotFoundResponse' '422': description: Validation error in request body content: application/json: schema: $ref: '#/components/schemas/ValidationErrorResponse' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/InternalServerErrorResponse' '503': description: No knowledge base is configured on this AgentOS security: - {} - HTTPBearer: [] components: schemas: Body_upload_remote_content: properties: config_id: type: string title: Config Id description: ID of the configured remote content source (from /knowledge/config) path: type: string title: Path description: Path to file or folder in the remote source source_params: anyOf: - type: string - type: 'null' title: Source Params description: >- JSON object of per-request parameters forwarded to the source's factory. Used for provider-specific routing that shouldn't be baked into the config. Currently supported keys: GitHub accepts 'repo' ('owner/repo'), letting one configured GitHub source serve multiple repositories the credentials can access. name: anyOf: - type: string - type: 'null' title: Name description: Content name (auto-generated if not provided) description: anyOf: - type: string - type: 'null' title: Description description: Content description metadata: anyOf: - type: string - type: 'null' title: Metadata description: JSON metadata object reader_id: anyOf: - type: string - type: 'null' title: Reader Id description: ID of the reader to use for processing chunker: anyOf: - type: string - type: 'null' title: Chunker description: Chunking strategy to apply chunk_size: anyOf: - type: integer - type: 'null' title: Chunk Size description: Chunk size for processing chunk_overlap: anyOf: - type: integer - type: 'null' title: Chunk Overlap description: Chunk overlap for processing type: object required: - config_id - path title: Body_upload_remote_content ContentResponseSchema: properties: id: type: string title: Id description: Unique identifier for the content name: anyOf: - type: string - type: 'null' title: Name description: Name of the content description: anyOf: - type: string - type: 'null' title: Description description: Description of the content type: anyOf: - type: string - type: 'null' title: Type description: MIME type of the content size: anyOf: - type: string - type: 'null' title: Size description: Size of the content in bytes linked_to: anyOf: - type: string - type: 'null' title: Linked To description: ID of related content if linked metadata: anyOf: - additionalProperties: true type: object - type: 'null' title: Metadata description: Additional metadata as key-value pairs access_count: anyOf: - type: integer minimum: 0 - type: 'null' title: Access Count description: Number of times content has been accessed status: anyOf: - $ref: '#/components/schemas/ContentStatus' - type: 'null' description: Processing status of the content status_message: anyOf: - type: string - type: 'null' title: Status Message description: Status message or error details created_at: anyOf: - type: string format: date-time - type: 'null' title: Created At description: Timestamp when content was created updated_at: anyOf: - type: string format: date-time - type: 'null' title: Updated At description: Timestamp when content was last updated type: object required: - id title: ContentResponseSchema BadRequestResponse: properties: detail: type: string title: Detail description: Human-readable error message error_id: anyOf: - type: string - type: 'null' title: Error Id description: >- Stable identifier for the specific error, present only when the error carries one error_type: anyOf: - type: string - type: 'null' title: Error Type description: Category of the error, present only when the error carries one type: object required: - detail title: BadRequestResponse example: detail: Bad request UnauthenticatedResponse: properties: detail: type: string title: Detail description: Human-readable error message error_id: anyOf: - type: string - type: 'null' title: Error Id description: >- Stable identifier for the specific error, present only when the error carries one error_type: anyOf: - type: string - type: 'null' title: Error Type description: Category of the error, present only when the error carries one type: object required: - detail title: UnauthenticatedResponse example: detail: Unauthenticated access NotFoundResponse: properties: detail: type: string title: Detail description: Human-readable error message error_id: anyOf: - type: string - type: 'null' title: Error Id description: >- Stable identifier for the specific error, present only when the error carries one error_type: anyOf: - type: string - type: 'null' title: Error Type description: Category of the error, present only when the error carries one type: object required: - detail title: NotFoundResponse example: detail: Not found ValidationErrorResponse: properties: detail: anyOf: - type: string - items: $ref: '#/components/schemas/ValidationErrorDetail' type: array title: Detail description: >- A single message for an explicitly raised 422, or a list of field-level errors for a request-validation failure type: object required: - detail title: ValidationErrorResponse description: >- 422 body. Two runtime shapes share this status code, and the same endpoint can return either, so ``detail`` is typed as their union: - FastAPI's request-validation handler emits a **list** of field-level errors (built-in coercion errors and custom-validator ``ValueError``s alike). - A route that raises ``HTTPException(status_code=422, detail="...")`` for a semantic check (e.g. an invalid cron expression) emits a **string** through the HTTPException handler. example: detail: - loc: - body - endpoint msg: Value error, Endpoint must be a path, not a full URL type: value_error InternalServerErrorResponse: properties: detail: type: string title: Detail description: Human-readable error message error_id: anyOf: - type: string - type: 'null' title: Error Id description: >- Stable identifier for the specific error, present only when the error carries one error_type: anyOf: - type: string - type: 'null' title: Error Type description: Category of the error, present only when the error carries one type: object required: - detail title: InternalServerErrorResponse example: detail: Internal server error ContentStatus: type: string enum: - processing - completed - failed title: ContentStatus description: Enumeration of possible content processing statuses. ValidationErrorDetail: properties: loc: items: anyOf: - type: string - type: integer type: array title: Loc description: Path to the offending field, e.g. ['body', 'endpoint'] msg: type: string title: Msg description: Human-readable error message type: type: string title: Type description: Error type identifier, e.g. 'value_error' or 'missing' type: object required: - loc - msg - type title: ValidationErrorDetail description: >- One field-level error inside a 422 body, matching FastAPI's default shape. securitySchemes: HTTPBearer: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.