Skip to content

Update webhook docs on SDK#32

Open
sauravpanda wants to merge 1 commit intomainfrom
lungfish
Open

Update webhook docs on SDK#32
sauravpanda wants to merge 1 commit intomainfrom
lungfish

Conversation

@sauravpanda
Copy link
Contributor

@sauravpanda sauravpanda commented Mar 16, 2026

Summary by cubic

Updated the webhook guide to document the new HMAC signature scheme with timestamp and canonical JSON, and to switch payload fields to snake_case. Clarifies agent.task.status_update statuses and adds Python/TypeScript verification examples.

  • Migration
    • Verify using X-Browser-Use-Signature and X-Browser-Use-Timestamp; compute HMAC over "{timestamp}.{sorted-keys JSON}" and reject requests older than 5 minutes.
    • Expect task_id, session_id, and optional metadata instead of taskId/sessionId.

Written for commit 3486667. Summary will update on new commits.

Copy link

@cubic-dev-ai cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

1 issue found across 1 file

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="docs/guides/webhooks.mdx">

<violation number="1" location="docs/guides/webhooks.mdx:52">
P2: Set `ensure_ascii=False` in the Python example so it signs the same canonical JSON bytes as the TypeScript example for Unicode payloads.</violation>
</file>

Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant