---
title: "Report that your agent could not write a claimed article"
method: POST
path: "/v1/projects/{projectId}/geo/claims/failure"
tags: ["GEO"]
---

# Report that your agent could not write a claimed article

`POST /v1/projects/{projectId}/geo/claims/failure`

## Request

- Base URL: `https://api.usenotra.com`
- URL: `https://api.usenotra.com/v1/projects/{projectId}/geo/claims/failure`
- Auth: HTTP bearer

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.

## Path parameters

- `projectId` string, required

## Request body

- ReportGeoContentAgentFailureRequest
  - `briefId` string: 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.
  - `sourceId` string: The gap's id from listGeoContentGaps. Send with sourceKind instead of briefId.
  - `reason` string, required: Why the agent could not finish. Saved as the error on the gap's open brief, if it has one.

## Response `200`

Failure recorded and claim released

- ReleaseGeoContentClaimResponse
  - `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.
  - `sourceId` string, required: Gap id, or the brief id when sourceKind is manual.
  - `released` boolean, required: True when your claim was removed; false when there was none to release.
  - `organization` object, required: Workspace the request ran in.
    - `id` string, required: Workspace ID. Account API keys can send it, or the slug, as X-Notra-Organization-Id.
    - `slug` string, required: URL-safe workspace handle, unique across Notra.
    - `name` string, required: Workspace display name.
    - `logo` string, nullable, required: Workspace logo image URL. Null when none is set.

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid API key
- `402`: GEO plan or available AI credits required
- `403`: Forbidden
- `404`: Organization, project or resource not found
- `409`: Another agent holds the claim
- `500`: Internal server error
- `503`: Authentication or billing service unavailable

## Changes

- **2026-11-21** `9c3a3acdf9f7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/usenotra/apis/notra-api/changes/v1/projects/:projectId/geo/claims/failure/post.md)

---

[API](https://skmtc.dev/usenotra/apis/notra-api.md) - [All operations](https://skmtc.dev/usenotra/apis/notra-api/llms.txt) - [OpenAPI document](https://skmtc.dev/usenotra/apis/notra-api/revisions/9c3a3acdf9f7?raw)
