> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.datalab.to/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.



## OpenAPI

````yaml https://www.datalab.to/openapi.json post /api/v1/custom_pipelines/{processor_id}/transfer
openapi: 3.1.0
info:
  title: Datalab API
  version: 0.0.1
servers:
  - url: https://www.datalab.to
    description: Datalab API
security: []
paths:
  /api/v1/custom_pipelines/{processor_id}/transfer:
    post:
      tags:
        - Custom Pipelines (Deprecated)
      summary: Transfer Custom Pipeline
      description: >-
        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.
      operationId: >-
        transfer_custom_pipeline_api_v1_custom_pipelines__processor_id__transfer_post
      parameters:
        - name: processor_id
          in: path
          required: true
          schema:
            type: string
            title: Processor Id
        - name: wos-session
          in: cookie
          required: false
          schema:
            type: string
            title: Wos-Session
        - name: datalab_active_team
          in: cookie
          required: false
          schema:
            type: string
            title: Datalab Active Team
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: >-
                #/components/schemas/Body_transfer_custom_pipeline_api_v1_custom_pipelines__processor_id__transfer_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CustomProcessorTransferResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
components:
  schemas:
    Body_transfer_custom_pipeline_api_v1_custom_pipelines__processor_id__transfer_post:
      properties:
        to_team_id:
          type: integer
          title: To Team Id
          description: Team ID to transfer the processor to
        to_processor_id:
          anyOf:
            - type: string
            - type: 'null'
          title: To Processor Id
          description: >-
            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:
          $ref: '#/components/schemas/CopyMode'
          description: >-
            Copy mode: 'with_history' copies all versions with checkpoints and
            session. 'without_history' copies only the active version as v1,
            stripping checkpoints and session.
          default: with_history
      type: object
      required:
        - to_team_id
      title: >-
        Body_transfer_custom_pipeline_api_v1_custom_pipelines__processor_id__transfer_post
    CustomProcessorTransferResponse:
      properties:
        success:
          type: boolean
          title: Success
          description: Whether the transfer was successful
        processor_id:
          type: string
          title: Processor Id
          description: The processor ID that was transferred
        from_team_id:
          type: integer
          title: From Team Id
          description: Team ID the processor was transferred from
        to_team_id:
          type: integer
          title: To Team Id
          description: Team ID the processor was transferred to
        message:
          type: string
          title: Message
          description: Success or error message
      type: object
      required:
        - success
        - processor_id
        - from_team_id
        - to_team_id
        - message
      title: CustomProcessorTransferResponse
      description: Response schema for transferring a custom processor to another team.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    CopyMode:
      type: string
      enum:
        - with_history
        - without_history
      title: CopyMode
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key

````