# Update Ramp Intent Status
Manually update the status of a ramp intent. This is useful for cancelling intents from your frontend or marking them as completed after verifying a transaction.
## Request
### Headers
:::note Public Endpoint
This endpoint does not require authentication headers.
:::
### Path Parameters
### Body Parameters
## Status Transitions
Only certain transitions are allowed. Attempting an invalid transition returns a `400` error.
| Current Status | Allowed Transitions |
|----------------|-------------------|
| `created` | `active`, `cancelled`, `expired` |
| `active` | `completed`, `cancelled`, `expired` |
| `completed` | — (terminal) |
| `expired` | — (terminal) |
| `cancelled` | — (terminal) |
```
┌──────────┐
│ created │
└──┬───┬───┘
│ │
active cancelled / expired
│
┌──▼──────┐
│ active │
└──┬──┬───┘
│ │
completed cancelled / expired
(completed, expired, cancelled are terminal)
```
## Response
### Success (200 OK)
```json
{
"success": true,
"data": {
"intentId": "ri_1710345678000_a1b2c3d4e5f6g7h8",
"status": "cancelled"
},
"message": "Ramp intent status updated"
}
```
### Response Fields
### Error Responses
## Examples
```bash
# Cancel an intent
curl -X PATCH https://api.zenpayz.com/payment/api/v1/ramp-intents/ri_1710345678000_a1b2c3d4e5f6g7h8/status \
-H "Content-Type: application/json" \
-d '{ "status": "cancelled" }'
# Mark as completed
curl -X PATCH https://api.zenpayz.com/payment/api/v1/ramp-intents/ri_1710345678000_a1b2c3d4e5f6g7h8/status \
-H "Content-Type: application/json" \
-d '{ "status": "completed" }'
```
```javascript
const intentId = 'ri_1710345678000_a1b2c3d4e5f6g7h8';
// Cancel an intent (e.g. user clicks "Cancel" on your checkout page)
const response = await fetch(
`https://api.zenpayz.com/payment/api/v1/ramp-intents/${intentId}/status`,
{
method: 'PATCH',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ status: 'cancelled' }),
}
);
const { data } = await response.json();
console.log(`Intent ${data.intentId} is now ${data.status}`);
```
```python
import requests
intent_id = "ri_1710345678000_a1b2c3d4e5f6g7h8"
response = requests.patch(
f"https://api.zenpayz.com/payment/api/v1/ramp-intents/{intent_id}/status",
json={"status": "cancelled"},
)
data = response.json()["data"]
print(f"Intent {data['intentId']} is now {data['status']}")
```
## Next Steps
- [Get Ramp Intent](/docs/rest-api/endpoints/ramp/get-ramp-intent) — Check current intent state
- [List Ramp Intents](/docs/rest-api/endpoints/ramp/list-ramp-intents) — Browse all intents
- [Create Ramp Intent](/docs/rest-api/endpoints/ramp/create-ramp-intent) — Create a new intent