> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replyke.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Publish Entity

> Publish a draft entity, making it publicly visible

Publishes a draft entity. After publishing, the entity appears in normal feeds and is visible to all users. The entity's `isDraft` field is set to `false` and `createdAt` is reset to the current time.

**Authentication required.** Only the entity's author, or a request with a service or master key, can publish a draft.

## Path Parameters

<ParamField path="entityId" type="string" required>
  The UUID of the draft entity to publish.
</ParamField>

## Response

Returns the published [Entity](/data-models/entity) object with `isDraft: false`.

<Note>
  Publishing resets `createdAt` to the current time, so the entity appears as "new" in chronological feeds regardless of when the draft was created.
</Note>

<Note>
  Mention notifications are sent when publishing, not when the draft is created. Users mentioned in the entity receive notifications at publish time.
</Note>

## Error Responses

<AccordionGroup>
  <Accordion title="Not Found — 404">
    ```json theme={null}
    { "error": "Draft entity not found", "code": "entity/not-found" }
    ```

    Returned when no draft with this ID exists (or the entity is not a draft).
  </Accordion>

  <Accordion title="Unauthorized — 403">
    ```json theme={null}
    { "error": "Not authorized to publish this draft.", "code": "entity/unauthorized" }
    ```
  </Accordion>
</AccordionGroup>