Get a business action – GET /v1/actions/{actionId}

GET/v1/actions/{actionId}

betaapiKeyworkspace

When to use

Read the identity and metadata of an existing business action.

For agents

Use client.actions.list to inspect published contracts, or client.actions.definition with admin permission to edit code and source bindings.

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.actions.get('actn_abcdefghijklmnopqrstuvwx');

Response

json

{
  "data": {
    "id": "actn_abcdefghijklmnopqrstuvwx",
    "workspaceId": "wksp_finance123",
    "name": "Create contact",
    "createdAt": "2026-10-02T12:00:00.000Z",
    "updatedAt": "2026-10-02T12:00:00.000Z"
  }
}