---
title: "Upload Project assets"
method: POST
path: "/v2/project/assets"
tags: ["Project"]
---

# Upload Project assets

`POST /v2/project/assets`

Upload OpenType or TrueType fonts through a Project and make them available to Lottie translation workflows across its Organization. Each font is keyed by a normalized identity derived from its family, weight, and italic style (from the supplied `family` and `style`, or from the font metadata and file name). Re-uploading the same identity overwrites the existing asset, so complete retries after a `500` response are safe.

## Headers

- `gt-api-version` '2025-01-01.v0' | '2025-11-03.v1' | '2026-02-18.v1' | '2026-03-06.v1' — API contract version. Defaults to the oldest supported version.
- `gt-project-id` string — Target project ID. Required when authenticating with an organization API key; ignored with project-scoped API keys (the project is resolved from the key).

## Request body

- object
  - `assets` object[], required
    - `assetType` 'FONT', required
    - `content` string, required
    - `fileName` string, required
    - `family` string
    - `style` string

## Response `201`

Uploaded assets

- object
  - `assets` object[], required
    - `id` string, required
    - `assetKey` string, required
    - `fileName` string, required
  - `count` integer, required

## Other responses

- `400` — Request error
- `401` — Request error
- `403` — Request error
- `404` — Request error
- `413` — Request error
- `429` — Request error
- `500` — Request error

## Changes

- **2026-08-27** `367cd605d090` — 2 breaking, 19 info
  - the `assets/items/content` request property's minLength was increased from `0` to `1`
  - added the pattern `\.([tT][tT][fF]|[oO][tT][fF])$` to the request property `assets/items/fileName`
  - api operation id `uploadProjectAssets` removed and replaced with `uploadAssets`
  - the endpoint scheme security `BearerAuth` was added to the API
  - …17 more

[Change history](https://skmtc.dev/generaltranslation/apis/general-translation-api/changes/v2/project/assets/post.md)

---

[API](https://skmtc.dev/generaltranslation/apis/general-translation-api.md) · [All operations](https://skmtc.dev/generaltranslation/apis/general-translation-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/generaltranslation/general-translation-api/revisions/5f954204ea21/schema)