Open EPM ← Back to openepm.dev

submit_v2_program

For the illustrated numeric batch, admission returns a durable jobId. Other supported functions can return an atomic receipt. Keep the exact program, preview token and idempotency key for uncertain-outcome reconciliation. Use depends_on_job_ids only when the function supports them.

These signatures come from local MCP tool discovery. Use the signature registered by your deployment and confirm your identity and permissions before calling the tool.

Endpoint signatures and example arguments

Examples show the arguments to the tool. Replace placeholder IDs and illustrative revisions with values from your authorized disposable scope.

Bound application

Apply a previewed atomic program or admit its catalogued durable job.

Required arguments
program, preview_token, idempotency_key
Optional arguments
depends_on_job_ids
{
  "program": {
    "languageVersion": 2,
    "function": "facts.numeric.batch",
    "arguments": {
      "mutations": [
        {
          "coordinate": {
            "Account": "InputA",
            "Entity": "PointA",
            "Year": "Y2027",
            "Period": "P01",
            "View": "Input",
            "Value": "Raw",
            "Custom01": "ItemA"
          },
          "op": "set",
          "value": {
            "type": "AmountLiteral",
            "decimal": "12.50000000"
          },
          "expectedChangeId": "{{numeric_change_id}}"
        }
      ]
    }
  },
  "preview_token": "{{preview_token}}",
  "idempotency_key": "docs-example-0001"
}
Exact JSON input schema
{
  "properties": {
    "program": {
      "additionalProperties": true,
      "title": "Program",
      "type": "object"
    },
    "preview_token": {
      "title": "Preview Token",
      "type": "string"
    },
    "idempotency_key": {
      "title": "Idempotency Key",
      "type": "string"
    },
    "depends_on_job_ids": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Depends On Job Ids"
    }
  },
  "required": [
    "program",
    "preview_token",
    "idempotency_key"
  ],
  "title": "submit_v2_programArguments",
  "type": "object"
}

Application router

Apply a previewed atomic program or admit its catalogued durable job.

Required arguments
workspace_id, application_id, program, preview_token, idempotency_key
Optional arguments
depends_on_job_ids
{
  "workspace_id": "{{workspace_id}}",
  "application_id": "operating-cube",
  "program": {
    "languageVersion": 2,
    "function": "facts.numeric.batch",
    "arguments": {
      "mutations": [
        {
          "coordinate": {
            "Account": "InputA",
            "Entity": "PointA",
            "Year": "Y2027",
            "Period": "P01",
            "View": "Input",
            "Value": "Raw",
            "Custom01": "ItemA"
          },
          "op": "set",
          "value": {
            "type": "AmountLiteral",
            "decimal": "12.50000000"
          },
          "expectedChangeId": "{{numeric_change_id}}"
        }
      ]
    }
  },
  "preview_token": "{{preview_token}}",
  "idempotency_key": "docs-example-0001"
}
Exact JSON input schema
{
  "properties": {
    "workspace_id": {
      "title": "Workspace Id",
      "type": "string"
    },
    "application_id": {
      "title": "Application Id",
      "type": "string"
    },
    "program": {
      "additionalProperties": true,
      "title": "Program",
      "type": "object"
    },
    "preview_token": {
      "title": "Preview Token",
      "type": "string"
    },
    "idempotency_key": {
      "title": "Idempotency Key",
      "type": "string"
    },
    "depends_on_job_ids": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Depends On Job Ids"
    }
  },
  "required": [
    "workspace_id",
    "application_id",
    "program",
    "preview_token",
    "idempotency_key"
  ],
  "title": "submit_v2_programArguments",
  "type": "object"
}
Supported application-language functions

Handling errors

MCP_TOOL_CAPACITY_NOT_DISPATCHED means the server did not dispatch this call. MCP_TOOL_DEADLINE_OUTCOME_UNKNOWN or MCP_TOOL_PROCESS_FAILED_OUTCOME_UNKNOWN leaves the outcome unknown. For a call with effects, reconcile the original request before starting a new one. For a scoped denial, verify the caller's grant and the selected target.

Module guidelines Β· Related workflow Β· Application-language function catalog

Discussion

Discussing submit_v2_program

The discussion service requires JavaScript and a connection to Firebase.