The trigger address an outside program calls.
Needs no session or API key: it is authenticated only by the automation's own secret.
POST/api/v1/automations/{id}/trigger
Keynone
A koidog trigger takes Authorization: Bearer kdt_..., or Koidog-Timestamp and Koidog-Signature: v1=<hex HMAC-SHA256 of "<timestamp>.<raw body>"> (five minutes either way). A github trigger takes GitHub's X-Hub-Signature-256, X-GitHub-Event and X-GitHub-Delivery. A delivery id already seen is refused (409 replayed). Bodies over 256 KB are refused (413), and each automation takes at most 30 calls a minute. Answers at once with the run it recorded (202); the crew is launched after. An event its filter does not take (and GitHub's ping) answers 202 with ignored and records nothing. Text from the body reaches the agents only through declared placeholders, cut to length and marked as outside text. No query parameters.
Path parameters.
idstringrequired
The automation's id.
Headers.
Authorizationstring
Bearer kdt_...: the automation's trigger secret (a koidog trigger). Or sign the body instead, with the next two.
Koidog-Timestampstring
The current Unix time in seconds, within five minutes of the server's. With Koidog-Signature.
Koidog-Signaturestring
v1=<hex HMAC-SHA256 of "<timestamp>.<raw body>"> under the trigger secret.
Koidog-Delivery-Idstring
Your id for this call. A delivery id already taken is refused with 409 replayed. Idempotency-Key is read the same way when this is absent.
X-Hub-Signature-256string
A github trigger: GitHub's signature of the raw body under the trigger secret. Required.
X-GitHub-Eventstring
A github trigger: the event name, checked against the automation's events.
X-GitHub-Deliverystring
A github trigger: GitHub's delivery id. Required; a repeat is refused with 409 replayed.
Body.
Any JSON object, or nothing. It is read raw, so a signature covers these exact bytes. At most 256 KB (413 too_large otherwise). Its values reach the agents only through the automation's inputs placeholders, cut to guards.maxInputChars and marked as outside text.
Response.
202 Accepted: a JSON object. The work continues and is reported on the timeline. The example has placeholder values.