---
title: "Execute Intent"
method: POST
path: "/v1/intent/execute"
---

# Execute Intent

`POST /v1/intent/execute`

## Request

- Base URL: `https://api.corent.tech` (the document declares no server; this is the origin it was published from)
- URL: `https://api.corent.tech/v1/intent/execute`
- Auth: HTTP bearer

## Request body

- IntentExecuteRequest
  - `intent` string, required
  - `confirm_estimated_cost_cents_up_to` integer, required
  - `webhook_url` string, nullable
  - `webhook_secret` string, nullable

## Response `200`

Successful Response

- IntentExecuteResponse
  - `plan` PlanPayload, required
    - `can_fulfill` boolean, required
    - `reasoning` string, required
    - `refusal_reason` string, nullable
    - `task_type` string, nullable
    - `public_tier` string, nullable
    - `prompt` string, nullable
    - `aspect_ratio` string, nullable
    - `quality` string, nullable
    - `speed` string, nullable
    - `duration_seconds` integer, nullable
    - `next_step` string, nullable
  - `estimated_cost_cents` integer, nullable, required
  - `executed` boolean, required
  - `actual_cost_cents` integer, nullable
  - `result` object, nullable
  - `message` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/corent/apis/corent-api.md) · [All operations](https://skmtc.dev/corent/apis/corent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/corent/apis/corent-api/revisions/57168ff53efe?raw)