Skip to main content
We provide three ways to interact with Notra:

REST API

Use raw fetch or cURL to call endpoints directly. Full control, no dependencies.

TypeScript SDK

Use the official @usenotra/sdk package for a type-safe, ergonomic integration.

MCP Server

Connect AI tools to the hosted MCP endpoint with a bearer API key.

​
Quick Start

Base URL: 
https://api.usenotra.com/v1/:resource
:resource is the endpoint path (e.g., posts, posts/{postId}). The organization is inferred from your API key—no need to pass it in the URL. 
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.usenotra.com/v1/posts"
Replace YOUR_API_KEY with your API key. Keys are scoped to an organization (set via externalId when created).
Create and manage API keys in Authentication. API Keys in the Notra dashboard
Keep API keys private. Even read-only keys can be abused and burn through your rate limits if exposed in client-side code. Use server-side requests whenever possible.

​
SDK Installation

Install the Notra SDK: 
npm install @usenotra/sdk
Initialize the client with your API key: 
import { Notra } from "@usenotra/sdk";

const notra = new Notra({
  bearerAuth: process.env.NOTRA_API_KEY ?? "",
});
Store your API key in an environment variable. Create and manage keys in your dashboard under Developer → API Keys.
For single-post lookups: 
const post = await notra.content.getPost({
  postId: "post_abc",
});

​
Common Tasks

See Common Tasks for copy-paste examples such as updating an existing post and guidance on unsupported create-post patterns.

​
Available Endpoints

Posts

Browse the post listing, single-post, update, and delete routes.

Generation

Queue generation jobs and poll their status updates.

Brand Identities

Browse the brand identity list and single-identity routes.

Integrations

Discover available integrations to use in generation requests.

​
Next Steps

Pagination

Learn how to paginate through large result sets.

TypeScript Types

Use our TypeScript definitions for type-safe development.

Caching

Learn how to cache paginated post data and invalidate it safely.

Common Tasks

Find practical examples for updates and other common implementation questions.