---
title: "POST /paas/v4/files"
method: POST
path: "/paas/v4/files"
---

# POST /paas/v4/files

`POST /paas/v4/files`

This API is designed for uploading auxiliary files (such as glossaries, terminology lists) to support the translation service. It allows users to upload reference materials that can enhance translation accuracy and consistency.

## Response `200`

Processing successful

- object
  - `id` string — Unique identifier of the uploaded file.
  - `object` string — Object type.
  - `bytes` integer — File size in bytes.
  - `filename` string — Name of the uploaded file.
  - `purpose` string — Purpose of the uploaded file.
  - `created_at` integer — Timestamp of file creation.

## Other responses

- `default` — The request has failed.

## Changes

> 5 revisions in range; 1 not diffed.

- **2026-08-28** `1269b1dce35d` — 2 info
  - the `purpose` request property default value changed from `agent` to `user_data`
  - added the new `user_data` enum value to the request property `purpose`

[Change history](https://skmtc.dev/z/apis/z-ai-api/changes/paas/v4/files/post.md)

---

[API](https://skmtc.dev/z/apis/z-ai-api.md) · [All operations](https://skmtc.dev/z/apis/z-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/z/z-ai-api/revisions/bde781ffff7e/schema)