TeamGriddeveloper
post/files/{id}/download-intentWrite operation

Create a file download intent

Creates a short-lived credential-authorized HTTPS download target after checking file visibility, malware state, and private storage configuration. Provider coordinates remain encapsulated by the intent.

Required scopes
files:read
Interactive request builder

Prepare this request

Build locally · nothing is sent
Region
Generated cURL

The builder does not execute requests or persist credentials. Replace the environment-variable placeholder only in your terminal or secret-aware runtime.

Path parameters

1
idrequired
string

Stable identifier of the resource in the authenticated workspace.

Responses

9
201A short-lived private download intent.application/json
Response schemaapplication/json
required
FileDownloadIntent

Public API representation of file download intent.

required
ResponseMeta

Public API representation of meta.

400The request is invalid.application/json
Response schemaapplication/json
required
array<ApiError>

The errors associated with this error.

required
ResponseMeta

Request metadata, including the request identifier and pagination state when applicable.

401The bearer credential is missing, invalid, expired, or revoked.application/json
Response schemaapplication/json
required
array<ApiError>

The errors associated with this error.

required
ResponseMeta

Request metadata, including the request identifier and pagination state when applicable.

403The credential has insufficient scope.application/json
Response schemaapplication/json
required
array<ApiError>

The errors associated with this error.

required
ResponseMeta

Request metadata, including the request identifier and pagination state when applicable.

404The tenant-scoped resource does not exist.application/json
Response schemaapplication/json
required
array<ApiError>

The errors associated with this error.

required
ResponseMeta

Request metadata, including the request identifier and pagination state when applicable.

429The credential or source exceeded its rate limit.application/json
Response schemaapplication/json
required
array<ApiError>

The errors associated with this error.

required
ResponseMeta

Request metadata, including the request identifier and pagination state when applicable.

451The file is blocked by malware policy.application/json
Response schemaapplication/json
required
array<ApiError>

The errors associated with this error.

required
ResponseMeta

Request metadata, including the request identifier and pagination state when applicable.

502The cell-local application returned an invalid response.application/json
Response schemaapplication/json
required
array<ApiError>

The errors associated with this error.

required
ResponseMeta

Request metadata, including the request identifier and pagination state when applicable.

503A required cell-local dependency is unavailable.application/json
Response schemaapplication/json
required
array<ApiError>

The errors associated with this error.

required
ResponseMeta

Request metadata, including the request identifier and pagination state when applicable.

Documentation feedbackWas this page useful?
Esc

Search TeamGrid Developer

Find guides, concepts and every API operation.