> ## Documentation Index > Fetch the complete documentation index at: https://promptwatch.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Get content by id > Returns one content document by id (status, body, and metadata). Use after POST /content/create to poll until generation finishes; see response field descriptions for partial vs final content. ## OpenAPI ````yaml /v2/openapi.json get /content/{id} openapi: 3.0.0 info: title: Promptwatch API v2 description: >- API v2 for customer integrations with Promptwatch monitoring platform. This version provides improved structure, additional endpoints, and enhanced functionality. version: 2.0.0 contact: name: Promptwatch Support email: team@promptwatch.com url: https://promptwatch.com license: name: Commercial url: https://promptwatch.com/terms-and-conditions servers: - url: https://server.promptwatch.com/api/v2 description: Promptwatch API v2 security: [] tags: - name: Authentication description: API key validation and authentication - name: Content description: >- AI content generation and optimization. Create content asynchronously and poll for results. - name: Content Gap description: Content gap analysis and recommendations - name: Models description: Available LLM models - name: Monitors description: Monitor management and CRUD operations - name: Page Tracker description: Track URLs and inspect citation stats, responses, and prompts - name: Prompts description: Prompt management and operations - name: Query Fanouts description: ChatGPT query fanout keywords - name: Responses description: LLM response data and analytics - name: Tags description: Tag management for prompts - name: Topics description: Topic management for prompts - name: Actions description: Action items (GEO suggestions and tasks) - name: Personas description: Persona configuration for monitors - name: Brands description: Brand management for competitive analysis - name: Visibility description: Brand visibility time series and competitor heatmaps - name: Citations description: Citation analytics from AI responses - name: Analytics description: Visitor analytics, AI crawler logs, sentiment, and brand visibility trends - name: Projects description: Project management (organization-level keys only) - name: Sitemap description: Sitemap crawl progress and discovered URLs - name: Site Health description: >- Crawled pages with SEO issues (titles, meta descriptions, H1, thin content) - name: Socials description: >- Social media citations (Reddit posts and YouTube videos) found in LLM responses paths: /content/{id}: get: tags: - Content summary: Get content by id description: >- Returns one content document by id (status, body, and metadata). Use after POST /content/create to poll until generation finishes; see response field descriptions for partial vs final content. operationId: getContent parameters: - schema: type: string format: uuid in: path name: id required: true description: Document id from create response. responses: '200': description: Default Response content: application/json: schema: type: object example: id: 6ba7b82c-9dad-11d1-80b4-00c04fd430c8 status: IN_PROGRESS mode: CREATE type: ARTICLE title: Illustrative draft title promptId: 6ba7b823-9dad-11d1-80b4-00c04fd430c8 prompt: Best CRM for 50-person services firms? description: Short brief for writers (illustrative). content: |- ## Section Partial markdown body… contentLength: MEDIUM optimizationLevel: null url: null toneOfVoice: PROFESSIONAL customToneOfVoice: null languageCode: en-US imageArtisticStyle: null imagePromptInstructions: null blockedWords: [] briefTitle: null briefDescription: null briefObjective: null briefCallToAction: null briefKeyPoints: [] briefContext: null createdAt: '2026-03-29T14:00:00.000Z' updatedAt: '2026-03-29T14:05:00.000Z' startedAt: '2026-03-29T14:00:30.000Z' completedAt: null failedAt: null failedReason: null stoppedAt: null properties: id: type: string format: uuid status: type: string enum: - DRAFT - PENDING - IN_PROGRESS - COMPLETED - FAILED - STOPPED description: >- PENDING: queued for generation; IN_PROGRESS: AI is actively generating content; COMPLETED: generation finished successfully; FAILED: generation encountered an error; STOPPED: generation was manually stopped by the user (may contain partial content). mode: type: string enum: - CREATE - OPTIMIZE type: type: string enum: - ARTICLE - BLOG_POST - OPINION - LISTICLE - HOW_TO - REVIEW - COMPARISON - CASE_STUDY - INTERVIEW - DOCUMENTATION - WIKI - PRODUCT_PAGE - LANDING_PAGE - PRESS_RELEASE - GENERIC_CONTENT - PRODUCT_COMPARISON nullable: true description: Set for CREATE mode. title: type: string nullable: true description: >- Document title. Null while PENDING; may appear during IN_PROGRESS as a partial or working title; final once COMPLETED. promptId: type: string format: uuid nullable: true description: >- Linked monitor prompt id (same as POST /content/create `promptId`). prompt: type: string nullable: true description: >- Linked LLM prompt text from GET /prompts; null if the prompt was removed. description: type: string nullable: true content: type: string nullable: true description: >- Markdown body. Null while PENDING; partially written during IN_PROGRESS (content streams in progressively and is incomplete); final once COMPLETED. STOPPED documents may contain partial content. contentLength: type: string enum: - SHORT - MEDIUM - LONG nullable: true optimizationLevel: type: string enum: - LOW - MEDIUM - HIGH nullable: true url: type: string format: uri nullable: true description: Optimize target URL (OPTIMIZE mode). toneOfVoice: type: string enum: - PROFESSIONAL - CASUAL - TECHNICAL - CONVERSATIONAL - NEUTRAL - AUTHORITATIVE - FRIENDLY - PERSUASIVE - FORMAL - WITTY - CUSTOM nullable: true customToneOfVoice: type: string nullable: true languageCode: type: string enum: - en-US - en-GB - en-IN - en-AU - en-CA - en-NZ - nl-NL - nl-BE - es-ES - es-MX - es-AR - es-CO - es-CL - es-PE - es-VE - ca-ES - fr-FR - fr-BE - fr-CA - de-DE - de-AT - de-CH - cs-CZ - sk-SK - no-NO - sv-SE - da-DK - it-IT - fi-FI - pl-PL - hu-HU - ro-RO - lt-LT - lv-LV - uk-UA - el-GR - tr-TR - ar-SA - ar-EG - ar-AE - he-IL - pt-PT - pt-BR - ja-JP - id-ID - vi-VN - th-TH - km-KH - en-KH - ko-KR - hi-IN - ru-RU - kk-KZ - ms-MY - fil-PH - zh-SG - zh-TW - zh-HK nullable: true imageArtisticStyle: type: string enum: - photo-realistic - flat-illustration - watercolor - 3d-render - minimalist - isometric - editorial - abstract nullable: true imagePromptInstructions: type: string nullable: true blockedWords: type: array items: type: string briefTitle: type: string nullable: true description: >- Brief: exact title supplied at creation. Null if not provided. briefDescription: type: string nullable: true description: >- Brief: exact meta description supplied at creation. Null if not provided. briefObjective: type: string nullable: true description: >- Brief: goal or purpose of the content piece. Null if not provided. briefCallToAction: type: string nullable: true description: 'Brief: desired call-to-action. Null if not provided.' briefKeyPoints: type: array items: type: string description: >- Brief: key points the article was instructed to cover. Empty array if not provided. briefContext: type: string nullable: true description: >- Brief: additional context or background supplied at creation. Null if not provided. createdAt: type: string format: date-time updatedAt: type: string format: date-time startedAt: type: string format: date-time nullable: true completedAt: type: string format: date-time nullable: true failedAt: type: string format: date-time nullable: true failedReason: type: string nullable: true stoppedAt: type: string format: date-time nullable: true required: - id - status - mode - type - title - promptId - prompt - description - content - contentLength - optimizationLevel - url - toneOfVoice - customToneOfVoice - languageCode - imageArtisticStyle - imagePromptInstructions - blockedWords - briefTitle - briefDescription - briefObjective - briefCallToAction - briefKeyPoints - briefContext - createdAt - updatedAt - startedAt - completedAt - failedAt - failedReason - stoppedAt additionalProperties: false '401': description: Default Response content: application/json: schema: type: object example: error: Unauthorized message: Missing or invalid X-API-Key header. properties: error: type: string description: Error category (often aligned with HTTP semantics) code: type: string description: Optional machine-readable code message: type: string description: Human-readable explanation details: type: object description: Optional structured detail (e.g. validation) additionalProperties: true required: - error - message additionalProperties: false '404': description: Default Response content: application/json: schema: type: object example: code: CONTENT_NOT_FOUND message: Content document not found properties: code: type: string description: Machine-readable error code enum: - CONTENT_NOT_FOUND - CONTENT_DRAFT_NOT_FOUND - CONTENT_INVALID_PROMPT - CONTENT_INVALID_PERSONA - CONTENT_PAGE_FETCH_FAILED - CONTENT_PAGE_NOT_FOUND - CONTENT_PAGE_NO_CONTENT - CONTENT_INVALID_TONE - CONTENT_RECOMMENDATION_NOT_FOUND - CONTENT_GENERATION_FAILED - INTERNAL_ERROR example: CONTENT_NOT_FOUND message: type: string description: Human-readable error message example: Content document not found required: - code - message additionalProperties: false examples: example1: value: code: CONTENT_NOT_FOUND message: Content document not found example2: value: code: CONTENT_INVALID_PROMPT message: Prompt not found or does not belong to this project example3: value: code: CONTENT_GENERATION_FAILED message: Failed to start content generation '500': description: Default Response content: application/json: schema: type: object example: code: CONTENT_NOT_FOUND message: Content document not found properties: code: type: string description: Machine-readable error code enum: - CONTENT_NOT_FOUND - CONTENT_DRAFT_NOT_FOUND - CONTENT_INVALID_PROMPT - CONTENT_INVALID_PERSONA - CONTENT_PAGE_FETCH_FAILED - CONTENT_PAGE_NOT_FOUND - CONTENT_PAGE_NO_CONTENT - CONTENT_INVALID_TONE - CONTENT_RECOMMENDATION_NOT_FOUND - CONTENT_GENERATION_FAILED - INTERNAL_ERROR example: CONTENT_NOT_FOUND message: type: string description: Human-readable error message example: Content document not found required: - code - message additionalProperties: false examples: example1: value: code: CONTENT_NOT_FOUND message: Content document not found example2: value: code: CONTENT_INVALID_PROMPT message: Prompt not found or does not belong to this project example3: value: code: CONTENT_GENERATION_FAILED message: Failed to start content generation security: - ApiKeyAuth: [] components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: >- API key for authentication. Get yours from the Promptwatch dashboard under Settings > API Keys. ````