---
title: "POST /orgs/{org_id}/files"
method: POST
path: "/orgs/{org_id}/files"
tags: ["files"]
---

# POST /orgs/{org_id}/files

`POST /orgs/{org_id}/files`

Upload a file to an org

## Path parameters

- `org_id` string, required

## Response `200`

File uploaded successfully

- File
  - `content_length` integer, required — The content length of the file in bytes
  - `content_type` string, required — The content type of the file
  - `created_at` string, date-time, required — The time the file was created
  - `expires_at` string, date-time, nullable — The time the file expires at
  - `id` integer, required — Unique identifier for the file
  - `name` string, required — The name of the file
  - `url` string, required — The URL where the file can be accessed

## Changes

- **2026-03-16** `eb2c08128881` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/timbal-ai/apis/timbal-platform-api/changes/orgs/:org_id/files/post.md)

---

[API](https://skmtc.dev/timbal-ai/apis/timbal-platform-api.md) · [All operations](https://skmtc.dev/timbal-ai/apis/timbal-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/timbal-ai/apis/timbal-platform-api/revisions/2cc5b6df52cc?raw)