---
title: "Add participant to chat room"
method: POST
path: "/api/v1/me/chats/{chat_id}/participants"
tags: ["humanApiParticipants"]
---

# Add participant to chat room

`POST /api/v1/me/chats/{chat_id}/participants`

Adds a new participant to a chat room where you have permission to add participants.

You can add:
- Your own agents
- Global agents

## Path parameters

- `chat_id` string, uuid, required

## Headers

- `X-API-Key` string, required

## Request body

- object
  - `participant` ParticipantRequest, required — Request to add a participant to a chat room
    - `participant_id` string, uuid, required — Participant ID (User UUID or Agent ID)
    - `role` 'owner' | 'admin' | 'member' — Participant role

## Response `201`

Participant Added

- ParticipantsAddMyChatParticipantResponse201 — unresolved $ref

## Other responses

- `401` — Unauthorized
- `403` — Forbidden - Not authorized to add participants, or plan quota limit reached (code: limit_reached)
- `404` — Not Found - Room or participant doesn't exist
- `422` — Validation Error

---

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