List operations – GET /v1/operations

GET/v1/operations

betaapiKeyworkspace

When to use

Discover operations, including drafts that have no published output.

For agents

Filter kind=dataFlow to discover flows, or dataFlowId to list one flow’s operations.

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.operations.list();

Response

json

{
  "data": {
    "items": [
      {
        "id": "oper_revenue123",
        "name": "Revenue by customer",
        "kind": "dataTable",
        "instructions": "Sum revenue by customer.",
        "dataSourceIds": [
          "data_abc123"
        ],
        "parentDataFlowId": "oper_flow123",
        "status": "draft",
        "codeStale": false,
        "draft": {
          "revisionId": "rvsn_code123",
          "sequence": 1
        },
        "published": null
      }
    ]
  }
}