> ## 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. # Update Content Agent settings > Updates the project's Content Agent configuration. Requires the org Content Agent entitlement and that setup was completed in the dashboard (`setupCompletedAt`). ## OpenAPI ````yaml /v2/openapi.json put /content-agent/settings 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 Agent description: >- Content Agent (automated content) lifecycle: project settings, scheduled slots, review (accept/decline), and publish. - name: Content Gap description: Content gap analysis and recommendations - name: Publishing description: >- Publish content to a connected CMS, or record a live URL, and track the published page - 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 - name: Ads Radar description: Sponsored ads captured in AI answers - name: Shopping description: Product appearances in AI shopping answers and tracked products paths: /content-agent/settings: put: tags: - Content Agent summary: Update Content Agent settings description: >- Updates the project's Content Agent configuration. Requires the org Content Agent entitlement and that setup was completed in the dashboard (`setupCompletedAt`). operationId: updateContentAgentSettings requestBody: required: true content: application/json: schema: type: object properties: enabled: type: boolean description: >- Pause or re-enable the agent. Requires setup to be completed. autonomyMode: type: string enum: - GATED - AUTOMATE publishState: type: string enum: - LIVE - DRAFT publishTiming: type: string enum: - AT_SLOT - IMMEDIATE_ON_APPROVAL publishWindows: type: object description: >- Allowed publish windows per weekday, in minutes from local midnight in scheduleTimezone. properties: days: type: array minItems: 1 items: type: object properties: weekday: type: integer minimum: 0 maximum: 6 description: 0 = Sunday … 6 = Saturday. startMinute: type: integer minimum: 0 maximum: 1425 endMinute: type: integer minimum: 15 maximum: 1440 required: - weekday - startMinute - endMinute additionalProperties: false required: - days additionalProperties: false blackoutDates: type: array items: type: string scheduleTimezone: type: string nullable: true description: IANA timezone; null clears to org default. maxPerDay: type: integer minimum: 1 maximum: 20 budgetPercentage: type: number minimum: 0 maximum: 1 defaultEnabledTools: type: array items: type: string enum: - GOOGLE_SEARCH - GOOGLE_NEWS_SEARCH - CRAWL_WEBSITE - ANALYZE_COMPETITOR_PAGE - GENERATE_ARTICLE_IMAGE - FIND_INTERNAL_LINKS - TAKE_SCREENSHOT - SEARCH_KNOWLEDGE_BASE cmsConnectionId: type: string format: uuid nullable: true additionalProperties: false responses: '200': description: Default Response content: application/json: schema: type: object properties: settings: type: object nullable: true description: >- Project Content Agent settings. Null when setup has never been completed. properties: enabled: type: boolean description: Master switch for the Content Agent on this project. setupCompletedAt: type: string format: date-time description: >- When the setup wizard was completed; null until first-run setup finishes. nullable: true autonomyMode: type: string enum: - GATED - AUTOMATE description: >- GATED: every piece needs human accept. AUTOMATE: gate-cleared pieces auto-publish. publishState: type: string enum: - LIVE - DRAFT description: >- Whether published pieces go live or land as CMS drafts. publishTiming: type: string enum: - AT_SLOT - IMMEDIATE_ON_APPROVAL description: >- Publish at the scheduled slot, or immediately on approval. publishWindows: type: object description: >- Allowed publish windows per weekday, in minutes from local midnight in scheduleTimezone. properties: days: type: array items: type: object properties: weekday: type: integer minimum: 0 maximum: 6 description: 0 = Sunday … 6 = Saturday. startMinute: type: integer minimum: 0 maximum: 1425 endMinute: type: integer minimum: 15 maximum: 1440 required: - weekday - startMinute - endMinute additionalProperties: false additionalProperties: true blackoutDates: type: array items: type: string description: >- ISO date strings (YYYY-MM-DD) when publishing is blocked. scheduleTimezone: type: string nullable: true description: >- IANA timezone for publish windows; null falls back to org/project default. maxPerDay: type: integer minimum: 1 maximum: 20 description: Max pieces published per day. budgetPercentage: type: number minimum: 0 maximum: 1 description: >- Share of the org content-generation budget the agent may use (0–1). defaultEnabledTools: type: array items: type: string enum: - GOOGLE_SEARCH - GOOGLE_NEWS_SEARCH - CRAWL_WEBSITE - ANALYZE_COMPETITOR_PAGE - GENERATE_ARTICLE_IMAGE - FIND_INTERNAL_LINKS - TAKE_SCREENSHOT - SEARCH_KNOWLEDGE_BASE description: >- Default writer tools when a slot does not specify tools. cmsConnectionId: type: string format: uuid nullable: true description: >- CMS connection used for publishing; null = manual export only. createdAt: type: string format: date-time description: Timestamp (ISO 8601) updatedAt: type: string format: date-time description: Timestamp (ISO 8601) required: - enabled - setupCompletedAt - autonomyMode - publishState - publishTiming - publishWindows - blackoutDates - scheduleTimezone - maxPerDay - budgetPercentage - defaultEnabledTools - cmsConnectionId - createdAt - updatedAt additionalProperties: false required: - settings additionalProperties: false '400': description: Default Response content: application/json: schema: type: object example: code: CONTENT_AUTOMATION_SLOT_NOT_FOUND message: Content piece not found properties: code: type: string description: Machine-readable error code enum: - CONTENT_AUTOMATION_DISABLED - CONTENT_AUTOMATION_FEATURE_DISABLED - CONTENT_AUTOMATION_PROJECT_NOT_FOUND - CONTENT_AUTOMATION_SETUP_INCOMPLETE - CONTENT_AUTOMATION_SHARE_BELOW_COMMITTED - CONTENT_AUTOMATION_SLOT_NOT_FOUND - CONTENT_AUTOMATION_SLOT_INVALID_STATE - CONTENT_AUTOMATION_SLOT_NOT_EDITABLE - CONTENT_AUTOMATION_SLOT_NO_DOCUMENT - CONTENT_AUTOMATION_BUDGET_EXCEEDED - CONTENT_AUTOMATION_PUBLISH_FAILED - CONTENT_INVALID_PERSONA - API_KEY_READ_ONLY - INTERNAL_ERROR example: CONTENT_AUTOMATION_DISABLED message: type: string description: Human-readable error message example: Content piece not found required: - code - message 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 '402': description: Default Response content: application/json: schema: type: object example: code: CONTENT_AUTOMATION_SLOT_NOT_FOUND message: Content piece not found properties: code: type: string description: Machine-readable error code enum: - CONTENT_AUTOMATION_DISABLED - CONTENT_AUTOMATION_FEATURE_DISABLED - CONTENT_AUTOMATION_PROJECT_NOT_FOUND - CONTENT_AUTOMATION_SETUP_INCOMPLETE - CONTENT_AUTOMATION_SHARE_BELOW_COMMITTED - CONTENT_AUTOMATION_SLOT_NOT_FOUND - CONTENT_AUTOMATION_SLOT_INVALID_STATE - CONTENT_AUTOMATION_SLOT_NOT_EDITABLE - CONTENT_AUTOMATION_SLOT_NO_DOCUMENT - CONTENT_AUTOMATION_BUDGET_EXCEEDED - CONTENT_AUTOMATION_PUBLISH_FAILED - CONTENT_INVALID_PERSONA - API_KEY_READ_ONLY - INTERNAL_ERROR example: CONTENT_AUTOMATION_DISABLED message: type: string description: Human-readable error message example: Content piece not found required: - code - message additionalProperties: false '403': description: Default Response content: application/json: schema: type: object example: code: CONTENT_AUTOMATION_SLOT_NOT_FOUND message: Content piece not found properties: code: type: string description: Machine-readable error code enum: - CONTENT_AUTOMATION_DISABLED - CONTENT_AUTOMATION_FEATURE_DISABLED - CONTENT_AUTOMATION_PROJECT_NOT_FOUND - CONTENT_AUTOMATION_SETUP_INCOMPLETE - CONTENT_AUTOMATION_SHARE_BELOW_COMMITTED - CONTENT_AUTOMATION_SLOT_NOT_FOUND - CONTENT_AUTOMATION_SLOT_INVALID_STATE - CONTENT_AUTOMATION_SLOT_NOT_EDITABLE - CONTENT_AUTOMATION_SLOT_NO_DOCUMENT - CONTENT_AUTOMATION_BUDGET_EXCEEDED - CONTENT_AUTOMATION_PUBLISH_FAILED - CONTENT_INVALID_PERSONA - API_KEY_READ_ONLY - INTERNAL_ERROR example: CONTENT_AUTOMATION_DISABLED message: type: string description: Human-readable error message example: Content piece not found required: - code - message additionalProperties: false '500': description: Default Response content: application/json: schema: type: object example: code: CONTENT_AUTOMATION_SLOT_NOT_FOUND message: Content piece not found properties: code: type: string description: Machine-readable error code enum: - CONTENT_AUTOMATION_DISABLED - CONTENT_AUTOMATION_FEATURE_DISABLED - CONTENT_AUTOMATION_PROJECT_NOT_FOUND - CONTENT_AUTOMATION_SETUP_INCOMPLETE - CONTENT_AUTOMATION_SHARE_BELOW_COMMITTED - CONTENT_AUTOMATION_SLOT_NOT_FOUND - CONTENT_AUTOMATION_SLOT_INVALID_STATE - CONTENT_AUTOMATION_SLOT_NOT_EDITABLE - CONTENT_AUTOMATION_SLOT_NO_DOCUMENT - CONTENT_AUTOMATION_BUDGET_EXCEEDED - CONTENT_AUTOMATION_PUBLISH_FAILED - CONTENT_INVALID_PERSONA - API_KEY_READ_ONLY - INTERNAL_ERROR example: CONTENT_AUTOMATION_DISABLED message: type: string description: Human-readable error message example: Content piece not found required: - code - message additionalProperties: false 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. ````