PermuteDocs
Go to Permute

Actions · actionTriggerRunsList

List trigger runs

Returns the latest 50 invocations which this trigger started, newest first. Status unknown means an external effect may have happened; the run is never resent automatically.

GET/v1/actions/{actionId}/triggers/{triggerId}/runs
betaapiKeyworkspace

When to use

See whether recent scheduled runs succeeded.

For agents

Runs are the action invocation records which the trigger started, newest first (up to 50). They show status, revision, and failure, not output. A disable is not a run. Status unknown means an external effect may have happened; it is never resent automatically.

Example

typescript
import { PermuteClient } from '@permute/sdk';

const orgClient = new PermuteClient({
  apiKey: process.env.PERMUTE_API_KEY!,
});

const client = orgClient.withWorkspace(process.env.PERMUTE_WORKSPACE_ID!);

const result = await client.actionTriggers.runs('actn_abcdefghijklmnopqrstuvwx', 'trig_abcdefghijklmnopqrstuvwx');

Response

json
{
  "data": {
    "items": [
      {
        "requestId": "trig_abcdefghijklmnopqrstuvwx_1791018000000",
        "status": "succeeded",
        "revisionId": "rvsn_action123",
        "failure": null,
        "createdAt": "2026-10-03T09:02:00.000Z",
        "updatedAt": "2026-10-03T09:02:01.000Z"
      }
    ]
  }
}