---
title: "Cursor Cloud agent webhook handler"
method: POST
path: "/webhooks/cursor-agent"
tags: ["Webhooks"]
---

# Cursor Cloud agent webhook handler

`POST /webhooks/cursor-agent`

## Request

- Base URL: `https://api.apphandoff.com/api`
- URL: `https://api.apphandoff.com/api/webhooks/cursor-agent`
- Auth: none required

Handles v0 statusChange events (FINISHED/ERROR). HMAC verified via X-Webhook-Signature.

## Request body

- object

## Response `200`

Success

- object
  - `ok` true, required

## Other responses

- `401`: Invalid webhook signature
- `503`: Webhook secret not configured

---

[API](https://skmtc.dev/apphandoff/apis/apphandoff-api.md) · [All operations](https://skmtc.dev/apphandoff/apis/apphandoff-api/llms.txt) · [OpenAPI document](https://skmtc.dev/apphandoff/apis/apphandoff-api/revisions/9f138fe46d56?raw)