Notra

Irreversibly approve a draft or failed brief and queue the paid Notra writer. This claims the brief and books writer work.

Destructively cancel every post destination that has not started and clear failed destinations. A destination already publishing cannot be interrupted; it finishes and is not retried, and in_progress reports this case.

Starts a durable paid AI agent session with an initial user message and returns its session ID. Read subsequent output from the session event stream. This can consume credits and produce unbounded streamed model output; do not retry blindly after an ambiguous failure.

Create a paid Notra chat, persist the first message, and wait for the full assistant stream. The response is newline-delimited stream text rather than parsed message parts and may run for an unbounded model/tool duration. Limited with chat messages to 30 requests per minute per organization; retrying creates another chat and may repeat tool side effects.

Creates a persistent GitHub event automation that generates the selected content type for matching releases or pushes and can publish the result automatically. This is a paid operation.

Create a persistent GEO project linked to a brand identity. Requires an active paid plan or positive AI credit balance and a GEO plan.

Persist a custom prompt for future GEO scans. Requires paid access and an active GEO plan.

Irreversibly queue a paid GEO scan that records checks against configured answer engines. The scan record is created before hand-off; poll the returned status URL. Requires sufficient plan or AI credits, rejects concurrent scans with 409, and is limited to 4 requests per hour per organization.

Persist a one-to-five-turn GEO prompt sequence for tracked runs. Requires paid GEO access.

Connect a GitHub repository to Notra, enabling changelog generation and creating a webhook secret. This paid operation stores a supplied personal access token for private repositories; never pass a token unless required. Limited to 20 requests per minute per API key.

Create a draft or published Notra post directly from supplied content without invoking AI generation.

Creates a recurring schedule that generates one content type from the selected GitHub integrations. Times are in UTC. A schedule with the same source, targets, output, and lookback settings as an existing one is rejected with 409. This paid operation creates a persistent recurring automation that may generate and auto-publish content on future runs; review enabled and auto_publish before calling.

Creates a custom skill. Names must be unique within the organization. This paid operation creates a persistent agent skill.

Create a paid outbound webhook subscription that causes persistent external deliveries. The signing secret is returned only once and must be stored securely.

Permanently delete a non-default brand identity and disable every schedule or event trigger that references it. The default identity cannot be deleted.

Delete an event trigger. Permanently delete an event trigger and stop future matching events from running it.

Permanently stop tracking a competitor and return the remaining competitor list.

Permanently delete a GEO project and cascade-delete its settings, prompts, sequences, competitors, scans, checks, and reports, while cancelling pending scans. Feedback is detached, not deleted. The last project or a project with hosted Sites cannot be deleted.

Permanently stop tracking a GEO prompt. This destructive change removes it from future scans and requires an active GEO plan.

Permanently delete a tracked GEO prompt sequence so it can no longer be run.

Permanently delete a Notra GitHub or Linear integration and disable every schedule or event trigger that targets it.

Permanently delete one Notra post by ID. Use only when the post is no longer needed; this operation cannot be undone.

Deletes the schedule and stops future runs. Posts generated by earlier runs are kept. Permanently delete a schedule and stop future runs; posts from previous runs remain.

Deletes a custom skill. System skills cannot be deleted. Permanently delete an agent skill.

Permanently remove a Notra webhook subscription and cancel all deliveries that have not yet been sent.

Create a brand identity immediately and queue a paid, irreversible website-analysis job that fills its company, tone, and audience fields. Poll NOTRA_GET_BRAND_IDENTITY_GENERATION; limited to 5 requests per minute per API key.

Queue a paid, irreversible AI post-generation job. The call consumes plan capacity or credits even if later generation fails. Poll NOTRA_GET_POST_GENERATION until terminal; limited to 10 requests per minute per API key.

Get one Notra brand identity by ID. A missing identity is represented by a successful response with brand_identity set to null.

Get a brand identity analysis job. Poll until status is completed or failed, then fetch job.brand_identity_id with NOTRA_GET_BRAND_IDENTITY.

Get one Notra chat and its complete message history by chat ID.

Find the Notra chat linked to a Discord or Slack channel ID.

Returns one GitHub event trigger with its event filters, monitored repositories, generated content type, and publishing settings.

Returns one feedback entry with its classification, triage status, submission context, and timestamps.

Get the latest stored agent-readiness report, any newer run state, score history, and comparison for a GEO project's website without starting a scan.

Read paid-plan competitor share-of-voice metrics without starting a scan.

Read one competitor's paid-plan mention history without starting a scan.

Read one stored paid-plan GEO content brief without approving or starting writer work.

Read paid-plan traffic installation snippets and endpoints. This does not issue or rotate credentials, but deploying the returned setup changes external traffic collection.

Read paid-plan GEO visibility by language without starting a scan.

Get one GEO project. All GEO endpoints require an active GEO plan.

Read stored paid-plan checks for a tracked prompt without starting a scan.

Read one stored paid-plan prompt result without starting a scan.

Read stored paid-plan prompt answers and grounding data without starting or billing a scan.

Get one GEO scan's status, progress and mentions by engine, including safe failure metadata. Legacy scans may have null planned totals. Requires an active GEO plan.

Read current and previous paid-plan GEO sentiment metrics without starting billed analysis.

Read cached paid-plan thematic sentiment analysis. This never starts or bills a model run.

Get the complete GEO configuration and current scan state for a project. Requires an active GEO plan.

Read the paid-plan events in one AI traffic journey without changing tracking setup.

Read a bounded set of recent paid-plan AI traffic events without changing tracking setup.

Get AI crawler, citation, referral, and conversion traffic totals, source breakdowns, and daily points for a GEO project.

Get mention rates, checks, citations, visibility, and average positions by answer engine for a GEO project and date window.

Read paid-plan daily GEO visibility metrics. This does not start a scan or bill an analysis job.

Get one Notra post by ID, including its rendered content, markdown source, metadata, and publication status. A missing post is returned as post=null.

Get a post generation job and event log. Poll until status is completed, failed, or skipped; when completed, fetch job.post_id with NOTRA_GET_POST.

Get a post's current publishing schedule and the state of every destination, or null when no schedule exists.

Check whether Notra's public API is reachable and discover its authentication metadata without a connected credential.

Returns a skill by name, including its full instructions and whether it is built into Notra.

Get one Notra webhook delivery, including its serialized payload and complete attempt history.

Return the workspace and authentication context bound to the connected Notra credential, optionally including pending workspace invitations.

Bulk create or update a project's persistent competitor list from up to 2,000 rows or CSV. Existing names are updated rather than duplicated; send the whole list in one request. Paid GEO operation limited to 10 requests per 10 minutes per organization.