Update an existing post
UsePATCH /v1/posts/{postId} to update a post, and send at least one of these fields:
title, up to 120 charactersslug, up to 160 lowercase letters, numbers and hyphens, ornullto clear itmarkdown, up to 100,000 charactersstatus,draftorpublishedmetadata, the cover image, tags, excerpt, authors and other site fields of a blog post or changelog (see Set blog metadata)
PATCH /v1/posts/{postId} is 60 requests per minute per key, and sending a body with none of the five fields returns 400.
Set blog metadata
Blog posts and changelogs carry site metadata that hosted sites and GitHub publishing write into the post’s frontmatter. Every post response includes it asmetadata; for other content types metadata is null, and sending it in an update returns 400.
Inside metadata, send only the fields you want to change:
Authors are created in the dashboard. List them to find their IDs:
400. When the post has a linked GitHub pull request, a metadata update syncs it like a title or markdown update.
Create a new post
There is noPOST /v1/posts endpoint for creating a post with arbitrary fields, because Notra creates posts through generation. Queue a job with POST /v1/posts/generate and then poll it until it reports a postId.
Queue a generation job
contentType is required (changelog, blog_post, linkedin_post, twitter_post or image). lookbackWindow defaults to last_7_days (current_day, yesterday, last_7_days, last_14_days, last_30_days). Point the job at connected sources with integrations.github and integrations.linear (integration ids from GET /v1/integrations) or at public repositories with github.repositories. When you pass no selector, the job uses every connected GitHub integration.
202 Accepted with the job:
Poll the job
skipped means the job ended without creating a post. Because Notra does not send a webhook when a job finishes, you have to poll. POST /v1/posts/generate allows 10 requests per minute per key and needs an active paid plan or AI credits.
Read GEO visibility for a project
Notra scopes GEO data to a project, so list projects first and then read the mention rate per engine for the last 30 days.days (1 to 365, rolling window) or an explicit from and to (YYYY-MM-DD). When you set from and to, the API ignores days. configured: false means the project has no GEO settings yet, and you can configure it with PATCH /v1/projects/{projectId}/geo/settings.
These endpoints need projects.read and visibility.read plus a GEO plan, and without the plan the API returns 402.
Trigger a GEO scan
A scan checks every tracked prompt against every enabled engine and takes no request body.statusUrl until scan.status is completed or failed. Each organization can run 4 scans per hour, so poll instead of re-triggering. See Rate Limits.
Submit feedback from an integration
Agents post to your public feedback URL without a key, while server-side code that already holds a key withfeedback.write can use POST /v1/feedback instead: