Files
Request an upload URL
Returns a pre-signed URL and a `file_id`. Upload your file via HTTP PUT to the returned `file_url`. Then poll `GET /files/{file_id}/status` until processing is complete, and attach the `file_id` to a message.
GET
/v1/files/signed-urlAuthorization
APIKeyHeader api-key<token>
In: header
Query Parameters
filename*Filename
File name including its extension (e.g. report.pdf).
persist?Persist
If true (default), the file is kept for reuse. If false, it is removed after 24h.
Default
trueHeader Parameters
user-id*User-Id
ID of the end user the file belongs to.
Match
^[A-Za-z0-9._\-@:]+$Length
length <= 255Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/files/signed-url?filename=string" \ -H "user-id: string"{ "expires_in": 600, "file_id": "360d942f-d861-4611-b4b3-227278c9e709", "file_limits": { "allowed_types": [ "text/csv", "text/plain", "application/pdf", "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" ], "max_size": 10485760 }, "file_url": "https://hg-ppi-s3-goatlab-dev-files..."}