Skip to main content
DELETE
Retract Office Vote
Credits: 0 per request.

Overview

Removes your organization’s vote for one office. DELETE accepts a wider vocabulary than casting: any ST.3 / ISO 3166-1 two-letter code (plus BX, AP, OA, aliases canonicalized) resolves here. Only an unrecognizable token returns 400. Codes that casting rejects (an office Signa already covers, or a territory with no trademark register of its own: AQ, BV, …) still resolve and still delete, so a row stored under an earlier vocabulary is never stranded; when you have no vote for the code, you get 404, not 400. A territory resolves to the office that registers its marks, so retracting PR targets the USPTO vote and RE the INPI-FR one, and because the code is canonicalized first, the 404 detail names the parent office (US, FR), not the territory you sent. Retracting is free: DELETE costs 0 credits, as does casting; only List Office Votes is billed (1 credit). Responses carry the standard RateLimit-* headers. Requires an Idempotency-Key header: retrying with the same key replays the cached response of that attempt (so a replayed retract still reads deleted: true, not 404), while a new logical attempt (retracting again after re-casting the vote) needs a fresh key. The vote itself is stored once per organization per office, so the server’s state is the same either way.

Path Parameters

string
required
Office code: ST.3 / ISO, any case or accepted alias (UK retracts the GB vote).

Response

string
Always office_vote.
string
Canonical uppercase ST.3 code of the retracted vote.
boolean
Always true.
Returns 404 not_found when your organization has no vote for the office ("Your organization has no vote for CL."), and 400 validation_error for unknown codes.

Code Examples