curl --request POST \
--url https://api.usenotra.com/v1/projects/{projectId}/geo/claims \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"agent": "<string>",
"briefId": "<string>",
"sourceId": "<string>",
"ttlMinutes": 30
}
'import requests
url = "https://api.usenotra.com/v1/projects/{projectId}/geo/claims"
payload = {
"agent": "<string>",
"briefId": "<string>",
"sourceId": "<string>",
"ttlMinutes": 30
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({agent: '<string>', briefId: '<string>', sourceId: '<string>', ttlMinutes: 30})
};
fetch('https://api.usenotra.com/v1/projects/{projectId}/geo/claims', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.usenotra.com/v1/projects/{projectId}/geo/claims",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'agent' => '<string>',
'briefId' => '<string>',
'sourceId' => '<string>',
'ttlMinutes' => 30
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.usenotra.com/v1/projects/{projectId}/geo/claims"
payload := strings.NewReader("{\n \"agent\": \"<string>\",\n \"briefId\": \"<string>\",\n \"sourceId\": \"<string>\",\n \"ttlMinutes\": 30\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.usenotra.com/v1/projects/{projectId}/geo/claims")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"agent\": \"<string>\",\n \"briefId\": \"<string>\",\n \"sourceId\": \"<string>\",\n \"ttlMinutes\": 30\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.usenotra.com/v1/projects/{projectId}/geo/claims")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"agent\": \"<string>\",\n \"briefId\": \"<string>\",\n \"sourceId\": \"<string>\",\n \"ttlMinutes\": 30\n}"
response = http.request(request)
puts response.read_body{
"sourceKind": "manual",
"sourceId": "<string>",
"agent": "<string>",
"expiresAt": "<string>",
"organization": {
"id": "<string>",
"slug": "<string>",
"name": "<string>",
"logo": "<string>"
}
}{
"error": "<string>",
"code": "<string>",
"recovery": "<string>"
}{
"error": "<string>",
"code": "<string>",
"recovery": "<string>"
}{
"error": "<string>",
"code": "<string>",
"recovery": "<string>"
}{
"error": "<string>",
"code": "<string>",
"recovery": "<string>"
}{
"error": "<string>",
"code": "<string>",
"recovery": "<string>"
}{
"error": "<string>",
"code": "<string>",
"recovery": "<string>"
}{
"error": "<string>",
"code": "<string>",
"recovery": "<string>"
}{
"error": "<string>",
"code": "<string>",
"recovery": "<string>"
}Claim a content gap or brief before writing it
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.
curl --request POST \
--url https://api.usenotra.com/v1/projects/{projectId}/geo/claims \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"agent": "<string>",
"briefId": "<string>",
"sourceId": "<string>",
"ttlMinutes": 30
}
'import requests
url = "https://api.usenotra.com/v1/projects/{projectId}/geo/claims"
payload = {
"agent": "<string>",
"briefId": "<string>",
"sourceId": "<string>",
"ttlMinutes": 30
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({agent: '<string>', briefId: '<string>', sourceId: '<string>', ttlMinutes: 30})
};
fetch('https://api.usenotra.com/v1/projects/{projectId}/geo/claims', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.usenotra.com/v1/projects/{projectId}/geo/claims",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'agent' => '<string>',
'briefId' => '<string>',
'sourceId' => '<string>',
'ttlMinutes' => 30
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.usenotra.com/v1/projects/{projectId}/geo/claims"
payload := strings.NewReader("{\n \"agent\": \"<string>\",\n \"briefId\": \"<string>\",\n \"sourceId\": \"<string>\",\n \"ttlMinutes\": 30\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.usenotra.com/v1/projects/{projectId}/geo/claims")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"agent\": \"<string>\",\n \"briefId\": \"<string>\",\n \"sourceId\": \"<string>\",\n \"ttlMinutes\": 30\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.usenotra.com/v1/projects/{projectId}/geo/claims")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"agent\": \"<string>\",\n \"briefId\": \"<string>\",\n \"sourceId\": \"<string>\",\n \"ttlMinutes\": 30\n}"
response = http.request(request)
puts response.read_body{
"sourceKind": "manual",
"sourceId": "<string>",
"agent": "<string>",
"expiresAt": "<string>",
"organization": {
"id": "<string>",
"slug": "<string>",
"name": "<string>",
"logo": "<string>"
}
}{
"error": "<string>",
"code": "<string>",
"recovery": "<string>"
}{
"error": "<string>",
"code": "<string>",
"recovery": "<string>"
}{
"error": "<string>",
"code": "<string>",
"recovery": "<string>"
}{
"error": "<string>",
"code": "<string>",
"recovery": "<string>"
}{
"error": "<string>",
"code": "<string>",
"recovery": "<string>"
}{
"error": "<string>",
"code": "<string>",
"recovery": "<string>"
}{
"error": "<string>",
"code": "<string>",
"recovery": "<string>"
}{
"error": "<string>",
"code": "<string>",
"recovery": "<string>"
}Authorizations
Send your API key in the Authorization header as Bearer API_KEY. Account API keys work in every workspace you belong to: send X-Notra-Organization-Id with the workspace id or slug to choose one. Workspace endpoints require it when you belong to more than one workspace; GET /v1/me/workspaces works without it. Organization keys only accept their own workspace there.
Path Parameters
Body
Response
Claim taken or renewed
Was this page helpful?