# Upload File

**POST /v2/files**

Requests to upload one or more files to be used in an eval run.

Args:
    upload_request (FileUploadRequest): Contains the files to upload and the workspace UUID.

Returns:
    FileUploadResponse: Contains presigned URLs and metadata to  upload each file.

Raises:
    AymaraAPIError: If the organization is missing or file upload fails.

Example:
    POST /api/files
    {
        "workspace_uuid": "...",
        "files": [
            {"local_file_path": "path/to/file1.csv"},
            {"local_file_path": "path/to/file2.csv"}
        ]
    }


## Servers
- Production server (uses live data): https://api.aymara.ai (Production server (uses live data))
- Staging server (uses test data): https://staging-api.aymara.ai (Staging server (uses test data))


## Authentication methods
- Api key
- Auth bearer


## Parameters



### Body: application/json (object)

- **workspace_uuid** (string | null)
  UUID of the workspace to associate with the upload, if any.
- **files** (array[object])
  List of files to upload.


## Responses
### 200
OK

#### Body: application/json (object)
- **workspace_uuid** (string | null)
  UUID of the workspace associated with the upload, if any.
- **files** (array[object])
  List of results for each uploaded file.

### 400
Bad Request

#### Body: application/json (object)
- **error** (object)
  Schema for the contents of an error response.

  This schema defines the structure of the error data inside the `error` field
  of an API error response.
- **request_id** (string)


### 401
Unauthorized

#### Body: application/json (object)
- **error** (object)
  Schema for the contents of an error response.

  This schema defines the structure of the error data inside the `error` field
  of an API error response.
- **request_id** (string)


### 403
Forbidden

#### Body: application/json (object)
- **error** (object)
  Schema for the contents of an error response.

  This schema defines the structure of the error data inside the `error` field
  of an API error response.
- **request_id** (string)


### 404
Not Found

#### Body: application/json (object)
- **error** (object)
  Schema for the contents of an error response.

  This schema defines the structure of the error data inside the `error` field
  of an API error response.
- **request_id** (string)


### 409
Conflict

#### Body: application/json (object)
- **error** (object)
  Schema for the contents of an error response.

  This schema defines the structure of the error data inside the `error` field
  of an API error response.
- **request_id** (string)


### 422
Unprocessable Entity

#### Body: application/json (object)
- **error** (object)
  Schema for the contents of an error response.

  This schema defines the structure of the error data inside the `error` field
  of an API error response.
- **request_id** (string)


### 429
Too Many Requests

#### Body: application/json (object)
- **error** (object)
  Schema for the contents of an error response.

  This schema defines the structure of the error data inside the `error` field
  of an API error response.
- **request_id** (string)


### 500
Internal Server Error

#### Body: application/json (object)
- **error** (object)
  Schema for the contents of an error response.

  This schema defines the structure of the error data inside the `error` field
  of an API error response.
- **request_id** (string)


### 503
Service Unavailable

#### Body: application/json (object)
- **error** (object)
  Schema for the contents of an error response.

  This schema defines the structure of the error data inside the `error` field
  of an API error response.
- **request_id** (string)



[Powered by Bump.sh](https://bump.sh)