Get Tasks

Retrieve scheduled tasks from the database. Tasks have cron-based execution schedules. Supports filtering by id, account_id, or artist_account_id.

GET /api/tasks

cURL

cURL

curl --request GET \
  --url https://recoup-api.vercel.app/api/tasks \
  --header 'x-api-key: <api-key>'

200

{
  "tasks": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "title": "<string>",
      "prompt": "<string>",
      "schedule": "<string>",
      "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "artist_account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "enabled": true,
      "trigger_schedule_id": "<string>"
    }
  ],
  "error": "<string>"
}

Authorizations

x-api-key · string · header · required

Your Recoup API key. Learn more.

Query Parameters

id · string<uuid>

Filter by task ID (UUID). Returns a single task matching the provided ID.

account_id · string<uuid>

Filter tasks to only include those for the specified account.

artist_account_id · string<uuid>

Filter tasks to only include those for the specified artist account.

Response

200

application/json

Tasks retrieved successfully

status · enum<string> · required

Status of the request

Available options: success, error

tasks · object[] · required

Array of task objects

Show child attributes

error · string

Error message (only present if status is error)