---
title: "Upload a file"
method: POST
path: "/workspaces/{workspace_id}/documents/file-upload"
tags: ["Workspace Documents"]
---

# Upload a file

`POST /workspaces/{workspace_id}/documents/file-upload`

## Path parameters

- `workspace_id` string, required

## Request body

- FileUploadRequest
  - `fileName` string, required

## Response `200`

response

- union
  - object
    - `ok` boolean
    - `data` FileUploadResponse
      - `url` string
      - `fields` object
  - Error
    - `error` boolean
    - `message` string[]

---

[API](https://skmtc.net/aws-samples/apis/gaia-rest-api.md) · [All operations](https://skmtc.net/aws-samples/apis/gaia-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws-samples/gaia-rest-api/revisions/c61f71119116/schema)