RunService

GetRunDownloadCredentials

Get temporary, read-only S3 credentials scoped to a run's storage location. Use these for bulk or repeated downloads via the AWS CLI or SDK instead of per-object presigned URLs.

get/v1/runs/{run_id}/credentials

Request

  • Base URL: https://cloud-api.usw2.elembio.io
  • URL: https://cloud-api.usw2.elembio.io/v1/runs/{run_id}/credentials
  • Auth: API key in header x-api-key

Path parameters

run_idstring required

The run ID

Query parameters

prefixstring

Optional path prefix within the run to scope credentials to. Run-relative, identical semantics to ListRunFilesRequest.prefix. ".." segments are rejected. When omitted, credentials are scoped to the whole run (the run root).

expirationSecondsinteger

Lifetime of the returned credentials, in seconds. Optional; defaults to 1 hour (when 0 or unset). Minimum 900s. Capped by AWS: up to 36h (129600s) for federation-token connections, or the role's MaxSessionDuration (12h typical) for role-backed connections. Values below the minimum or above the cap are rejected.

Response

Success

Example response

{
  "s3": {
    "expiration": "2023-01-15T01:30:15.01Z"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.