Get Artifact In Experiment

curl --request GET \
  --url 'https://api.example.com/ai/{experiment_id}/artifact?HAIQU_API_KEY='

{
  "name": "<string>",
  "kind": "<string>",
  "value": null,
  "mime_type": "<string>",
  "content_url": "<string>",
  "auth_hint": {},
  "x": {},
  "y": {},
  "points": [
    "<unknown>"
  ]
}

API Reference

Get Artifact In Experiment

Get one normalized artifact descriptor by name from an experiment.

Use this tool when the caller already knows artifact_name and needs its typed descriptor, such as a scalar value, timeseries, or binary metadata. The returned shape reflects MCP read-side normalization rather than a round-trip of the original write-time artifact kind.

When to Use:

Call this when the caller already knows the artifact key and needs the normalized MCP descriptor.
Call this before downloading binary data, so the workflow can inspect mime_type or content_url first.

Constraints:

This endpoint reads one entry from the experiment metrics map and does not reconstruct the original write-time artifact contract.
When the descriptor exposes content_url, raw bytes still require a separate content request.

Notes:

This endpoint does not stream raw bytes.
Use get_artifact_content_in_experiment when the artifact should be served as binary content.

Args: experiment_id: Parent experiment identifier. artifact_name: Artifact key within experiment metrics. user: Authenticated user resolved from the API key. db: Active database session.

Returns: One normalized artifact descriptor.

Raises: HTTPException: Raised with 404 if the experiment is unavailable to the caller or the artifact key is absent.

GET

/

ai

/

{experiment_id}

/

artifact

Get Artifact In Experiment

curl --request GET \
  --url 'https://api.example.com/ai/{experiment_id}/artifact?HAIQU_API_KEY='

{
  "name": "<string>",
  "kind": "<string>",
  "value": null,
  "mime_type": "<string>",
  "content_url": "<string>",
  "auth_hint": {},
  "x": {},
  "y": {},
  "points": [
    "<unknown>"
  ]
}

Authorizations

HAIQU_API_KEY

string

query

required

Path Parameters

experiment_id

string

required

Query Parameters

artifact_name

string

required

Response

Successful Response

Represent the normalized artifact shape returned by MCP read endpoints.

Attributes: name: Artifact key in experiment metrics. kind: Normalized read-side artifact category, typically value, timeseries, or a base64-derived media family such as image. value: Scalar or JSON-like artifact value. mime_type: MIME type for binary or base64-backed artifacts. content_url: Relative URL used to fetch raw bytes when needed. auth_hint: Header hint used by clients when dereferencing content_url. x: X-axis metadata for timeseries payloads. y: Y-axis metadata for timeseries payloads. points: Ordered point list for timeseries payloads.

name

string

required

kind

string

required

value

unknown

mime_type

string | null

content_url

string | null

auth_hint

Auth Hint · object

x

X · object

y

Y · object

points

any[] | null

List Artifacts In Experiment Get Artifact Content In Experiment

⌘I