---
title: "POST agent_session_action_required"
method: POST
path: "agent_session_action_required"
---

# POST agent_session_action_required

`POST agent_session_action_required` (webhook)

Sent when an agent session requires an action. Retrieve the session for action details.

## Payload

- WebhookAgentSessionActionRequired — Sent when an agent session requires an action. Retrieve the session for action details.
  - `id` string, required — The unique ID of the event.
  - `object` 'event', required — The object type. Always `event`.
  - `created_at` integer, required — The Unix timestamp, in seconds, when the event was created.
  - `type` 'agent.session.action_required', required — The event type. Always `agent.session.action_required`.
  - `data` AgentSessionActionRequiredPayloadResource, required
    - `id` string, required — The ID of the session.
    - `required_action` AgentSessionRequiredActionPayloadResource, required
      - `type` 'computer_use_approval_request' | 'function_call' | 'environment_connection', required

## Acknowledgement `200`

Return a 200 status code to acknowledge receipt of the event. Non-200
status codes will be retried.

---

[API](https://skmtc.dev/openai/apis/openapi.md) · [All operations](https://skmtc.dev/openai/apis/openapi/llms.txt) · [OpenAPI document](https://skmtc.dev/openai/apis/openapi/revisions/2cf225eb2eb4?raw)