---
title: "Update an engagement"
method: PATCH
path: "/engagements/{id}"
tags: ["Engagements"]
---

# Update an engagement

`PATCH /engagements/{id}`

Update an existing engagement's copy, delay, profile, or reaction type.

**Validation rules:**
- `copy` cannot be updated for Like engagements
- `copy` cannot be removed from Comment engagements (must have content)
- `delaySeconds` cannot be updated for Like engagements
- `reactionType` can only be updated for Like engagements on LinkedIn
- When changing `profileId`, the new profile must have the required engagement permissions
- Cannot update engagements for posts that have already been published
- Only one Like engagement per profile is allowed (cannot change profileId to a profile that already has a Like)

## Path parameters

- `id` string, uuid, required

## Request body

- UpdateEngagementInput — All fields are optional. Only include the fields you want to update.
  - `copy` string, nullable — The text content. Cannot be updated for Like engagements. Cannot be removed from Comment engagements. Set to null to remove copy from Repost engagements.
  - `delaySeconds` integer, nullable — Delay in seconds after the post publishes. Accepts any integer from 0 to 86400 (24 hours). Cannot be updated for Like engagements.
  - `profileId` string, uuid — Change the profile that will perform the engagement. The new profile must have the required engagement permissions.
  - `reactionType` 'Like' | 'Celebrate' | 'Love' | 'Insightful' | 'Support' | 'Funny' — LinkedIn reaction type for Like engagements. Only applicable when type is Like and channel is LinkedIn. Defaults to Like if not specified.

## Response `200`

Engagement updated

- object
  - `engagement` EngagementResponse — Engagement object returned from update operations (without channel)
    - `id` string, uuid
    - `type` 'Like' | 'Comment' | 'Repost'
    - `profileId` string, uuid — The profile ID that will perform the engagement
    - `copy` string, nullable — The text content for Comment or Repost engagements
    - `delaySeconds` integer — Delay in seconds after post publishes
    - `reactionType` 'Like' | 'Celebrate' | 'Love' | 'Insightful' | 'Support' | 'Funny' — LinkedIn reaction type for Like engagements. Only applicable when type is Like and channel is LinkedIn. Defaults to Like if not specified.

## Other responses

- `400` — Bad Request - Invalid input parameters
- `401` — Unauthorized - Missing or invalid API key
- `404` — Not Found - Resource does not exist

---

[API](https://skmtc.net/tryordinal/apis/ordinal-api.md) · [All operations](https://skmtc.net/tryordinal/apis/ordinal-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tryordinal/ordinal-api/revisions/1d0792ff454f/schema)