Archive a deal

DELETE/deals/{id}

Requires scope: write:deals

Parameters

Parameter	In	Type	Description
`id`required	path	string

Responses

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

Is this page helpful?

Request

curl "https://vergio.ai/api/v1/deals/:id" \
  -H "Authorization: Bearer $VERGIO_API_KEY"

Response (200)

{
  "deal": {
    "id": "b7c9a2e1-0000-4000-8000-000000000000",
    "storeId": "b7c9a2e1-0000-4000-8000-000000000000",
    "accountName": "string",
    "domain": "string",
    "name": "string",
    "value": 0,
    "currency": "string",
    "stage": "contacted",
    "ownerUserId": "b7c9a2e1-0000-4000-8000-000000000000",
    "nextStep": "string",
    "nextStepDue": "string",
    "source": "string",
    "version": 0,
    "createdAt": "2026-07-06T12:00:00Z",
    "updatedAt": "2026-07-06T12:00:00Z"
  },
  "archived": true
}