Rensei docs
API ReferenceWorker Protocol

Poll for a pending plugin verb invocation

The daemon polls this endpoint to pick up plugin verb invocations queued by workflow engine steps. Returns the oldest pending invocation for the daemon's org/project scope, atomically marking it as in-flight. Returns `{ invocationId: null }` when the queue is empty or the daemon lost a race. Auth: `Bearer rsk_*` via `getCliOrSessionAuth` OR runtime JWT (`authenticateDaemon`).

GET
/api/daemon/plugin-verbs/poll

Authorization

AuthorizationBearer <token>

Rensei API key presented as Authorization: Bearer rsk_live_. Required API-key scopes are recorded per operation in x-rensei-required-scopes.

In: header

Response Body

application/json

application/json

curl -X GET "https://example.com/api/daemon/plugin-verbs/poll"
{
  "invocationId": null
}
{
  "error": "Session not found"
}