Set an account's relationship status

POST/accounts/{storeId}/status

Requires scope: write:deals

Parameters

Parameter	In	Type	Description
`storeId`required	path	string
`Idempotency-Key`required	header	string	Stable logical request ID required for every machine mutation; exact retries replay and changed inputs conflict.

Request body

Field	Type	Allowed values	Description
`status`required	string	`prospectcustomerchurnednot_a_fit`

Responses

Status	Description
`200`	Updated
`401`	Missing or invalid API key
`403`	Key lacks the required scope
`404`	Account not found
`429`	Rate limit exceeded (see Retry-After)

Is this page helpful?

Request

curl -X POST "https://vergio.ai/api/v1/accounts/b7c9a2e1-0000-4000-8000-000000000000/status" \
  -H "Authorization: Bearer $VERGIO_API_KEY" \
  -H "Idempotency-Key: replace-with-a-stable-request-id" \
  -H "Content-Type: application/json" \
  -d '{
  "status": "prospect"
}'

Response (200)

{
  "store_id": "string",
  "status": "string"
}