GEO

Release a claim on a content gap or brief

Changed on

Gives up your claim so Notra or another agent can write the article. Releasing an expired or missing claim succeeds with released: false. Returns 409 when someone else holds it.

post/v1/projects/{projectId}/geo/claims/release

Request

  • Base URL
    https://api.usenotra.com
  • Auth
    HTTP bearer

Path parameters

projectIdstring required
Example:b1f2c3d4-0000-4000-8000-000000000000

Request body

briefIdstring

Brief to claim. A brief planned from a gap shares that gap's claim.

sourceKind'gap' | 'prompt' | 'search_console' | 'ai_search'

Kind of gap: gap for a row in promptGaps, search_console for searchGaps, ai_search for aiSearchGaps, prompt for a tracked prompt.

sourceIdstring

The gap's id from listGeoContentGaps. Send with sourceKind instead of briefId.

Response

Claim released

sourceKind'manual' | 'gap' | 'prompt' | 'search_console' | 'ai_search' required

Kind of the claimed item. manual means a brief that was not planned from a gap.

sourceIdstring required

Gap id, or the brief id when sourceKind is manual.

releasedboolean required

True when your claim was removed; false when there was none to release.

Changes