Skip to main content
PATCH
/
v1
/
teams
/
{team_id}
/
tasks
/
{task_id}
Update Task
curl --request PATCH \
  --url https://api.dataraven.io/v1/teams/{team_id}/tasks/{task_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "task_type": "copy",
  "source_location_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "destination_location_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "source_path": "<string>",
  "destination_path": "<string>",
  "rclone_config": {
    "bwlimit": "100M",
    "transfers": 4,
    "checkers": 8,
    "filters": {
      "filter": [
        "<string>"
      ],
      "max_age": "24h",
      "min_age": "24h",
      "max_size": "100M",
      "min_size": "1K"
    },
    "checksum": true,
    "size_only": true,
    "ignore_size": true,
    "modify_window": "1s",
    "update": true,
    "use_server_modtime": true,
    "no_update_modtime": true,
    "ignore_existing": true,
    "no_traverse": true,
    "max_depth": -1,
    "max_transfer": "1G",
    "max_backlog": 10000,
    "dry_run": true,
    "fast_list": true,
    "buffer_size": "16M",
    "immutable": true,
    "metadata": true,
    "s3_no_check_bucket": true,
    "b2_hard_delete": true,
    "disable_http2": true,
    "multi_thread_streams": 4,
    "tpslimit": 0,
    "tpslimit_burst": 1
  },
  "is_scheduled": true,
  "schedule_cron": "<string>"
}
'
{
  "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",
  "rclone_config": {
    "bwlimit": "100M",
    "transfers": 4,
    "checkers": 8,
    "filters": {
      "filter": [
        "<string>"
      ],
      "max_age": "24h",
      "min_age": "24h",
      "max_size": "100M",
      "min_size": "1K"
    },
    "checksum": true,
    "size_only": true,
    "ignore_size": true,
    "modify_window": "1s",
    "update": true,
    "use_server_modtime": true,
    "no_update_modtime": true,
    "ignore_existing": true,
    "no_traverse": true,
    "max_depth": -1,
    "max_transfer": "1G",
    "max_backlog": 10000,
    "dry_run": true,
    "fast_list": true,
    "buffer_size": "16M",
    "immutable": true,
    "metadata": true,
    "s3_no_check_bucket": true,
    "b2_hard_delete": true,
    "disable_http2": true,
    "multi_thread_streams": 4,
    "tpslimit": 0,
    "tpslimit_burst": 1
  }
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
task_id
string<uuid>
required
​
team_id
string<uuid>
required

Body

application/json

Schema for updating an existing task.

All fields are optional to support partial updates.

​
name
string | null
Required string length: 1 - 255
​
description
string | null
Maximum string length: 2000
​
task_type
enum<string> | null

Task operation types.

Available options:
copy,
sync
​
source_location_id
string<uuid> | null
​
destination_location_id
string<uuid> | null
​
source_path
string | null
Maximum string length: 1000
​
destination_path
string | null
Maximum string length: 1000
​
rclone_config
RCloneConfig · object

RClone configuration options for INPUT validation (TaskCreate/TaskUpdate).

This model validates user input and rejects unknown flags to prevent injection of untrusted rclone flags. Provider-specific defaults are injected at the service layer AFTER input validation.

See: https://rclone.org/flags/ for complete flag reference.

​
is_scheduled
boolean | null
​
schedule_cron
string | null
Maximum string length: 100

Response

Successful Response

Full task response with rclone config (for CRUD and detail endpoints).

​
id
string<uuid>
required
​
team_id
string<uuid>
required
​
created_by
string<uuid>
required
​
name
string
required
​
task_type
enum<string>
required

Task operation types.

Available options:
copy,
sync
​
source_location_id
string<uuid>
required
​
source_location_name
string
required

Source location display name

​
source_location_bucket
string
required

Source location bucket name

​
destination_location_id
string<uuid>
required
​
destination_location_name
string
required

Destination location display name

​
destination_location_bucket
string
required

Destination location bucket name

​
is_scheduled
boolean
required
​
status
enum<string>
required

Task definition status.

Available options:
enabled,
disabled,
archived
​
created_at
string<date-time>
required
​
updated_at
string<date-time>
required
​
description
string | null
Maximum string length: 2000
​
source_path
string | null

Path within source bucket

Maximum string length: 1000
Example:

"/prod/data"

​
destination_path
string | null

Path within destination bucket

Maximum string length: 1000
Example:

"/backup"

​
schedule_cron
string | null
Maximum string length: 100
​
last_scheduled_run_at
string<date-time> | null

Last scheduled execution time

​
rclone_config
RCloneConfig · object

RClone configuration options (includes provider-specific defaults)