Update Opportunity Status

PUT

opportunity-statuses

{id}

curl -X PUT "https://api.clustr-ai.com/api/public/opportunity-statuses/5e6f7a8b-..." \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"is_terminal": true}'

{
  "success": true,
  "data": {
    "id": "5e6f7a8b-...",
    "name": "Meeting booked",
    "is_terminal": true
  }
}

{
  "success": false,
  "error": { "message": "Invalid or missing API key", "code": "UNAUTHORIZED" }
}

Deprecated — a status is a tag. Use Update Tag: a status id is that tag’s id, and is_terminal is the tag’s closes.

Only provided fields change. This updates the tag itself — to change what a path carries, see Set An Opportunity’s Tags.

Path Parameters

string

required

Status UUID.

Body

string

integer

boolean

curl -X PUT "https://api.clustr-ai.com/api/public/opportunity-statuses/5e6f7a8b-..." \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"is_terminal": true}'

{
  "success": true,
  "data": {
    "id": "5e6f7a8b-...",
    "name": "Meeting booked",
    "is_terminal": true
  }
}

{
  "success": false,
  "error": { "message": "Invalid or missing API key", "code": "UNAUTHORIZED" }
}

curl -X PUT "https://api.clustr-ai.com/api/public/opportunity-statuses/5e6f7a8b-..." \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"is_terminal": true}'

{
  "success": true,
  "data": {
    "id": "5e6f7a8b-...",
    "name": "Meeting booked",
    "is_terminal": true
  }
}

{
  "success": false,
  "error": { "message": "Invalid or missing API key", "code": "UNAUTHORIZED" }
}

API Reference

Import

Search

Jobs

Network

Opportunities

Owners

Accounts

Account States

Saved Views

Workflows

Intro Requests

Record Activity

Lists

Tags

Account Tags

Target Accounts

Client Companies

ICP

Competitor Monitoring

Connector Refresh

Notifications

Update Opportunity Status

Path Parameters

Body

​Path Parameters

​Body

Path Parameters

Body