NylorunDocsBeta
Runtime APIAgentsTriggers

Deliver to a webhook trigger

POST
/v1/webhooks/{endpointId}

A sender's delivery, signed with Standard Webhooks (webhook-id, webhook-timestamp within 5 minutes by default, webhook-signature): no credential (an Authorization header is ignored) and no Nylorun-Protocol. The body, any media type, at most the Runtime limit webhookBodyBytes, is read as bytes and verified before anything else. It runs the trigger once per webhook-id: a retry answers the first run. The body reaches the model as data under the trigger's prompt. Other senders (GitHub, Stripe, Slack) are relayed by an app.

Path Parameters

endpointId*string

The trigger's endpoint id, wh_…

Header Parameters

webhook-id*string

The delivery's id; a retry sends the same

webhook-timestamp*string

Seconds since the epoch

webhook-signature*string

v1,<base64>, space-separated

Request Body

The payload, of any media type

body*file*/*
Formatbinary

Response Body

The run it made: started, queued, skipped or failed

application/json
  1. response
runId*string
status*string
Value in"started""queued""skipped""failed"
reason*string|null
curl -X POST "https://example.com/v1/webhooks/string" \  -H "webhook-id: string" \  -H "webhook-timestamp: string" \  -H "webhook-signature: string"
{  "runId": "string",  "status": "started",  "reason": "string"}

Make a webhook trigger's signing secret POST

A new Standard Webhooks secret (`whsec_…`) for a webhook trigger, shown this once; the one before stops working at once. Give it to the sender with the trigger's `webhookUrl`.

List an Agent's memories GET

Its memories by path, each with its size, `content_sha256`, frontmatter `description` and version. `pathPrefix` keeps one folder's (`conventions` for `/memories/conventions/…`).