Skip to main content
GET
/
artifacts
/
{artifact_id}
/
download
cURL
curl 'https://api.gumloop.com/api/v1/artifacts/ARTIFACT_ID/download' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
{
  "download_url": "https://storage.googleapis.com/gumloop-artifacts/art_aBcDeF123?X-Goog-Signature=...",
  "filename": "q4_sales_report.pdf",
  "media_type": "application/pdf",
  "size": 12345
}

Authorizations

​
Authorization
string
header
required

A personal API key or an OAuth 2.0 access token. Personal API keys also require the x-auth-key header with your user ID.

Path Parameters

​
artifact_id
string
required

ID of the artifact to download.

Query Parameters

​
version_id
string

Specific version of the artifact to download. Defaults to the latest version when omitted.

Response

Signed download URL and file metadata.

​
download_url
string
required

Signed URL the caller can GET to fetch the file bytes.

Example:

"https://storage.googleapis.com/gumloop-artifacts/art_aBcDeF123?X-Goog-Signature=..."

​
filename
string | null
Example:

"q4_sales_report.pdf"

​
media_type
string | null
Example:

"application/pdf"

​
size
integer | null

File size in bytes.

Example:

12345