Skip to main content
GET
/
v2
/
optimize
/
artifacts
/
{artifact_id}
Retrieve artifact metadata and download URL
curl --request GET \
  --url https://commerceos.aiagents.fabric.inc/api/v2/optimize/artifacts/{artifact_id} \
  --header 'domain: <domain>'
{
  "artifact_id": "art_95c650ded4824dc79bb6df16427e4a10",
  "kind": "csv",
  "source": "upload",
  "bytes": 45678,
  "sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
  "content_type": "text/csv",
  "uri": "s3://product-agent-data-prod-ue2/optimize-artifacts/svc_yourClientId/art_95c650ded4824dc79bb6df16427e4a10/catalog.csv",
  "original_filename": "catalog.csv",
  "brand_id": "691df5949676c8e0b1d7b6b3",
  "created_at": "2026-05-15T10:30:00Z",
  "download_url": "https://product-agent-data-prod-ue2.s3.amazonaws.com/optimize-artifacts/svc_yourClientId/art_95c650ded4824dc79bb6df16427e4a10/catalog.csv?X-Amz-Signature=...",
  "download_url_expires_at": "2026-05-15T10:45:00Z"
}

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"