Get tasks

{
  "operationId": "getTasks",
  "description": "Retrieve scheduled tasks. Each task includes `recent_runs` (last 5 runs), `upcoming` (next scheduled run times) sourced directly from the Trigger.dev API, and `owner_email` when an account email exists for the task owner. Supports filtering by id, account_id, or artist_account_id.\n\nFetching one task by id performs the owner-plan preflight used by the runner and can return 402 plan_limit. Listing tasks remains distinct from permission to execute them.",
  "security": [
    {
      "apiKeyAuth": []
    },
    {
      "bearerAuth": []
    }
  ],
  "parameters": [
    {
      "name": "id",
      "in": "query",
      "description": "Filter by task ID (UUID). Returns a single task matching the provided ID. Admin callers may retrieve any task by ID regardless of owner; non-admin callers only receive the task if it belongs to their authenticated account.",
      "required": false,
      "schema": {
        "type": "string",
        "format": "uuid"
      }
    },
    {
      "name": "account_id",
      "in": "query",
      "description": "Filter tasks to only include those for the specified account.",
      "required": false,
      "schema": {
        "type": "string",
        "format": "uuid"
      }
    },
    {
      "name": "artist_account_id",
      "in": "query",
      "description": "Filter tasks to only include those for the specified artist account.",
      "required": false,
      "schema": {
        "type": "string",
        "format": "uuid"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Tasks retrieved successfully",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/TasksResponse"
          }
        }
      }
    },
    "400": {
      "description": "Bad request",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Error"
          }
        }
      }
    },
    "401": {
      "description": "Unauthorized — send exactly one of `x-api-key` or `Authorization: Bearer …`. Missing or conflicting headers return a text `error`; malformed or rejected credentials return a text `message`. Both envelopes include `status: error`; read whichever text field is present.",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/TaskAuthenticationErrorResponse"
          },
          "examples": {
            "missingOrConflictingCredentials": {
              "summary": "Missing credentials or both credential headers supplied",
              "value": {
                "status": "error",
                "error": "Exactly one of x-api-key or Authorization must be provided"
              }
            },
            "invalidCredential": {
              "summary": "Rejected API key, whether sent in x-api-key or as a Bearer key",
              "value": {
                "status": "error",
                "message": "Unauthorized"
              }
            }
          }
        }
      }
    },
    "402": {
      "description": "A single task fetched by id is blocked by its owner plan. Returns plan_limit with task_count or min_cadence and billingUrl. Ordinary listing does not apply this pre-run gate.",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/PlanLimitError"
          }
        }
      }
    },
    "403": {
      "description": "Forbidden — the requested `account_id` is outside the authenticated account's authorized access. Read the text `error`.",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/TaskFailureErrorResponse"
          },
          "examples": {
            "accountOverrideDenied": {
              "value": {
                "status": "error",
                "error": "Access denied to specified account_id"
              }
            }
          }
        }
      }
    },
    "500": {
      "description": "Internal server error while retrieving tasks. Read the text `error`; the message can vary. The examples illustrate the response shape.",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/TaskFailureErrorResponse"
          },
          "examples": {
            "serviceError": {
              "value": {
                "status": "error",
                "error": "Task service unavailable"
              }
            },
            "unexpectedFailure": {
              "value": {
                "status": "error",
                "error": "Internal server error"
              }
            }
          }
        }
      }
    }
  }
}