Skip to main content
GET
/
v1
/
teams
/
{team_id}
/
tasks
List Tasks
curl --request GET \
  --url https://api.dataraven.io/v1/teams/{team_id}/tasks \
  --header 'Authorization: Bearer <token>'
{
  "tasks": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "task_type": "copy",
      "source_location_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "source_location_name": "<string>",
      "source_location_bucket": "<string>",
      "destination_location_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "destination_location_name": "<string>",
      "destination_location_bucket": "<string>",
      "is_scheduled": true,
      "status": "enabled",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "description": "<string>",
      "source_path": "/prod/data",
      "destination_path": "/backup",
      "schedule_cron": "<string>",
      "last_scheduled_run_at": "2023-11-07T05:31:56Z",
      "last_execution_at": "2023-11-07T05:31:56Z",
      "last_execution_status": "pending",
      "has_active_execution": false
    }
  ],
  "pagination": {
    "page": 123,
    "limit": 123,
    "total": 123,
    "total_pages": 123
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
team_id
string<uuid>
required

Query Parameters

​
q
string | null

Search by name (case-insensitive partial match)

​
status_filter
enum<string> | null

Filter by task status Task definition status.

Available options:
enabled,
disabled,
archived
​
task_type
enum<string> | null

Filter by task type (copy/sync) Task operation types.

Available options:
copy,
sync
​
source_location_id
string<uuid> | null

Filter by source location

​
destination_location_id
string<uuid> | null

Filter by destination location

​
is_scheduled
boolean | null

Filter by scheduled/manual tasks

​
page
integer
default:1

Page number (1-indexed)

Required range: x >= 1
​
limit
integer
default:50

Items per page

Required range: 1 <= x <= 100
​
sort_by
enum<string> | null

Field to sort by: name, status, updated_at

Available options:
name,
status,
updated_at
​
sort_order
enum<string> | null

Sort order: asc or desc (default: desc) Sort order for list endpoints.

Available options:
asc,
desc

Response

Successful Response

Paginated list of tasks.

​
tasks
TaskListItemResponse · object[]
required
​
pagination
PaginationResponse · object
required

Pagination metadata in responses.