Read resource history and version state – GET /v1/resources/{resourceId}/revisions

GET/v1/resources/{resourceId}/revisions

betaapiKeyworkspace

When to use

Inspect history and get a version token before restoring or publishing.

For agents

Use operation IDs for handler history. For dashboard source, use resourceId from dashboards.getSource. Check capabilities: Data Flow roots can publish but have no graph history.

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.revisions.list('oper_revenue123');

Response

json

{
  "data": {
    "resourceId": "oper_revenue123",
    "version": "opaque-version-token",
    "draft": {
      "revisionId": "rvsn_code123",
      "sequence": 1
    },
    "published": null,
    "capabilities": {
      "history": true,
      "restore": true,
      "publish": true
    },
    "items": [
      {
        "id": "rvsn_code123",
        "parentRevisionId": null,
        "dependencyRevisionIds": [],
        "actor": {
          "type": "apiKey",
          "id": "apik_agent123"
        },
        "message": "Saved operation source.",
        "createdAt": "2026-09-11T12:00:00.000Z"
      }
    ]
  }
}