---
title: "上传用户头像"
method: POST
path: "/upload/avatar"
tags: ["文件上传"]
---

# 上传用户头像

`POST /upload/avatar`

上传用户头像图片，仅支持PNG和JPEG格式，最大2MB

## Response `200`

上传成功

- object
  - `code` integer
  - `data` object
    - `url` string
  - `msg` string

## Other responses

- `400` — 请求参数错误
- `401` — 用户未登录
- `413` — 文件过大
- `415` — 文件类型不支持
- `500` — 服务器内部错误

## Changes

- **2025-10-22** `dcdf027169a3` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/oneclickvirt/apis/oneclickvirt-api/changes/upload/avatar/post.md)

---

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