Turn completed event

Zuse sends this POST to every registered endpoint when an agent finishes a turn. Verify the zuse-signature header before trusting the body, and use zuse-event-id to ignore duplicates. See Verify webhooks.

Header Parameters

zuse-signature*string

t=<unix seconds>,v1=<hex>, where v1 is the HMAC-SHA256 of <t>.<raw body> keyed with your full whsec_ secret.

zuse-event-id*string

Same as eventId in the body.

zuse-delivery-attempt*integer

Attempt number, starting at 1.

Range1 <= value

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Sent when an agent finishes a turn in any workspace on your account.

eventId*string

Event ID. It's the same for every retry, so use it to ignore duplicates.

type*"workspace.turn.completed"

Event type.

Value in

"workspace.turn.completed"

createdAt*number

When the turn finished, in Unix epoch milliseconds.

workspaceId*string

Workspace ID.

branch*string

Branch the agent works on.

turnId*string

Turn ID.

outcome*string

How the turn ended.

Value in

"completed"
"interrupted"
"error"

reply*

The agent's reply, capped at 16,384 characters.

messageId*string

ID of the agent's message in the workspace conversation.

Response Body

Example Requests

Sent when an agent finishes a turn in any workspace on your account.

POST/workspace.turn.completed

Header Parameters

Request Body

Response Body

200

Request Bodyapplication/json

Header Parameters