---
title: "Update intent status"
method: PATCH
path: "/intents/{id}/status"
tags: ["Intents"]
---

# Update intent status

`PATCH /intents/{id}/status`

Updates the status of an existing intent

## Path parameters

- `id` string, required

## Request body

- object
  - `status` 'PENDING' | 'FUNDED' | 'INITIATED' | 'COMPLETED' | 'EXPIRED', required — New status to set for the intent

## Response `200`

Intent status updated successfully

## Other responses

- `401` — Unauthorized - Invalid or missing API key
- `404` — Intent not found

## Changes

- **2025-11-11** `fce39ccb3e9d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/horuslabsio/apis/chainrails-api/changes/intents/:id/status/patch.md)

---

[API](https://skmtc.dev/horuslabsio/apis/chainrails-api.md) · [All operations](https://skmtc.dev/horuslabsio/apis/chainrails-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/horuslabsio/chainrails-api/revisions/fce39ccb3e9d/schema)