---
title: "File Upload"
method: POST
path: "/v1/data-acquisition/agent/upload"
tags: ["Data Acquisition"]
---

# File Upload

`POST /v1/data-acquisition/agent/upload`

This endpoint uploads a file to TetraScience Cloud.  It requires a user-defined agent set up in the TetraScience Web UI.  API users can use it to upload, manage their files, and trigger pipelines.


Maximum payload size: 500MB

Validations performed by this endpoint:

1. `agentId` must be a valid ID of the user defined agent (UDA)
2. param `sourceType` must contain only lower case alphanumerical characters and dashes
3. params `metadata` and `tags` must contain only ASCII characters; `tags` values cannot contain comma and values must be unique
4. params `metadata` and `tags` together as JSON objects must have less than 1.5KB of text (1536 characters)

## Response `200`

200

- object
  - `type` string
  - `fileKey` string
  - `bucket` string
  - `version` string
  - `fileId` string

## Other responses

- `404` — 404
- `422` — 422

---

[API](https://skmtc.net/tetrascience/apis/tetra-data-lake.md) · [All operations](https://skmtc.net/tetrascience/apis/tetra-data-lake/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tetrascience/tetra-data-lake/versions/0205e2bace53/schema)