GEO

Report that your agent could not write a claimed article

Changed on

Releases your claim and saves the reason as the error on the gap's open draft or failed brief, so the team sees why the article was not written. Returns 409 when someone else holds the claim.

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

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.

reasonstring required

Why the agent could not finish. Saved as the error on the gap's open brief, if it has one.

Response

Failure recorded and 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