---
title: "Release a claim on a content gap or brief"
method: POST
path: "/v1/projects/{projectId}/geo/claims/release"
tags: ["GEO"]
---

# Release a claim on a content gap or brief

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

## Request

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

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.

## Path parameters

- `projectId` string, required

## Request body

- ReleaseGeoContentClaimRequest
  - `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.

## Response `200`

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/release/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)
