> ## Documentation Index > Fetch the complete documentation index at: https://www.usenotra.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Publish a post to a Site > Opens a pull request that adds a blog post or changelog to the Site's repository, with its images and frontmatter, or updates the post's open pull request. The Site goes live with the post once the pull request is merged, even when the repository publishes directly from the dashboard. ## OpenAPI ````yaml https://api.usenotra.com/openapi.json post /v1/sites/{siteId}/publications openapi: 3.1.1 info: title: Notra API version: 1.0.0 description: >- OpenAPI schema for Notra content endpoints. Use GET /v1/status for public reachability. Error responses include recovery guidance. Breaking changes ship under a new major path; deprecated operations send Deprecation and Sunset headers at least 90 days before removal. servers: - url: https://api.usenotra.com description: Production - url: https://demo-api.usenotra.com description: >- Sandbox with sample data. Get a free sandbox key at demo.usenotra.com, no signup needed security: - BearerAuth: [] tags: - name: Webhooks description: Manage outbound webhook subscriptions and delivery history. - name: Discovery description: Public API status and authenticated workspace discovery. - name: Content description: >- Manage posts, brand identities, and GitHub or Linear integrations, and queue content generation. Organization is inferred from the API key (identity.externalId). - name: Schedules description: >- Manage scheduled content generation. Organization is inferred from the API key (identity.externalId). - name: Event Triggers description: >- Manage event-based content generation triggered by GitHub webhooks. Organization is inferred from the API key (identity.externalId). - name: Chats description: >- Manage chat sessions. Organization is inferred from the API key (identity.externalId). - name: Skills description: >- Manage reusable writing skills. Organization is inferred from the API key (identity.externalId). - name: Feedback description: >- Collect and triage feedback submitted by AI agents. Agents post to the organization's feedback URL without credentials; reading and triage require an API key with feedback.read or feedback.write. - name: GEO description: >- Manage generative engine optimization: projects, tracking settings, prompts, prompt sequences, competitors, scans, visibility reads, content gaps and briefs, agent readiness and AI traffic. Project-scoped endpoints require the GEO plan entitlement in addition to their scope; organization-level ingest endpoints require only the traffic scope. - name: Sites description: >- Notra Sites are hosted blogs and changelogs built from a GitHub repository. Read Sites and their deployments, start builds, preview posts on a Site, open pull requests that publish posts to it, and manage blog.json authors and the author page through staged Design changes. Domains, settings, rollbacks and deletion stay in the dashboard. externalDocs: description: Notra API versioning and deprecation policy url: https://www.usenotra.com/docs/api/versioning paths: /v1/sites/{siteId}/publications: post: tags: - Sites summary: Publish a post to a Site description: >- Opens a pull request that adds a blog post or changelog to the Site's repository, with its images and frontmatter, or updates the post's open pull request. The Site goes live with the post once the pull request is merged, even when the repository publishes directly from the dashboard. operationId: publishPostToSite parameters: - schema: type: string minLength: 1 pattern: ^[A-Za-z0-9_-]{1,100}$ example: site_8f2kq1 required: true in: path name: siteId requestBody: content: application/json: schema: type: object properties: postId: type: string minLength: 1 pattern: ^[A-Za-z0-9_-]{1,100}$ example: post_123 required: - postId responses: '200': description: Pull request opened or updated content: application/json: schema: $ref: '#/components/schemas/PublishSitePostResponse' '400': description: Invalid request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Missing or invalid API key content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '402': description: Plan limit reached content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Forbidden or missing the sites scope content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Organization, Site, deployment or post not found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '409': description: Conflict content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '429': description: Too many requests content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '502': description: Sites request failed content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '503': description: Notra Sites is not available content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '504': description: Request timed out and may still complete content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' components: schemas: PublishSitePostResponse: type: object properties: operation: type: string enum: - created - updated branchName: type: string path: type: string pullRequestNumber: type: integer pullRequestUrl: type: string organization: type: object properties: id: type: string slug: type: string name: type: string logo: type: - string - 'null' required: - id - slug - name - logo required: - operation - branchName - path - pullRequestNumber - pullRequestUrl - organization ErrorResponse: type: object properties: error: type: string code: type: string recovery: type: string required: - error securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: API Key description: >- 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. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.