Update Task

{
  "summary": "Update scheduled task",
  "description": "Update an existing scheduled task. Only the id field is required; any additional fields you include will be updated on the task. The response shape matches the GET endpoint (an array containing the updated task).",
  "security": [
    {
      "apiKeyAuth": []
    },
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "description": "JSON object with `id` and optional fields to merge onto the task.",
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/UpdateTaskRequest"
        },
        "examples": {
          "updateTitleAndSchedule": {
            "summary": "Change title and cron",
            "value": {
              "id": "aade2bce-55c7-468e-a606-c4e76fb2ea2a",
              "title": "Weekly Genre Pulse Check (rev)",
              "schedule": "0 10 * * 4"
            }
          },
          "toggleEnabled": {
            "summary": "Pause or resume a task",
            "value": {
              "id": "aade2bce-55c7-468e-a606-c4e76fb2ea2a",
              "enabled": false
            }
          },
          "changeModel": {
            "summary": "Switch model only",
            "value": {
              "id": "aade2bce-55c7-468e-a606-c4e76fb2ea2a",
              "model": "claude-sonnet-4-20250514"
            }
          }
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "Task updated successfully. Body is a `TasksResponse` with the updated task in `tasks` (typically one task).",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/TasksResponse"
          }
        }
      }
    },
    "400": {
      "description": "Bad request — missing `id`, empty strings where a field is provided, or other validation failure from the request body. The body reports the first Zod issue via `missing_fields` and `error`.",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/UpdateTaskValidationErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "Unauthorized - missing or invalid credentials",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Error"
          }
        }
      }
    },
    "402": {
      "description": "Payment required - the account's plan does not allow this task. `limit` is `task_count` when the account already has `task_limit` enabled tasks, or `min_cadence` when the cron schedule fires more often than `min_cadence_minutes` allows. Nothing is written; upgrade at `billingUrl`.",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/PlanLimitError"
          },
          "examples": {
            "taskCount": {
              "summary": "Free account re-enabling a disabled task while another is enabled",
              "value": {
                "status": "error",
                "error": "plan_limit",
                "limit": "task_count",
                "message": "Free includes 1 task. Starter includes 3, Pro is unlimited.",
                "plan": "free",
                "task_limit": 1,
                "min_cadence_minutes": 10080,
                "current_task_count": 1,
                "billingUrl": "https://app.recoupable.dev/plan"
              }
            },
            "minCadence": {
              "summary": "Free account changing a task to a daily schedule",
              "value": {
                "status": "error",
                "error": "plan_limit",
                "limit": "min_cadence",
                "message": "Free runs tasks weekly at most. Starter runs daily, Pro runs hourly.",
                "plan": "free",
                "task_limit": 1,
                "min_cadence_minutes": 10080,
                "current_task_count": 0,
                "billingUrl": "https://app.recoupable.dev/plan"
              }
            }
          }
        }
      }
    },
    "403": {
      "description": "Forbidden - account_id is outside caller authorization scope",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Error"
          }
        }
      }
    },
    "404": {
      "description": "No task exists with the given `id`.",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/UpdateTaskFailureResponse"
          },
          "examples": {
            "notFound": {
              "summary": "Unknown task id",
              "value": {
                "status": "error",
                "error": "Task not found"
              }
            }
          }
        }
      }
    },
    "500": {
      "description": "Internal server error while updating the task or syncing the Trigger.dev schedule.",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/UpdateTaskFailureResponse"
          }
        }
      }
    }
  }
}