Media

React to the specified media item

Changed on Mar 18, 2026

React to the specified media item.

post/media/{id}/react

Request

Base URL
https://example.com/api
Auth
- OAuth 2
  Authorization codehttps://example.com/oauth2/authorize
  Token URLhttps://example.com/api/oauth2/token
  Scopesmedia:write
- or API key in header XF-Api-Key
TypeScript
https://skmtc.dev/xenforo-ltd/apis/xenforo-api/docs/media/:id/react/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body application/x-www-form-urlencoded

reaction_idinteger required

ID of the reaction to use. Use the current reaction ID to undo.

Response

OK

successboolean

actionstring

"insert" or "delete" based on whether the reaction was added or removed.

Changes

Mar 18, 2026e271d0e41f6d Revision changes
- breaking
  request body became required
- breaking
  removed the media type application/json from the request body
- breaking
  the response's property type changed from string to boolean for status
- warning
  deleted the path request parameter id
- info
  api operation id post_media_id_react removed and replaced with postMediaIdReact
- info
  the endpoint scheme security XF-Api-Key was added to the API
- info
  the endpoint scheme security XF-OAuth2 was added to the API
- info
  added the new optional header request parameter XF-Api-User to all path's operations
- info
  added the new optional query request parameter api_bypass_permissions to all path's operations
Mar 6, 20260f490cfb7931 Revision changes
- info
  api tag Media added
- info
  api tag media removed
- info
  added optional request body
- info
  added the media type application/json for the response with the status

Operation history (4 revisions)