---
title: "Upload File"
method: POST
path: "/api/v0/pipeline/file"
tags: ["Pipeline"]
---

# Upload File

`POST /api/v0/pipeline/file`

## Request

- Base URL: `https://api.oneai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.oneai.com/api/v0/pipeline/file`
- Auth: API key in header `api-key`

## Query parameters

- `pipeline` string, json-string

## Headers

- `api-key` string, required

## Response `200`

Successful Response

- union
  - PipelineOutput
    - `input_text` string: Input text
    - `input` unknown[]: Input
      - unknown
    - `status` 'success' | 'failure', required: An enumeration.
    - `error` string: Error message
    - `output` OutputBlock[]: Output blocks
      - `text_generated_by_step_name` string, required: Generating step name
      - `text_generated_by_step_id` integer, required: Generating step ID
      - `text` string: Output text
      - `contents` unknown[]: Contents
        - unknown
      - `labels` Label[]: Labels
        - `type` string: Label type
        - `skill` string: Label type
        - `name` string: Label name
        - `value` unknown
        - `speaker` string: Speaker
        - `data` object: Optional data
        - `span_text` string: Span text
        - `span` integer[]
        - `output_spans` OutputSpan[]: Utterance spans
          - `section` integer, required: Utterance index
          - `start` integer, required: Start position
          - `end` integer, required: End position
        - `origin` string: Origin value
        - `input_spans` OutputSpan[]: Origin utterance spans
          - `section` integer, required: Utterance index
          - `start` integer, required: Start position
          - `end` integer, required: End position
        - `timestamp` string: Span timestamp
        - `timestamp_end` string: Span timestamp end
    - `warnings` object: List of warning
    - `stats` JobStatistics
      - `concurrency_wait_time` number, required: Time spent waiting for free execution slot
  - PipelineBatchOutput
    - `stats` JobStatistics
      - `concurrency_wait_time` number, required: Time spent waiting for free execution slot
    - `outputs` PipelineOutputBase[], required: Pipeline outputs
      - `input_text` string: Input text
      - `input` unknown[]: Input
        - unknown
      - `status` 'success' | 'failure', required: An enumeration.
      - `error` string: Error message
      - `output` OutputBlock[]: Output blocks
        - `text_generated_by_step_name` string, required: Generating step name
        - `text_generated_by_step_id` integer, required: Generating step ID
        - `text` string: Output text
        - `contents` unknown[]: Contents
          - unknown
        - `labels` Label[]: Labels
          - `type` string: Label type
          - `skill` string: Label type
          - `name` string: Label name
          - `value` unknown
          - `speaker` string: Speaker
          - `data` object: Optional data
          - `span_text` string: Span text
          - `span` integer[]
          - `output_spans` OutputSpan[]: Utterance spans
            - `section` integer, required: Utterance index
            - `start` integer, required: Start position
            - `end` integer, required: End position
          - `origin` string: Origin value
          - `input_spans` OutputSpan[]: Origin utterance spans
            - `section` integer, required: Utterance index
            - `start` integer, required: Start position
            - `end` integer, required: End position
          - `timestamp` string: Span timestamp
          - `timestamp_end` string: Span timestamp end
      - `warnings` object: List of warning
    - `warnings` object: List of warning

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/oneai/apis/oneai-api.md) · [All operations](https://skmtc.dev/oneai/apis/oneai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/oneai/apis/oneai-api/revisions/01f0b42c0220?raw)