GEO

Claim a content gap or brief before writing it

Changed on

Call this before your own agent writes the article for a content gap or brief, so Notra's writer, Autopilot and other agents do not write it at the same time. Returns 409 while someone else holds the claim. Claiming again with the same credentials renews it. The claim lapses after ttlMinutes. Saving the brief's draft post with updatePost releases it; otherwise call releaseGeoContentClaim, or reportGeoContentAgentFailure when the agent cannot finish. A brief planned from a gap shares the gap's claim. While it is held, the dashboard shows the gap as being written by agent.

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

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.

agentstring required

Name shown in Notra while the claim is held, for example "Claude Code".

ttlMinutesinteger

Minutes until the claim lapses. Defaults to 30. Claim again with the same credentials to renew it.

Response

Claim taken or renewed

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.

agentstring required

Agent holding the claim.

expiresAtstring required

ISO timestamp when the claim lapses unless renewed.

Changes