---
title: "Upload an image in a thread, on behalf of a user."
method: POST
path: "/chat/threads/{chatThreadId}/images"
tags: ["Images"]
---

# Upload an image in a thread, on behalf of a user.

`POST /chat/threads/{chatThreadId}/images`

## Path parameters

- `chatThreadId` string, required

## Query parameters

- `api-version` string, required

## Headers

- `image-filename` string

## Response `201`

Uploaded successfully, the `Location` header contains the URL for the newly uploaded image.

- UploadChatImageResult — Result payload for uploading an image.
  - `id` string, required — A server-generated image id.
  - `attachmentType` 'image' | 'file' — The type of attachment.
  - `name` string — The name including file extension type of the attachment.

## Other responses

- `default` — Error response describing why the operation failed.

## Changes

- **2026-07-13** `57a59d1b8530` — 1 info
  - endpoint added
- **2026-07-13** `9b1c53be48fd` — 1 breaking
  - api path removed without deprecation
- **2026-07-13** `b87541468cac` — 1 info
  - endpoint added
- **2021-05-19** `4c5323153682` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/azure/apis/communication-chat/changes/chat/threads/:chatThreadId/images/post.md)

---

[API](https://skmtc.dev/azure/apis/communication-chat.md) · [All operations](https://skmtc.dev/azure/apis/communication-chat/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/communication-chat/revisions/57a59d1b8530/schema)