Agents

Retrieve an agent session artifact

Changed on

Retrieves immutable metadata for one durable session artifact. See session artifacts.

get/agents/sessions/{session_id}/artifacts/{artifact_id}

Request

  • Base URL
    https://api.openai.com/v1
  • URL
    https://api.openai.com/v1/agents/sessions/{session_id}/artifacts/{artifact_id}
  • Auth
    HTTP bearer

Path parameters

session_idstring required

The ID of the session that owns the artifact.

artifact_idstring required

The immutable session artifact ID.

Response

The requested session artifact.

idstring required

The immutable artifact ID.

object'agent.session.artifact' required

The object type. Always agent.session.artifact.

session_idstring required

The ID of the session that owns the artifact.

environment_idstring required

The ID of the environment that produced the artifact.

turn_idstring required

The ID of the completed turn that published the artifact.

pathstring required

The original absolute file path in the execution environment.

size_bytesinteger required

The immutable artifact size in bytes.

created_atinteger required

The Unix timestamp, in seconds, when the artifact was published.

Changes