API documentation | API docs for agents | OpenAPI 3.1

GET /api/v1/carriers/{carrierId}/files/{fileId}/download-url

ark.get_carrier_file_download_url

Creates a short-lived signed download URL for a visible carrier file.

Availability: Expanded preview
Scopes: carriers:read
ARK permissions: canViewCarriers
Team visibility: Not entity-scoped
Idempotency-Key: Not required
Approval: No MCP approval on REST API-token calls
Rate limit: API credential and organization budgets

Parameters

carrierIdpathstringrequired: Visible ARK carrier ID.; format: uuid
fileIdpathstringrequired: Carrier file ID.; format: uuid
expires_in_secondsqueryinteger: default: 3600; min: 60; max: 86400

Request body

None.

Example request

Shell

curl 'https://arktms.com/api/v1/carriers/<carrierId>/files/<fileId>/download-url' \
  -H "Authorization: Bearer $ARK_API_TOKEN"

Success response

OK

objectstringrequired

okbooleanrequired

api_versionstringrequired

request_idstringrequired

dataobjectrequired

data.carrierIdstringrequired

format: uuid

data.fileobjectrequired

data.signedUrlstringrequired

data.expiresInSecondsintegerrequired

Errors

HTTP 400: Invalid request
HTTP 401: Authentication required
HTTP 403: Permission, scope, team, or entitlement denied
HTTP 404: Resource not found