---
title: "Provision default rooms for an app (v2, tenant actor)"
method: POST
path: "/v2/apps/{appId}/provision"
tags: ["Apps"]
---

# Provision default rooms for an app (v2, tenant actor)

`POST /v2/apps/{appId}/provision`

## Request

- Base URL: `https://api.chat.ethora.com`
- URL: `https://api.chat.ethora.com/v2/apps/{appId}/provision`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

**Auth**: Tenant Actor

Creates default/pinned rooms for an app (best-effort XMPP room creation).
Supports `User JWT` and `B2B Server JWT`.

## Path parameters

- `appId` string, required

## Request body

- object
  - `rooms` object[]: Array of `{ name, title, pinned? }` describing default rooms to create for the app. Each entry results in one Mongo Chat row + one MUC room on the XMPP server.
    - `title` string, required
    - `pinned` boolean

## Response `200`

ok

- AppProvisionResponse
  - `ok` boolean, required
  - `appId` string, required
  - `summary` BatchSummary, required
    - `requested` integer, required: How many items the client requested to process.
    - `byStatus` object, required
  - `details` AppProvisionRoomDetail[], required
    - `title` string, nullable
    - `pinned` boolean
    - `status` string
    - `code` string, nullable
    - `error` string, nullable
    - `room` object, nullable

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

[API](https://skmtc.dev/ethora/apis/platform-api.md) · [All operations](https://skmtc.dev/ethora/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ethora/apis/platform-api/revisions/01b6e64378ee?raw)