React to a post

Módulo Workforce

POST/feed-posts/{id}/reactfeedPosts.react

Adds or removes the caller's reaction from the curated set. Requires `Idempotency-Key`; a replay returns the original response. A rule that refuses the request returns 422 with `refusal` and `reason`.

Requiere la capacidad knowledge.sop.acknowledge.
Alcances de OAuth: knowledge.
Envía el encabezado Idempotency-Key. Una repetición con la misma clave devuelve la respuesta original.
Estados de error: 400, 401, 404, 409, 422, 429. Los errores son detalles de problema RFC 9457.

Parámetros de ruta y de consulta

feedPosts.react: Parámetros de ruta y de consulta
Campo	Tipo	Obligatorio	Descripción
id	string (uuid)	Sí	Identifier of the feed post.

Cuerpo de la solicitud: FeedReactionRequest

feedPosts.react: FeedReactionRequest
Campo	Tipo	Obligatorio	Descripción
reaction_code	"thumbs_up" \| "heart" \| "check" \| "eyes" \| "laugh" \| "celebrate"	Sí	Reaction.
on	boolean	No	Add (default) or remove.

{
  "reaction_code": "heart",
  "on": true
}

Respuesta 200: FeedPost

feedPosts.react: FeedPost
Campo	Tipo	Obligatorio	Descripción
id	string (uuid)	Sí	Identifier of the feed post.
org_id	string (uuid)	Sí	Identifier of the owning organization, derived from the parent row and never accepted from the caller.
created_at	string (date-time)	Sí	When the row was created.
created_by	string (uuid) \| null	Sí	Person who created the row; null for seed, platform or system writes.
updated_at	string (date-time)	Sí	When the row was last updated.
updated_by	string (uuid) \| null	Sí	Person who last updated the row; null for seed, platform or system writes.
post_kind	"Announcement" \| "Update" \| "Poll" \| "Recognition"	Sí	Post kind; Poll posts come from the createPoll action, Recognition posts from recognitions.
title	string \| null	Sí	Optional headline.Restricciones: length 1 to 200
body	string	Sí	Post text.Restricciones: length 1 to 10000
audience_kind	"Organization" \| "Project" \| "Team" \| "Department" \| "Role" \| "Group"	Sí	Who the row reaches. Department (a canon department, 1365) is for feed posts only.
project_id	string (uuid) \| null	Sí	Identifier of the project audience, or the project the row belongs to.
team_id	string (uuid) \| null	Sí	Identifier of the team audience.
role_id	string (uuid) \| null	Sí	Identifier of the org role audience.
group_id	string (uuid) \| null	Sí	Identifier of the group audience, including department groups.
department_code	string \| null	Sí	Canon department code of a Department audience (xpms.dim_department).Restricciones: pattern ^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$
author_membership_id	string (uuid) \| null	Sí	Identifier of the member who wrote the post.
pinned_at	string (date-time) \| null	Sí	When the post was pinned; null when not pinned.
requires_acknowledgment	boolean	Sí	Whether every member of the audience must acknowledge it.
reactions_enabled	boolean	Sí	Whether members can react.
comments_enabled	boolean	Sí	Whether members can comment.
publish_at	string (date-time)	Sí	When the post appears; a future time schedules it.
notified_at	string (date-time) \| null	Sí	When the audience was notified.
hidden_at	string (date-time) \| null	Sí	When the post was hidden.
hidden_reason	string \| null	Sí	Why it was hidden.Restricciones: length 1 to 500

{
  "id": "0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f",
  "org_id": "0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f",
  "created_at": "2026-10-08T14:30:00Z",
  "created_by": "0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f",
  "updated_at": "2026-10-08T14:30:00Z",
  "updated_by": "0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f",
  "post_kind": "Announcement",
  "title": "Wristband change",
  "body": "Wristbands change color on Friday.",
  "audience_kind": "Organization",
  "project_id": "0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f",
  "team_id": "0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f",
  "role_id": "0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f",
  "group_id": "0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f",
  "department_code": "5000",
  "author_membership_id": "0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f",
  "pinned_at": "2026-10-08T14:30:00Z",
  "requires_acknowledgment": false,
  "reactions_enabled": true,
  "comments_enabled": true,
  "publish_at": "2026-10-08T14:30:00Z",
  "notified_at": "2026-10-08T14:30:00Z",
  "hidden_at": "2026-10-08T14:30:00Z",
  "hidden_reason": "Posted to the wrong project."
}

Ejemplos de código

curl -X POST "$XOS_BASE_URL/feed-posts/0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f/react" \
  -H "Authorization: Bearer $XOS_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"reaction_code":"heart","on":true}'

const { data } = await xos.feedPosts.react("0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f", {
    "reaction_code": "heart",
    "on": true
  });

response = xos.feed_posts.react("0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f", {"reaction_code": "heart", "on": True})

xos feed-posts react 0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f --data '{"reaction_code":"heart","on":true}'