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

# Send

> Send a file by email to one or more recipients.

Sends a file via email to the provided recipients. Schedule it for later or
gate it behind a password — both are optional.

### Body parameters

<ParamField body="source" type="string" required>
  Filename to share. Regex supported, but the request will return *a specific
  error code* if it matches to more than one source file.
</ParamField>

<ParamField body="to" type="string | string[]" required>
  Recipient email address. For multiple addresses, send as an array of
  strings. Maximum of `50` recipients per request.
</ParamField>

<ParamField body="bcc" type="string | string[]">
  Bcc recipient email address. For multiple addresses, send as an array of
  strings.
</ParamField>

<ParamField body="cc" type="string | string[]">
  Cc recipient email address. For multiple addresses, send as an array of
  strings.
</ParamField>

<ParamField body="scheduledAt" type="string">
  Schedule the email to be sent later. The date should be in natural language
  (e.g. `in 1 min`) or ISO 8601 format (e.g. `2026-08-05T11:52:01.858Z`).
</ParamField>

<ParamField body="replyTo" type="string | string[]">
  Reply-to email address. For multiple addresses, send as an array of strings.
</ParamField>

<ParamField body="text" type="string">
  Text to include alongside the file.
</ParamField>

<ParamField body="password" type="string">
  Text password required to unlock the sent file.
</ParamField>

### Example

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.byteport.com/send \
    -H "Authorization: Bearer bp_xxxxxxxxx" \
    -H "User-Agent: my-app/1.0" \
    -H "Content-Type: application/json" \
    -d '{
      "source":      "Production Bucket/reports/Q1.pdf",
      "to":          ["ada@example.com", "linus@example.com"],
      "scheduledAt": "in 1 min",
      "text":        "Quarterly report attached.",
      "password":    "hunter2"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id":     "snd_01HZ...",
    "status": "scheduled"
  }
  ```
</ResponseExample>


## OpenAPI

````yaml POST /send
openapi: 3.1.0
info:
  title: Byteport API
  description: >-
    The Byteport API lets you move, share, and manage files across every storage
    location connected to your workspace through a single HTTP interface.
  version: 1.0.0
servers:
  - url: https://api.byteport.com
security:
  - bearerAuth: []
paths:
  /send:
    post:
      summary: Send
      description: Send a file by email to one or more recipients.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - source
                - to
              properties:
                source:
                  type: string
                  description: Filename to share.
                to:
                  description: Recipient email address. Max 50.
                  oneOf:
                    - type: string
                      format: email
                    - type: array
                      items:
                        type: string
                        format: email
                      maxItems: 50
                bcc:
                  description: Bcc recipient email address(es).
                  oneOf:
                    - type: string
                      format: email
                    - type: array
                      items:
                        type: string
                        format: email
                cc:
                  description: Cc recipient email address(es).
                  oneOf:
                    - type: string
                      format: email
                    - type: array
                      items:
                        type: string
                        format: email
                scheduledAt:
                  type: string
                  description: >-
                    Schedule the email to be sent later. Accepts natural
                    language (e.g. `in 1 min`) or ISO 8601.
                replyTo:
                  description: Reply-to email address(es).
                  oneOf:
                    - type: string
                      format: email
                    - type: array
                      items:
                        type: string
                        format: email
                text:
                  type: string
                  description: Text to include alongside the file.
                password:
                  type: string
                  description: Password required to unlock the sent file.
      responses:
        '200':
          description: Email scheduled
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  status:
                    type: string
                    enum:
                      - queued
                      - sent
                      - scheduled
        '400':
          $ref: '#/components/responses/Error'
components:
  responses:
    Error:
      description: Unexpected error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Error:
      type: object
      required:
        - error
        - message
      properties:
        error:
          type: integer
        message:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````