Skip to main content

Agent files upload presign

Create a temporary upload URL for a generated file. Use this endpoint to start the file upload flow when you need a temporary upload URL and a fileId that can later be confirmed.

Endpoint

GET /external/agent-files/upload-presign

Authentication

See Authentication

Success status code

200 OK

Query parameters

NameRequiredTypeNotes
nameYesstringOriginal file name to associate with the upload record.
contentTypeYesstringMIME type for the file upload.

Response body

FieldTypeNotes
fileIdstringFile identifier used by Agent files confirm upload.
putUrlstringTemporary upload URL.

Response example

{
  "fileId": "1024",
  "putUrl": "https://storage.example.com/agent-files/1024-report.csv?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=600"
}

Error responses

  • 401 Unauthorized

Notes

  • This is step 1 of the upload flow: request putUrl, upload the file, then call Agent files confirm upload.
  • Upload URLs expire after 10 minutes.