---
title: "Publish the document to Community, or save its listing (signed-in owner; not a team document, not password protected)."
method: PUT
path: "/documents/{id}/community"
tags: ["Community"]
---

# Publish the document to Community, or save its listing (signed-in owner; not a team document, not password protected).

`PUT /documents/{id}/community`

## Request

- Base URL: `https://www.livediagram.app/api`
- URL: `https://www.livediagram.app/api/documents/{id}/community`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Request body

- CommunityPostInput
  - `anonymous` boolean, required
  - `category` 'architecture' | 'flows' | 'planning' | 'workshops' | 'mindmaps' | 'design' | 'data' | 'learning' | 'infographics' | 'art' | 'other', required
  - `description` string, required
  - `tags` string[], required
  - `title` string, required

## Response `200`

Success.

- object
  - `post` CommunityOwnPost, required
    - `anonymous` boolean, required
    - `author` CommunityAuthor, required
      - `color` string, required
      - `name` string, required
      - `picture` string, nullable, required
    - `category` 'architecture' | 'flows' | 'planning' | 'workshops' | 'mindmaps' | 'design' | 'data' | 'learning' | 'infographics' | 'art' | 'other', required
    - `copyCount` number, required
    - `description` string, required
    - `id` string, required
    - `likeCount` number, required
    - `liked` boolean, required
    - `publishedAt` number, required
    - `shareCode` string, required
    - `state` 'listed' | 'hidden', required
    - `tags` string[], required
    - `title` string, required
    - `updatedAt` number, required

## Other responses

- `201`: Error.
- `400`: Error.
- `401`: Error.
- `403`: Error.
- `404`: Error.
- `409`: Error.
- `410`: Error.
- `429`: Rate limited. Back off and retry.

---

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