/v1/presignedPaths/issuePresignedPath
—
post

Generates a temporary presigned path for accessing private files without authentication headers. This is particularly useful for embedding files in HTML img tags, allowing direct downloads, or sharing files with external services that cannot handle authentication headers. Currently supports reading files only - upload functionality will be added in future versions.

Path Parameters
Not Applicable
Request Headers
HttpEndpointRequestHeaders_AuthRequired_JsonContentType

FieldTypeRequiredDescription
AuthorizationstringYes

Access token

Example: Bearer <token>

Content-TypestringYes

HTTP JSON request content type

Example: application/json

Request Query
Not Applicable
Request Body
IssuePresignedPathEndpointParams

{
filepath?: string
fileId?: string
action?: string | Array<string>
duration?: number
expires?: number
usageCount?: number
}
200 — Response Headers
HttpEndpointResponseHeaders_ContentType_ContentLength

FieldTypeRequiredDescription
Content-TypestringYes

HTTP JSON response content type

Example: application/json

Content-LengthstringYes

HTTP response content length in bytes

Example: 1024

200 — Response Body
IssuePresignedPathEndpointResult

{
path: string
}
4XX or 5XX — Response Headers
HttpEndpointResponseHeaders_ContentType_ContentLength

FieldTypeRequiredDescription
Content-TypestringYes

HTTP JSON response content type

Example: application/json

Content-LengthstringYes

HTTP response content length in bytes

4XX or 5XX — Response Body
EndpointErrorResult

Endpoint error result

{
errors?: Array<ExternalError>
}
ExternalError

{
message: string
}