> ## 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.

# Update Entity

> Update an entity's content and metadata

Updates the fields of an existing entity. Only the fields you include in the request body are updated — omitted fields are left unchanged. Only the entity's author, or a request with a service or master key, can update an entity.

**Authentication required.**

## Path Parameters

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

## Body Parameters

<ParamField body="title" type="string">
  New title for the entity.
</ParamField>

<ParamField body="content" type="string">
  New content body for the entity.
</ParamField>

<ParamField body="attachments" type="object[]">
  Replaces the entity's `attachments` array with the provided value.
</ParamField>

<ParamField body="keywords" type="string[]">
  Replaces the entity's `keywords` array.
</ParamField>

<ParamField body="mentions" type="object[]">
  Replaces the entity's `mentions` array. Each item is:

  * `{ type: "user", id: string, username: string, foreignId?: string }`
  * `{ type: "space", id: string, slug: string }`
</ParamField>

<ParamField body="location" type="object">
  New geographic coordinates:

  ```json theme={null}
  { "latitude": 40.7128, "longitude": -74.0060 }
  ```
</ParamField>

<ParamField body="metadata" type="object">
  Replaces the entity's `metadata` object entirely.
</ParamField>

## Response

Returns the updated [Entity](/data-models/entity) object, populated with the author's user profile.

<Note>
  If `title` or `content` changed, the entity's semantic search embeddings are automatically re-queued for projects with AI search enabled.
</Note>

## Error Responses

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

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