execute_v2_python_program_build

Admit an exact source version as a Plan build or an inactive ImpactTest. python.program.test accepts source identity, parameters and current metadata/policy/schema pins, without delegation or schedule fields; its sealed Impact section reports private effects and cannot be run. python.program.build creates a Plan under explicit current execution authority; both schedule fields are required and are null for a direct build. Save Validation, Test and Plan have separate purposes. After activation refresh application pins and build a fresh Plan before Run.

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.

{
  "program": {
    "languageVersion": 2,
    "function": "python.program.build",
    "arguments": {
      "programId": "{{program_id}}",
      "programVersion": 1,
      "parameters": {},
      "expectedMetadataRevision": 0,
      "expectedPolicyRevision": 0,
      "expectedSchemaEpoch": 1,
      "delegationId": "{{delegation_id}}",
      "delegationVersion": 1,
      "scheduleId": null,
      "scheduleVersion": null
    }
  },
  "idempotency_key": "docs-example-0001"
}

{
  "properties": {
    "program": {
      "additionalProperties": true,
      "title": "Program",
      "type": "object"
    },
    "idempotency_key": {
      "title": "Idempotency Key",
      "type": "string"
    }
  },
  "required": [
    "program",
    "idempotency_key"
  ],
  "title": "execute_v2_python_program_buildArguments",
  "type": "object"
}

{
  "workspace_id": "{{workspace_id}}",
  "application_id": "operating-cube",
  "program": {
    "languageVersion": 2,
    "function": "python.program.build",
    "arguments": {
      "programId": "{{program_id}}",
      "programVersion": 1,
      "parameters": {},
      "expectedMetadataRevision": 0,
      "expectedPolicyRevision": 0,
      "expectedSchemaEpoch": 1,
      "delegationId": "{{delegation_id}}",
      "delegationVersion": 1,
      "scheduleId": null,
      "scheduleVersion": null
    }
  },
  "idempotency_key": "docs-example-0001"
}

{
  "properties": {
    "workspace_id": {
      "title": "Workspace Id",
      "type": "string"
    },
    "application_id": {
      "title": "Application Id",
      "type": "string"
    },
    "program": {
      "additionalProperties": true,
      "title": "Program",
      "type": "object"
    },
    "idempotency_key": {
      "title": "Idempotency Key",
      "type": "string"
    }
  },
  "required": [
    "workspace_id",
    "application_id",
    "program",
    "idempotency_key"
  ],
  "title": "execute_v2_python_program_buildArguments",
  "type": "object"
}

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