> ## Documentation Index > Fetch the complete documentation index at: https://docs.tweet-catcher.com/llms.txt > Use this file to discover all available pages before exploring further. # Edit Task > Updates the configuration of an existing task The task **`id`** is required, all other fields are optional and replace the current values when provided The task does **not** need to be stopped before editing, changes are applied immediately ## OpenAPI ````yaml /api-specification.yaml post /edit-task openapi: 3.0.3 info: title: Tweet Catcher Monitor API description: API for managing Tweet Catcher monitoring tasks and user data version: 1.0.0 contact: name: Tweet Catcher url: https://dashboard.tweet-catcher.com/support servers: - url: https://monitor-api.tweet-catcher.com/pro description: Production server security: - ApiKeyToken: [] tags: - name: Manage Tasks description: Operations for managing Tweet Catcher monitoring tasks - name: User Data description: Operations for retrieving user-related data and history paths: /edit-task: post: tags: - Manage Tasks summary: Edit Task description: >- Updates the configuration of an existing task The task **`id`** is required, all other fields are optional and replace the current values when provided The task does **not** need to be stopped before editing, changes are applied immediately operationId: editTask requestBody: required: true content: application/json: schema: type: object properties: id: type: number description: Unique task identifier example: 685 module: type: string enum: - twitter - truth_social - twitter_keyword default: twitter description: Platform module to monitor example: twitter user: type: string description: Username to monitor (not applicable for keyword tasks) example: Gioppooo keyword: type: string description: Keyword to monitor (used by twitter_keyword module) example: bitcoin group: type: string description: Task group for organization example: influencers options: type: array items: type: string enum: - posts - retweets - replies - deletion - following - unfollow - userUpdates - ocr - subscriptions - private description: Monitoring option example: posts default: - posts description: Monitoring options example: - ocr - posts - retweets - replies notification: type: string enum: - discord - telegram - webhook - websocket default: discord description: Notification method example: discord differentWebhooks: type: boolean default: false description: >- Whether to use different webhooks/chat IDs per monitoring option example: false webhook: type: string description: Discord webhook URL or custom webhook URL example: https://discord.com/api/webhooks/... webhook-posts: type: string description: Webhook for posts (if differentWebhooks is true) webhook-following: type: string description: Webhook for following updates (if differentWebhooks is true) webhook-unfollow: type: string description: Webhook for unfollow updates (if differentWebhooks is true) webhook-userUpdates: type: string description: Webhook for user updates (if differentWebhooks is true) webhook-deletion: type: string description: Webhook for deletion updates (if differentWebhooks is true) chatId: type: string description: Telegram chat ID example: '123456789' chatId-posts: type: string description: Telegram chat ID for posts (if differentWebhooks is true) chatId-following: type: string description: >- Telegram chat ID for following updates (if differentWebhooks is true) chatId-unfollow: type: string description: >- Telegram chat ID for unfollow updates (if differentWebhooks is true) chatId-userUpdates: type: string description: >- Telegram chat ID for user updates (if differentWebhooks is true) chatId-deletion: type: string description: >- Telegram chat ID for deletion updates (if differentWebhooks is true) pingKeywords: type: object properties: 'n': type: array items: type: string default: [] description: Negative keywords that suppress pings example: - raffle p: type: array items: type: string default: [] description: Positive keywords that trigger pings example: - mint - launch regex: type: string description: Regex pattern used for ping matching example: (mint|launch) isRegex: type: boolean default: false description: Whether regex matching is enabled example: false description: Keywords or regex configuration used for selective pinging example: 'n': - test p: - alpha isRegex: false useRegex: type: boolean default: false description: Whether to use regex for ping keywords example: false ping: type: string enum: - everyone - here - role - none default: none description: Discord ping option example: everyone roleId: type: string description: Discord role ID to ping (required if ping is role) example: '123456789012345678' note: type: string description: Task note shown in notifications example: high priority profile quickLink: type: string description: Custom quick link included in notifications example: https://x.com/Gioppooo ignoreImages: type: boolean default: false description: Whether to ignore images in notifications example: false ignoreVideos: type: boolean default: false description: Whether to ignore videos in notifications example: false followingFilters: type: object properties: followingMinPosts: type: number nullable: true description: Minimum posts count filter example: 10 followingMaxPosts: type: number nullable: true description: Maximum posts count filter example: 50000 followingMinFollowers: type: number nullable: true description: Minimum followers count filter example: 500 followingMaxFollowers: type: number nullable: true description: Maximum followers count filter example: 1000000 followingMinFollowing: type: number nullable: true description: Minimum following count filter example: 10 followingMaxFollowing: type: number nullable: true description: Maximum following count filter example: 10000 description: >- Filters for following notifications (typically used with Discord and Telegram notifications) userUpdatesOptions: type: object properties: disableUsernameUpdate: type: boolean default: false description: Disable username change notifications example: false disableNameUpdate: type: boolean default: false description: Disable display name change notifications example: false disableAvatarUpdate: type: boolean default: false description: Disable avatar change notifications example: false disableBannerUpdate: type: boolean default: false description: Disable banner change notifications example: false disableLocationUpdate: type: boolean default: false description: Disable location change notifications example: false disableDescriptionUpdate: type: boolean default: false description: Disable bio/description change notifications example: false disableWebsiteUpdate: type: boolean default: false description: Disable website change notifications example: false disablePinnedTweetUpdate: type: boolean default: false description: Disable pinned tweet change notifications example: false disableVerificationUpdate: type: boolean default: false description: Disable verification badge change notifications example: false description: >- Options for user update notifications (typically used with Discord and Telegram notifications) _keys: type: array items: type: string required: - id - _keys examples: change_notification: summary: Switch notification channel to WebSocket value: id: 932 notification: websocket change_options: summary: Add OCR and replies to an existing task value: id: 733 options: - posts - replies - ocr responses: '200': description: Task updated successfully content: application/json: schema: type: object properties: error: type: boolean example: false description: Whether an error occurred required: - error example: error: false '400': description: Invalid request body or task not found content: application/json: schema: type: object properties: error: type: boolean example: true description: Whether an error occurred message: type: string example: Error message description: The error message errors: type: object additionalProperties: type: array items: type: string example: email: - Invalid module description: The errors required: - error - message example: error: true message: Invalid request parameters '401': description: Missing or invalid API key content: application/json: schema: type: object properties: error: type: boolean example: true description: Whether an error occurred message: type: string example: Error message description: The error message required: - error - message example: error: true message: Invalid or missing authorization token '500': description: Unexpected server error security: - ApiKeyToken: [] components: securitySchemes: ApiKeyToken: type: apiKey in: header name: Authorization description: Api key for application authentication ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.