FurniOpsDocs
API referenceBrand

Withdraw a claim

Withdraws a pending claim. A claim that is not pending answers 409.

POST/v1/brand/claims/{id}/withdraw

Withdraws a pending claim. A claim that is not pending answers 409.

Authorization

apiKey
AuthorizationBearer <token>

An API key (fo_live_… / fo_test_…) as a bearer token

In: header

Path Parameters

id*string

Vendor claim (an organisation's claim to speak for a brand) ID

Match^vcl_[0-9A-Za-z]{22}$

Header Parameters

FurniOps-Version?string

Dated API version; pinned per organisation on first use and overridable per request

Value in

  • "2026-10-01"
  • "2026-10-04"
FurniOps-Mode?string

The data the request acts on: test is the organisation's sandbox. An OAuth token picks it (live by default); an API key's mode is fixed, and naming the other one is refused

Value in

  • "live"
  • "test"
Idempotency-Key*string

Unique key for this operation, reused on retries (24 h)

Length1 <= length <= 257
FurniOps-Dry-Run?string

Preview the write and change nothing: true answers the would-be response, explain a Preview (application/vnd.furniops.preview+json)

Value in

  • "true"
  • "explain"

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://example.com/v1/brand/claims/string/withdraw" \  -H "Idempotency-Key: string"
{  "object": "vendor_claim",  "id": "string",  "kind": "listed",  "profile": {    "object": "vendor_profile",    "id": "string",    "name": "string",    "slug": "string",    "brands": [      "string"    ],    "website_domain": "string",    "status": "unclaimed",    "verified": true,    "verified_at": "2019-08-24T14:15:22Z",    "catalogue": "string",    "created_at": "2019-08-24T14:15:22Z"  },  "status": "pending",  "evidence": [    {      "kind": "dns",      "strength": "strong",      "domain": "string",      "org_domain": "string",      "verified_at": "2019-08-24T14:15:22Z",      "last_checked_at": "2019-08-24T14:15:22Z",      "captured_at": "2019-08-24T14:15:22Z"    }  ],  "strength": "strong",  "note": "string",  "message": "string",  "filed_by": "string",  "created_at": "2019-08-24T14:15:22Z",  "checked_at": "2019-08-24T14:15:22Z",  "decided_at": "2019-08-24T14:15:22Z"}

Edit the organisation's brand PATCH

Changes the name, website domain or brand names of the organisation's own profile while it is unverified. A verified profile answers 409: FurniOps changes it on request, since its verification rests on that name and domain.

Accept an agreement for the organisation POST

Records that the signer accepts, for the organisation, exactly the version and text they were shown (its `version` and `sha256`), with their typed name and title and their statement that they may bind it. A version or hash that is not the newest answers 409 `conflict`: show the new text and ask again. Accepting a version already accepted returns the earlier acceptance. Owners and admins only; never an AI agent's tool.