KOkobaltlabs
marketing-guidelines

Downvote Requirement

Changed on

Record this reviewer's downvote. Idempotent.

Feedback only: no number of votes switches a requirement off, and nothing about this analysis or any future one changes. The library reads the votes; a person decides what to do about them.

post/marketing/guidelines/requirements/{requirement_id}/downvote

Request

  • Base URL
    https://api.kobaltlabs.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.kobaltlabs.com/marketing/guidelines/requirements/{requirement_id}/downvote
  • Auth
    none declared

Path parameters

requirement_idstring uuid required

Response

Successful Response

requirement_idstring uuid required
downvote_countinteger required
downvoted_by_meboolean required
live_state'active' | 'disabled' | 'archived' | 'superseded' | 'proposed' required

Whether a requirement is in the working library, and if not, why not.

All of them are recorded as revisions, so every one is reversible and readable.

ARCHIVED and SUPERSEDED are deliberately distinct: ARCHIVED is a person deciding this obligation does not apply to them, SUPERSEDED is a newer decomposition of the same guideline taking over. A regeneration must never overwrite the first with the second — that would erase a human decision.

Changes

  • 425d5b8a3c17Revision changes
    • warning

      added the new proposed enum value to the response property for the response status