DOdograh
main
knowledge-base

Get presigned URL for document upload

Changed on

Generate a presigned PUT URL for uploading a document.

This endpoint:

  1. Generates a unique document UUID for organizing the S3 key
  2. Generates a presigned S3/MinIO URL for uploading the file
  3. Returns the upload URL and document metadata

After uploading to the returned URL, call /process-document to create the document record and trigger processing.

Access Control:

  • All authenticated users can upload documents scoped to their organization.
post/api/v1/knowledge-base/upload-url

Request

  • Base URL
    https://app.dograh.com
  • URL
    https://app.dograh.com/api/v1/knowledge-base/upload-url
  • Auth
    none declared

Headers

authorizationstring nullable
X-API-Keystring nullable

Request body

filenamestring required

Name of the file to upload

mime_typestring required

MIME type of the file

custom_metadataobject nullable

Optional custom metadata

Response

Successful Response

upload_urlstring required

Signed URL for uploading the file

document_uuidstring required

Unique identifier for the document

s3_keystring required

S3 key where file should be uploaded

Changes