Get presigned URL for document upload

POST /api/v1/knowledge-base/upload-url — request parameters and responses from the Menace Voice API schema.

2 min read

post/api/v1/knowledge-base/upload-url

Request example

curl --request POST \
  --url https://voice.menaceui.com/api/v1/knowledge-base/upload-url \
  --header 'authorization: <string>' \
  --header 'X-API-Key: <string>' \
  --header 'Content-Type: application/json' \
  --data '{
  "filename": "<string>",
  "mime_type": "<string>",
  "custom_metadata": {}
}'

Response

{
  "upload_url": "<string>",
  "document_uuid": "<string>",
  "s3_key": "<string>"
}

post/api/v1/knowledge-base/upload-url

See authentication for workspace API access. Public embed and artifact endpoints use their documented session or access tokens.

Headers

authorizationstring · null#

X-API-Keystring · null#

Body

application/json

filenamestringrequired#

Name of the file to upload

mime_typestringrequired#

MIME type of the file

custom_metadataobject · null#

Optional custom metadata

Show child attributes

Any of

Responses

application/json

Successful Response

upload_urlstringrequired#

Signed URL for uploading the file

document_uuidstringrequired#

Unique identifier for the document

s3_keystringrequired#

S3 key where file should be uploaded

Autoscale Metric Trigger document processing