Confirm Rclone Import

curl --request POST \
  --url https://api.dataraven.io/v1/teams/{team_id}/rclone-import/confirm \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "remotes": [
    {
      "name": "<string>",
      "bucket_name": "<string>",
      "credentials": {},
      "region": "<string>",
      "endpoint_url": "<string>"
    }
  ]
}
'

{
  "created": [
    {
      "remote_name": "<string>",
      "secret_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "secret_name": "<string>",
      "location_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "location_name": "<string>"
    }
  ],
  "errors": [
    {
      "remote_name": "<string>",
      "message": "<string>"
    }
  ]
}

Rclone Import

Confirm Rclone Import

Confirm and execute the rclone.conf import, creating secrets and locations.

Required Role: ADMIN or OWNER

This is step 2 of the import workflow. Send the confirmed list of remotes (with any user modifications like name changes or bucket names) along with the actual credential values.

For each remote, this endpoint creates:

A Secret with credentials stored in AWS SSM Parameter Store
A Location linked to that secret

Remotes are processed independently - if one fails, others still succeed.

Request body:

{
    "remotes": [
        {
            "name": "My S3 Remote",
            "location_type": "s3",
            "auth_method": "s3_access_key",
            "region": "us-east-1",
            "bucket_name": "my-bucket",
            "credentials": {
                "access_key_id": "AKIA...",
                "secret_access_key": "wJal..."
            }
        }
    ]
}

Returns created resource pairs and any errors encountered.

POST

teams

{team_id}

rclone-import

confirm

Confirm Rclone Import

curl --request POST \
  --url https://api.dataraven.io/v1/teams/{team_id}/rclone-import/confirm \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "remotes": [
    {
      "name": "<string>",
      "bucket_name": "<string>",
      "credentials": {},
      "region": "<string>",
      "endpoint_url": "<string>"
    }
  ]
}
'

{
  "created": [
    {
      "remote_name": "<string>",
      "secret_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "secret_name": "<string>",
      "location_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "location_name": "<string>"
    }
  ],
  "errors": [
    {
      "remote_name": "<string>",
      "message": "<string>"
    }
  ]
}

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

Body

application/json

Request to import parsed rclone remotes (step 2 - confirm).

remotes

RemoteImportItem · object[]

required

List of remotes to import (from the parse preview, with user edits)

Minimum array length: 1

Show child attributes

Response

Successful Response

Response from importing rclone remotes (step 2 - results).

created

ImportedResourcePair · object[]

Successfully created secret+location pairs

Show child attributes

errors

ImportErrorDetail · object[]

Remotes that failed to import

Show child attributes

Parse Rclone Config

Documentation Index

Authorizations

Path Parameters

Body

Response