Update Entity

Update an entity’s content and metadata

PATCH /:projectId/api/v7/entities/:entityId

Update Entity

cURL

curl --request PATCH \
  --url https://api.replyke.com/api/v6/:projectId/api/v7/entities/:entityId \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "content": "<string>",
  "attachments": [
    {}
  ],
  "keywords": [
    "<string>"
  ],
  "mentions": [
    {}
  ],
  "location": {},
  "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

entityId · string · required

The UUID of the entity to update.

Body Parameters

title · string

New title for the entity.

content · string

New content body for the entity.

attachments · object[]

Replaces the entity’s attachments array with the provided value.

keywords · string[]

Replaces the entity’s keywords array.

mentions · object[]

Replaces the entity’s mentions array. Each item is:

• { type: "user", id: string, username: string, foreignId?: string }
• { type: "space", id: string, slug: string }

location · object

New geographic coordinates:

{ "latitude": 40.7128, "longitude": -74.0060 }

metadata · object

Replaces the entity’s metadata object entirely.

Response

Returns the updated Entity object, populated with the author’s user profile.

If title or content changed, the entity’s semantic search embeddings are automatically re-queued for projects with AI search enabled.

Error Responses

Not Found — 404

{ "error": "Entity not found.", "code": "entity/not-found" }

Unauthorized — 403

{ "error": "Not authorized to update this entity.", "code": "entity/not-authorized" }