---
title: "Share a snapshot of a reusable roster view"
method: POST
path: "/v2/roster/views/{viewId}/share"
tags: ["Roster Builder"]
---

# Share a snapshot of a reusable roster view

`POST /v2/roster/views/{viewId}/share`

## Request

- Base URL: `https://api.clashk.ing`
- URL: `https://api.clashk.ing/v2/roster/views/{viewId}/share`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
- TypeScript: <https://skmtc.dev/clashk/apis/clashking-api/docs/v2/roster/views/:viewId/share/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `viewId` string, required

## Query parameters

- `server_id` string, required

## Response `201`

Success

- object
  - `shareId` string, required
  - `name` string, required
  - `description` string
  - `sharedAt` string, required
  - `sharedBy` object, required
    - `id` string, required
    - `name` string, required
    - `avatarUrl` string, nullable, required
  - `sourceServer` object, required
    - `id` string, required
    - `name` string, required
    - `iconUrl` string, nullable, required

## Changes

- **2026-11-07** `bd2893f46c35`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/clashk/apis/clashking-api/changes/v2/roster/views/:viewId/share/post.md)

---

[API](https://skmtc.dev/clashk/apis/clashking-api.md) - [All operations](https://skmtc.dev/clashk/apis/clashking-api/llms.txt) - [OpenAPI document](https://skmtc.dev/clashk/apis/clashking-api/revisions/41ffee7f4263?raw)