Skip to main content
GET
Retrieve artifact metadata and download URL

Headers

domain
string
required

The brand domain name (for example, vessel.com or containerstore.com) used to scope the request to a specific brand's data and configuration. The authenticated principal must be authorized for the specified brand.

Example:

"vessel.com"

Path Parameters

artifact_id
string
required

Artifact identifier returned by POST /v2/optimize/artifacts.

Example:

"art_95c650ded4824dc79bb6df16427e4a10"

Query Parameters

expires_seconds
integer
default:900

Lifetime of the signed download_url in seconds. Minimum 60, maximum 3600, default 900.

Required range: 60 <= x <= 3600
Example:

900

Response

Artifact metadata and signed download URL

Artifact metadata plus a short-lived signed URL for downloading the original file contents.

artifact_id
string
required
Example:

"art_95c650ded4824dc79bb6df16427e4a10"

kind
enum<string>
required

Artifact file format. The supported value is csv.

Available options:
csv
source
enum<string>
required

Indicates how the artifact was ingested. upload denotes a direct multipart upload, presigned denotes the presigned-URL flow used for large files, uri denotes a server-side fetch from an external URI, and generated denotes a system-produced artifact.

Available options:
upload,
presigned,
uri,
generated
content_type
string
required
Example:

"text/csv"

uri
string
required
Example:

"s3://product-agent-data-prod-ue2/optimize-artifacts/svc_yourClientId/art_95c650ded4824dc79bb6df16427e4a10/catalog.csv"

brand_id
string
required
Example:

"691df5949676c8e0b1d7b6b3"

created_at
string<date-time>
required
Example:

"2026-05-15T10:30:00Z"

download_url
string
required

Short-lived presigned URL for downloading the original file contents. The URL is valid until download_url_expires_at.

Example:

"https://product-agent-data-prod-ue2.s3.amazonaws.com/optimize-artifacts/svc_yourClientId/art_95c650ded4824dc79bb6df16427e4a10/catalog.csv?X-Amz-Signature=..."

download_url_expires_at
string<date-time>
required

Expiry timestamp in UTC for download_url. After this time, call GET /v2/optimize/artifacts/{artifact_id} again to obtain a new URL.

Example:

"2026-05-15T10:45:00Z"

bytes
integer | null
Example:

45678

sha256
string | null
Example:

"9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"

original_filename
string | null
Example:

"catalog.csv"