Transfer Custom Pipeline

Transfer a custom processor to another team. This endpoint allows admins to transfer ownership of a custom processor from one team to another. This is useful for:

1. Beta testing: Create and test processors internally, then transfer to customers
2. Sharing: Move successful processor configurations between teams
3. Updating: Push iterated versions to an existing customer processor (via to_processor_id)

Superusers can transfer any processor regardless of team ownership.

POST /api/v1/custom_pipelines/{processor_id}/transfer

Transfer Custom Pipeline

Python

import requests

url = "https://www.datalab.to/api/v1/custom_pipelines/{processor_id}/transfer"

payload = {
    "to_team_id": "123",
    "to_processor_id": "<string>",
    "copy_mode": "with_history"
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/x-www-form-urlencoded"
}

response = requests.post(url, data=payload, headers=headers)

print(response.text)

200

{
  "success": true,
  "processor_id": "<string>",
  "from_team_id": 123,
  "to_team_id": 123,
  "message": "<string>"
}

Authorizations

X-API-Key · string · header · required

Path Parameters

processor_id · string · required

Cookies

wos-session · string

datalab_active_team · string

Body

application/x-www-form-urlencoded

to_team_id · integer · required

Team ID to transfer the processor to

to_processor_id · string | null

Optional: existing pipeline ID on the target team to update in place. If provided, replaces the target processor's versions and metadata instead of creating a new copy.

copy_mode · enum<string> · default: with_history

Copy mode: 'with_history' copies all versions with checkpoints and session. 'without_history' copies only the active version as v1, stripping checkpoints and session.

Available options: with_history, without_history

Response

200

application/json

Successful Response

Response schema for transferring a custom processor to another team.

success · boolean · required

Whether the transfer was successful

processor_id · string · required

The processor ID that was transferred

from_team_id · integer · required

Team ID the processor was transferred from

to_team_id · integer · required

Team ID the processor was transferred to

message · string · required

Success or error message