---
title: "Upload asset file"
method: POST
path: "/v2/upload/asset"
tags: ["Asset"]
---

# Upload asset file

`POST /v2/upload/asset`

Upload an asset file and get signed URL for direct upload to cloud storage.
Use the returned sign_url to upload your file with a PUT request.

## Request body

- object
  - `filename` string, required — Name of the file to upload
  - `content_type` string, required — MIME type of the file
  - `file_size` integer — File size in bytes (optional)

## Response `200`

Success

- object
  - `code` integer, required — Business status code: * 0 - Success * 10104 - Record not found * 10105 - Invalid API key * 18020 - Insufficient credit * 18025 - No permission to call APIs * 40000 - Parameter error * 50000 - System error
  - `msg` string, required — Response message
  - `data` object
    - `sign_url` string, uri — Signed URL for file upload
    - `asset_url` string, uri — Asset URL after upload

---

[API](https://skmtc.net/jogg/apis/joggai-openapi-v2.md) · [All operations](https://skmtc.net/jogg/apis/joggai-openapi-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jogg/joggai-openapi-v2/versions/ec8807ce9c12/schema)