Agents

Delete an agent session artifact

Changed on

Deletes an immutable session artifact without deleting its live environment file or original Files API object. See session artifacts.

delete/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 deleted session artifact.

idstring required

The ID of the deleted session artifact.

object'agent.session.artifact.deleted' required

The object type. Always agent.session.artifact.deleted.

deletedboolean required

Whether the session artifact was deleted. Always true.

Changes