---
title: "Execute a confirmed process intent (consequential)"
method: POST
path: "/api/copilot-process/intents/:intentId/execute"
tags: ["Copilot Process"]
---

# Execute a confirmed process intent (consequential)

`POST /api/copilot-process/intents/:intentId/execute`

## Request

- Base URL: `https://api.cernion.de`
- URL: `https://api.cernion.de/api/copilot-process/intents/:intentId/execute`
- Auth: none declared

Executes a process intent that is in pending_confirmation status. This is a consequential write action.
NOT available via Copilot. Copilot prepares intents; humans execute outside Copilot using this endpoint.

## Path parameters

- `intentId` string, required

## Query parameters

- `token` string

## Request body

- object
  - `executedBy` string: Actor performing the execution
  - `correlationId` string: Trace ID for audit
  - `token` string: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

## Response `200`

Intent executed successfully

- object

## Other responses

- `404`: Intent not found
- `409`: Intent not in executable status
- `410`: Intent has expired

---

[API](https://skmtc.dev/cernion/apis/cernion-energy-tools-api.md) · [All operations](https://skmtc.dev/cernion/apis/cernion-energy-tools-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cernion/apis/cernion-energy-tools-api/revisions/cdb94473b538?raw)
