> ## Documentation Index > Fetch the complete documentation index at: https://docs.linqalpha.com/llms.txt > Use this file to discover all available pages before exploring further. # Update Briefing Schedule > Update an existing briefing. All fields are optional. Update an existing briefing schedule. All fields are optional — only include the fields you want to change. ## Stock Selection Same as [Create Briefing](/api-reference/briefing/create): provide `stock_ids` (preferred) or `tickers`. Use the [Map Tickers](/api-reference/basic/map_tickers) endpoint to convert ticker symbols to stock IDs. ## Scheduled Time Format Must be in 12-hour AM/PM format: `"9:00 AM"`, `"3:30 PM"`, `"12:00 PM"`. ## Partial Update Only fields included in the request body will be updated. For example, to change only the schedule time: ```json theme={null} { "scheduled_time": "8:00 AM" } ``` To deactivate a briefing without deleting it: ```json theme={null} { "is_active": false } ``` Omitting a field leaves it unchanged. Sending `null` does **not** clear a field — for example, a linked watchlist group cannot currently be unlinked via this endpoint, and `language: null` does not reset an already-set language. ## Field Reference | Field | Type | Description | | ------------------------ | -------------- | ------------------------------------------------------------ | | `topic` | string | Briefing instructions | | `stock_ids` | string\[] | Internal stock UUIDs (preferred) | | `tickers` | string\[] | Ticker symbols (auto-resolved) | | `language` | string \| null | Output language (`null` = auto-detect; see note above) | | `scheduled_time` | string | `h:mm AM/PM` format | | `timezone` | string | IANA timezone (e.g. `America/New_York`) | | `frequency` | string | `daily`, `weekly`, or `monthly` | | `scheduled_day_of_week` | integer | 0 (Sun) – 6 (Sat), for weekly | | `scheduled_day_of_month` | integer | 1–31, for monthly | | `title` | string | Custom briefing title | | `source_type` | string | `tfs_only`, `rms_only`, or `both` | | `attach_pdf` | boolean | Attach PDF to delivery email | | `is_active` | boolean | Enable/disable the schedule | | `rms_sources` | object\[] | RMS source configs (`source`, `workspace`) | | `watchlist_group_id` | string | Watchlist group ID to link (unlink via `null` not supported) | | `use_custom_email_title` | boolean | Use title as fixed email subject | | `user_id` | string | Platform (EDS) keys only: target user's `customer_id` | | `user_email` | string | Platform (EDS) keys only: target user's email | | `user_name` | string | Platform (EDS) keys only: display name (used when creating) | ## OpenAPI ````yaml PATCH /v1/briefings/{id} openapi: 3.0.1 info: title: LinqAlpha API description: >- Linq helps finance professionals make informed decisions using Retrieval-Augmented Generation (RAG)-enhanced answers. By leveraging cutting-edge Large Language Models (LLM) and supplementary technology, Linq provides the most optimized responses based on your queries. version: 1.0.0 license: name: MIT servers: - url: https://api.linqalpha.com security: - ApiKeyAuth: [] tags: - name: Search description: Search and generate responses - name: Data description: Data retrieval and mapping - name: Feedback description: Conversation feedback - name: RMS description: Research Management System - name: Source Management description: Source batch and file management - name: MCP description: >- LinqAlpha MCP — Financial data tools for AI assistants via Model Context Protocol - name: Connectors description: Customer Connectors — customer-owned MCP connector management - name: Briefing description: Briefing Agent — automated market briefings with scheduling and delivery - name: Status description: Sync status — check organization, document, and container sync progress paths: /v1/briefings/{id}: patch: tags: - Briefing summary: Update Briefing description: Update an existing briefing. All fields are optional. operationId: updateBriefing parameters: - name: id in: path required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/BriefingUpdateRequest' responses: '200': description: Briefing updated content: application/json: schema: type: object properties: error: type: object nullable: true payload: $ref: '#/components/schemas/Briefing' components: schemas: BriefingUpdateRequest: type: object description: All fields are optional. Only include fields you want to change. properties: topic: type: string description: Briefing instructions/topic stock_ids: type: array items: type: string description: Internal stock UUIDs (preferred) tickers: type: array items: type: string description: Ticker symbols (auto-resolved) language: type: string nullable: true enum: - English - Spanish - French - German - Italian - Portuguese - Dutch - Hindi - Japanese - Chinese - Finnish - Korean - Polish - Russian - Turkish - Ukrainian - Vietnamese description: Output language (null = auto-detect) scheduled_time: type: string description: h:mm AM/PM format (e.g. '9:00 AM') timezone: type: string description: IANA timezone (e.g. Asia/Seoul) frequency: type: string enum: - daily - weekly - monthly scheduled_day_of_week: type: integer nullable: true minimum: 0 maximum: 6 description: 0=Sun, 6=Sat scheduled_day_of_month: type: integer nullable: true minimum: 1 maximum: 31 title: type: string nullable: true description: Custom briefing title source_type: type: string enum: - tfs_only - rms_only - both attach_pdf: type: boolean is_active: type: boolean description: Enable/disable the schedule rms_sources: type: array items: type: object properties: source: type: string workspace: type: string description: RMS source configurations watchlist_group_id: type: string nullable: true description: >- Watchlist group ID to link for dynamic ticker sync. Note: unlinking by sending null is not currently supported. use_custom_email_title: type: boolean description: Use title as fixed email subject organization_id: type: string description: >- Platform (EDS) keys only: org UUID under the key's platform. Ignored by org-bound keys. user_id: type: string description: >- Platform (EDS) keys only: the target user's customer_id (your external user id, not a UUID). Ignored by org-bound keys. user_email: type: string description: >- Platform (EDS) keys only: the target user's email. Ignored by org-bound keys. user_name: type: string description: >- Platform (EDS) keys only: optional display name (used only when creating the user). Briefing: type: object properties: id: type: string title: type: string nullable: true topic: type: string tickers: type: array items: type: string language: type: string nullable: true scheduled_time: type: string description: >- Time in h:mm AM/PM format, echoing the value provided on create/update (e.g. '9:00 AM') timezone: type: string description: IANA timezone frequency: type: string enum: - daily - weekly - monthly scheduled_day_of_week: type: integer nullable: true scheduled_day_of_month: type: integer nullable: true next_delivery_at: type: string nullable: true is_active: type: boolean source_type: type: string attach_pdf: type: boolean created_at: type: string updated_at: type: string securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-KEY ````