Update Workflow Group

Restructure a workflow group, its producer, outputs, or execution behavior.

Output leaf types are resolved against the group’s workflow outside the write lock. If the group is repointed at a different workflow concurrently, that snapshot is invalidated and the request returns 409 — retry the update.

PATCH/api/v2/tables/{tableId}/groups

Authorization

apiKey
X-API-Key<token>

Your Sim API key, personal or workspace-scoped. Generate one from the Sim dashboard under Settings > API Keys. A workspace API key is not accepted everywhere: operations that act on behalf of a specific human — administrative reads, secret access, and irreversible or governance-affecting writes — always reject it, whatever role the key carries. Each such operation says so in its own description, and the rejection surfaces as 403 unless the operation conceals unauthorized resources, in which case it is reported as 404. Use a personal API key for those.

In: header

Path Parameters

tableId*string

Unique table identifier.

Length1 <= length

Request Body

application/json

Workspace scope, workflow group identifier, and producer changes.

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://www.sim.ai/api/v2/tables/string/groups" \  -H "Content-Type: application/json" \  -d '{    "workspaceId": "a91c4b2e-6d3f-4e8a-b5c7-0d9e2f1a8c64",    "groupId": "grp_5d8b2f0a6c1e4739a8b3d5f7e9c1a204",    "name": "Company profile enrichment"  }'
{
  "data": {
    "group": {
      "id": "string",
      "workflowId": "string",
      "enrichmentId": "string",
      "name": "string",
      "type": "manual",
      "dependencies": {
        "columns": [
          "string"
        ]
      },
      "outputs": [
        {
          "blockId": "string",
          "path": "string",
          "outputId": "string",
          "columnName": "string"
        }
      ],
      "inputMappings": [
        {
          "inputName": "string",
          "columnName": "string"
        }
      ],
      "deploymentMode": "live",
      "autoRun": true
    },
    "columns": [
      {
        "id": "string",
        "name": "string",
        "type": "string",
        "required": false,
        "unique": false,
        "workflowGroupId": "string",
        "options": [
          {
            "id": "string",
            "name": "string"
          }
        ],
        "multiple": true,
        "currencyCode": "string"
      }
    ]
  }
}
{
  "error": {
    "code": "BAD_REQUEST",
    "message": "The request is invalid."
  }
}
{
  "error": {
    "code": "BAD_REQUEST",
    "message": "The request is invalid."
  }
}
{
  "error": {
    "code": "BAD_REQUEST",
    "message": "The request is invalid."
  }
}
{
  "error": {
    "code": "BAD_REQUEST",
    "message": "The request is invalid."
  }
}
{
  "error": {
    "code": "BAD_REQUEST",
    "message": "The request is invalid."
  }
}
{
  "error": {
    "code": "BAD_REQUEST",
    "message": "The request is invalid."
  }
}
{
  "error": {
    "code": "BAD_REQUEST",
    "message": "The request is invalid."
  }
}
{
  "error": {
    "code": "BAD_REQUEST",
    "message": "The request is invalid."
  }
}
{
  "error": {
    "code": "BAD_REQUEST",
    "message": "The request is invalid."
  }
}