Get Conversation Hooks

Get hooks currently configured in the workspace for this conversation.

This endpoint loads hooks from the conversation’s project directory in the workspace (i.e. {project_dir}/.openhands/hooks.json) at request time.

Note: This is intentionally a “live” view of the workspace configuration. If .openhands/hooks.json changes over time, this endpoint reflects the latest file content and may not match the hooks that were used when the conversation originally started.

Returns: JSONResponse: A JSON response containing the list of hook event types. Returns an empty list if the sandbox is not running.

GET /api/v1/app-conversations/{conversation_id}/hooks

Get Conversation Hooks

cURL

curl --request GET \
  --url https://app.all-hands.dev/api/v1/app-conversations/{conversation_id}/hooks \
  --header 'X-Access-Token: <api-key>'

422

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Authorizations

X-Access-Token · string · header · required

Path Parameters

conversation_id · string<uuid> · required

Response

200

application/json

Successful Response