> ## Documentation Index > Fetch the complete documentation index at: https://docs.usenotra.com/llms.txt > Use this file to discover all available pages before exploring further. # Plan a content brief > Researches the topic and writes a brief, then saves it as a draft article. This books AI credits and is billed. Planning happens inside Notra, which owns the model credentials. Set `autoApprove` to start the writer in the same call. When `sourceKind` and `sourceId` point at a gap that already has an open brief, that brief is returned instead of a new one being planned. If planning exceeds four minutes, the API returns 409 while work may still finish in Notra. Do not retry; list the project's GEO briefs to find the result. ## OpenAPI ````yaml https://api.usenotra.com/openapi.json post /v1/projects/{projectId}/geo/briefs 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. servers: - url: https://api.usenotra.com description: Production security: - BearerAuth: [] tags: - 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. paths: /v1/projects/{projectId}/geo/briefs: post: tags: - GEO summary: Plan a content brief description: >- Researches the topic and writes a brief, then saves it as a draft article. This books AI credits and is billed. Planning happens inside Notra, which owns the model credentials. Set `autoApprove` to start the writer in the same call. When `sourceKind` and `sourceId` point at a gap that already has an open brief, that brief is returned instead of a new one being planned. If planning exceeds four minutes, the API returns 409 while work may still finish in Notra. Do not retry; list the project's GEO briefs to find the result. operationId: planGeoContentBrief parameters: - schema: type: string minLength: 1 pattern: ^[A-Za-z0-9_-]{1,100}$ example: b1f2c3d4-0000-4000-8000-000000000000 required: true name: projectId in: path requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/PlanGeoContentBriefRequest' responses: '200': description: Brief planned successfully content: application/json: schema: $ref: '#/components/schemas/PlanGeoContentBriefResponse' '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: GEO plan or available AI credits required content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Organization, project or resource not found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '409': description: >- Brief planning is still running after the internal timeout; do not retry the plan content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '429': description: >- Rate limit exceeded. This endpoint allows 10 requests per 10 minutes per organization. headers: RateLimit-Limit: description: Maximum requests allowed in the current window. schema: type: integer RateLimit-Remaining: description: Requests remaining in the current window. schema: type: integer RateLimit-Reset: description: Seconds until the current window resets. schema: type: integer Retry-After: description: Seconds the client should wait before retrying. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/RateLimitErrorResponse' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '503': description: Authentication or billing service unavailable content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' components: schemas: PlanGeoContentBriefRequest: type: object properties: topic: type: string minLength: 3 maxLength: 200 description: >- What the article should target. Replaced by the source prompt when sourceKind is gap, prompt or search_console. autoApprove: type: boolean default: false description: Start the writer immediately instead of leaving the brief in draft. contentSubtype: type: string enum: - guide - comparison - listicle - how-to - faq - alternatives brandVoiceIds: type: array items: type: string minLength: 1 pattern: ^[A-Za-z0-9_-]{1,100}$ maxItems: 8 description: >- Only the first entry is used; it overrides the project's brand identity. competitorIds: type: array items: type: string minLength: 1 pattern: ^[A-Za-z0-9_-]{1,100}$ maxItems: 25 sitemapId: type: string minLength: 1 pattern: ^[A-Za-z0-9_-]{1,100}$ sourceKind: type: string enum: - manual - gap - prompt - search_console sourceId: type: string minLength: 1 description: >- Gap, prompt or search-console suggestion id. An open brief for the same source is reused instead of planning a new one. existingPageUrl: type: string maxLength: 2048 format: uri description: >- Existing page the article should refresh instead of creating a competing page. required: - topic PlanGeoContentBriefResponse: type: object properties: briefId: type: string brief: $ref: '#/components/schemas/GeoContentBriefDocument' status: type: string enum: - draft - approved - writing - completed - failed runId: type: - string - 'null' postId: type: - string - 'null' organization: type: object properties: id: type: string slug: type: string name: type: string logo: type: - string - 'null' required: - id - slug - name - logo required: - briefId - brief - status - runId - postId - organization ErrorResponse: type: object properties: error: type: string code: type: string recovery: type: string required: - error RateLimitErrorResponse: type: object properties: error: type: string limit: type: integer minimum: 1 remaining: type: integer minimum: 0 reset: type: integer required: - error - limit - remaining - reset GeoContentBriefDocument: type: object properties: targetPrompt: type: string intent: type: string contentSubtype: type: string enum: - guide - comparison - listicle - how-to - faq - alternatives workingTitle: type: string audience: type: string jobToBeDone: type: string sections: type: array items: type: object properties: heading: type: string goal: type: string claims: type: array items: type: string required: - heading - goal - claims questionsToAnswer: type: array items: type: string internalLinks: type: array items: type: object properties: url: type: string anchor: type: string why: type: string required: - url - anchor - why acceptanceChecklist: type: array items: type: string recommendedAngle: type: string competitorsToCounter: type: array items: type: string sourcesToReference: type: array items: type: string missingCoverage: type: array items: type: string baseline: type: - object - 'null' properties: sourcePromptId: type: string mentionedEngines: type: number totalEngines: type: number engines: type: array items: type: object properties: engine: type: string mentioned: type: boolean position: type: - number - 'null' required: - engine - mentioned - position competitorMentions: type: array items: type: object properties: name: type: string engines: type: number required: - name - engines citedDomains: type: array items: type: object properties: domain: type: string engines: type: number required: - domain - engines capturedAt: type: - string - 'null' required: - sourcePromptId - mentionedEngines - totalEngines - engines - competitorMentions - citedDomains - capturedAt required: - targetPrompt - intent - contentSubtype - workingTitle - audience - jobToBeDone - sections - questionsToAnswer - internalLinks - acceptanceChecklist securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: API Key description: Send your API key in the Authorization header as Bearer API_KEY. ````