ChartnautDocs

Webhooks

GET/webhooks

Notices when a run succeeds, fails or is cancelled are not built yet. All three webhook routes answer 501 not_implemented today, whatever you send.

Scope

Heavy call

Long poll

CLI

scripts:read

No

No

None

Guidance

  • Three routes are reserved, all needing a key with scripts:read, so a key without it gets 403 forbidden_scope first:

Method

Path

Answer

GET

/webhooks

501 not_implemented

POST

/webhooks

501 not_implemented

DELETE

/webhooks/{webhook_id}

501 not_implemented

  • Until they ship, poll Get a run with wait=30 instead: each call holds until the run finishes or 30 seconds pass, so you learn of the finish within a second.

  • Do not retry a 501. It will not change until the endpoints ship.

Status codes

Status

Code

Meaning

501

not_implemented

Webhooks are not built yet