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

# Post apitransfers



## OpenAPI

````yaml /api-reference/openapi.yaml post /api/transfers/
openapi: 3.0.3
info:
  title: Console API
  version: 1.0.0
  description: Central control plane API for the Dataerai platform.
servers:
  - url: https://{server}
    description: Your Dataerai deployment (the API is served under /api)
    variables:
      server:
        default: your-deployment.dataerai.com
        description: Host of your Dataerai deployment
security: []
paths:
  /api/transfers/:
    post:
      tags:
        - api
      operationId: api_transfers_create
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TransferInitiate'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/TransferInitiate'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/TransferInitiate'
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransferInitiateResponse'
          description: ''
      security:
        - cookieAuthCsrfExempt: []
components:
  schemas:
    TransferInitiate:
      type: object
      properties:
        content_id:
          type: string
          format: uuid
        type:
          $ref: '#/components/schemas/TransferInitiateTypeEnum'
        files:
          type: array
          items:
            type: string
          description: 'Upload only: list of filenames to transfer.'
        expires_in:
          type: integer
          maximum: 604800
          minimum: 60
          default: 86400
          description: TTL in seconds (default 86400 = 1 day).
        supported_protocols:
          type: array
          items:
            type: string
          description: >-
            Preferred transfer protocols, e.g. ['s3']. Accepted but not yet used
            in credential selection.
        origin:
          allOf:
            - $ref: '#/components/schemas/TransferInitiateOriginEnum'
          default: user
          description: >-
            Transfer source. 'system' is used for internal fetches (e.g. README
            auto-load) and is filtered out of the tracker list by default.


            * `user` - user

            * `system` - system
      required:
        - content_id
        - type
    TransferInitiateResponse:
      type: object
      properties:
        transfer_id:
          type: string
          format: uuid
        credentials:
          type: object
          additionalProperties: {}
        endpoint:
          type: string
        prefix:
          type: string
        files:
          type: array
          items:
            type: object
            additionalProperties: {}
        expires_at:
          type: string
          format: date-time
      required:
        - credentials
        - endpoint
        - expires_at
        - files
        - prefix
        - transfer_id
    TransferInitiateTypeEnum:
      enum:
        - upload
        - download
      type: string
      description: |-
        * `upload` - upload
        * `download` - download
    TransferInitiateOriginEnum:
      enum:
        - user
        - system
      type: string
      description: |-
        * `user` - user
        * `system` - system

````