## Delete an agent session

`beta.agents.sessions.delete(strsession_id)  -> AgentSessionDeleted`

**delete** `/agents/sessions/{session_id}`

Removes a managed agent session from the public API and returns a deletion confirmation. If backend execution has ended, deletion can cancel a still-open public turn and abandon unpublished outputs. Running execution must be cancelled first. Physical cleanup may continue asynchronously. See [managing sessions](/api/docs/guides/agents-api/sessions/manage).

### Parameters

- `session_id: str`

### Returns

- `class AgentSessionDeleted: …`

  A Managed Agents session removed from the public API. Physical cleanup may continue asynchronously.

  - `id: str`

    The ID of the deleted session.

  - `deleted: bool`

    Whether the session has been removed from the public API. Always `true`. Physical cleanup may still be in progress.

  - `object: Literal["agent.session.deleted"]`

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

    - `"agent.session.deleted"`

### Example

```python
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get("OPENAI_API_KEY"),  # This is the default and can be omitted
)
agent_session_deleted = client.beta.agents.sessions.delete(
    "session_id",
)
print(agent_session_deleted.id)
```

#### Response

```json
{
  "id": "id",
  "deleted": true,
  "object": "agent.session.deleted"
}
```