---
title: "Add a shared chat to the showcase"
method: POST
path: "/showcase"
tags: ["Showcase"]
---

# Add a shared chat to the showcase

`POST /showcase`

## Request

- Base URL: `https://h2ogpte.genai.h2o.ai/api/v1`
- URL: `https://h2ogpte.genai.h2o.ai/api/v1/showcase`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/h2o/apis/h2ogpte-rest-api/docs/showcase/post.ts> (a function with typed inputs; its response is checked against the schema)

Requires the `h2ogpte/chat/manage_showcase` permission. Private shared
chats may be pinned; their tiles are only listed to authenticated
callers.

## Request body

- AddShowcaseChatRequest
  - `shared_chat_id` string, required
  - `title` string, required: Required. Non-empty after trim.
  - `description` string, required: Required. Non-empty after trim.
  - `category` string: Optional free-text category used to group tiles in the listing.

## Response `201`

Successful operation

- AddShowcaseChatResponse
  - `id` string, required

## Other responses

- `400`: Bad request
- `401`: Unauthorized - Invalid or missing API key
- `403`: Forbidden
- `404`: Not found
- `409`: Conflict
- `default`: Unexpected error

---

[API](https://skmtc.dev/h2o/apis/h2ogpte-rest-api.md) - [All operations](https://skmtc.dev/h2o/apis/h2ogpte-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/h2o/apis/h2ogpte-rest-api/revisions/a82a117320f4?raw)