---
title: "Upload file input"
method: POST
path: "/files"
tags: ["Files"]
---

# Upload file input

`POST /files`

## Request

- Base URL: `https://getrun.id/v1`
- URL: `https://getrun.id/v1/files`
- Auth: HTTP bearer

Mengunggah file (gambar referensi, audio, dsb.) untuk dipakai sebagai input task. File disimpan 7 hari.

## Headers

- `Idempotency-Key` string

## Response `201`

File tersimpan.

- FileObject
  - `id` string, required
  - `url` string, uri, required: URL managed storage — pakai ini sebagai nilai input task.
  - `content_type` string, required
  - `size_bytes` integer, required
  - `expires_at` string, date-time, required

## Other responses

- `default`: Error envelope standar.

---

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