---
title: "Remove reaction"
method: DELETE
path: "/messages/{messageId}/reactions"
tags: ["Messages"]
---

# Remove reaction

`DELETE /messages/{messageId}/reactions`

## Request

- Base URL: `https://inboxapp.com/api/v2`
- URL: `https://inboxapp.com/api/v2/messages/{messageId}/reactions`
- Auth: HTTP bearer

## Path parameters

- `messageId` string, required

## Query parameters

- `emoji` string, required: Exactly one emoji.

## Response `200`

OK

- Reactions
  - `reactions` Reaction[], required
    - `emoji` string, required
    - `author` union, required
      - object: The team's account link reacted.
        - `type` 'accountLink', required
        - `accountLinkId` string, required: An account link: a platform account the team connected to Inboxapp, the team's side of a conversation.
        - `accountLink` AccountLink: A platform account the team connected to Inboxapp. Every conversation and message goes through one.
          - `id` string, required
          - `platform` string, required: The platform. Every team can use twitter, linkedin; a team may have others enabled.
          - `platformId` string, required: The ID the platform gives this object. Only meaningful next to its `platform`.
          - `username` string, nullable, required: The platform username, without a display prefix such as `@`.
          - `displayName` string, nullable, required
          - `avatarUrl` string, nullable, required
          - `status` 'active' | 'offline' | 'paused', required: `active` sends and syncs. `paused` is stopped for the reasons in `pauseReasons`, and resumes once none remain. `offline` lost its connection to the platform and must be reconnected in Inboxapp.
          - `pauseReasons` string[], required: Why the account link is paused. New reasons may be added.
          - `capabilities` string[], required: What this account can do: its platform's capabilities, narrowed for this account. An operation it lacks fails with `capabilityNotSupported`.
          - `syncedAt` string, date-time, nullable, required: When Inboxapp finished importing the account's conversations. Null until then.
          - `createdAt` string, date-time, required
      - object: The other side of the conversation reacted.
        - `type` 'profile', required
        - `profileId` string, required: A profile: one person's account on one platform. Not a contact ID.
        - `contactId` string, nullable, required: A contact: the team's record of the person, with their status, tags, notes, valuation and default assignee.
        - `profile` Profile: One person's account on one platform. Profile data is shared across teams; the team's own data about the person is on their contact.
          - `id` string, required
          - `platform` string, required: The platform. Every team can use twitter, linkedin; a team may have others enabled.
          - `platformId` string, required: The ID the platform gives this object. Only meaningful next to its `platform`.
          - `username` string, required: The platform username, without a display prefix such as `@`.
          - `handle` string, required: The username as the platform displays it. Show this, and look up by `username`.
          - `displayName` string, required
          - `avatarUrl` string, nullable, required
          - `bio` string, nullable, required
          - `location` string, nullable, required
          - `websiteUrl` string, nullable, required
          - `websiteDomain` string, nullable, required
          - `verified` boolean, required: The platform vouches for the account, such as with an X badge. Platform-specific badges are in `platformData`.
          - `isOrganization` boolean, required: A company or page rather than a person.
          - `isProtected` boolean, required: The account's posts are visible only to approved followers.
          - `followerCount` union, required
            - number
            - 'Infinity' | '-Infinity' | 'NaN'
          - `followingCount` union, required
            - number
            - 'Infinity' | '-Infinity' | 'NaN'
          - `postCount` union, required
            - number
            - 'Infinity' | '-Infinity' | 'NaN'
          - `engagementCount` union, required: On X, how many posts the user has liked.
            - number
            - 'Infinity' | '-Infinity' | 'NaN'
          - `listedCount` union, required: On X, how many lists include the profile.
            - number
            - 'Infinity' | '-Infinity' | 'NaN'
          - `accountStatus` 'active' | 'suspended' | 'notFound', required: `suspended` by the platform, or `notFound` when deleted or deactivated.
          - `platformCreatedAt` string, date-time, nullable, required: When the account was created on the platform.
          - `profileUrl` string, nullable, required
          - `updatedAt` string, date-time, required: When Inboxapp last stored a change to this profile.
          - `platformData` union, required: Fields only one platform has, tagged by `_tag`. Ignore tags you don't know.
            - object
              - …
            - object
              - …
            - object: A platform the team has enabled beyond those every team can use. Its fields are not listed here.
              - …
          - `relationships` Relationship[], required: One entry per team account link that has interacted with the profile.
            - `accountLinkId` string, required
            - `degree` 'self' | 'first' | 'second' | 'third' | 'outOfNetwork', nullable, required: How close the profile is to the account link on the platform's network, as last observed. `null` when never observed.
            - `connectionRequest` object, nullable, required: The account link's pending connection request. `null` once the profile is seen accepting it or the request is withdrawn, or when none was sent.
              - …
        - `contact` Contact: The team's record of a person: their profiles, plus the team's CRM state about them.
          - `id` string, required
          - `profiles` Profile[], required: The person's profiles, oldest link first. Profiles on platforms unavailable to the team are left out.
            - `id` string, required
            - `platform` string, required: The platform. Every team can use twitter, linkedin; a team may have others enabled.
            - `platformId` string, required: The ID the platform gives this object. Only meaningful next to its `platform`.
            - `username` string, required: The platform username, without a display prefix such as `@`.
            - `handle` string, required: The username as the platform displays it. Show this, and look up by `username`.
            - `displayName` string, required
            - `avatarUrl` string, nullable, required
            - `bio` string, nullable, required
            - `location` string, nullable, required
            - `websiteUrl` string, nullable, required
            - `websiteDomain` string, nullable, required
            - `verified` boolean, required: The platform vouches for the account, such as with an X badge. Platform-specific badges are in `platformData`.
            - `isOrganization` boolean, required: A company or page rather than a person.
            - `isProtected` boolean, required: The account's posts are visible only to approved followers.
            - `followerCount` union, required
              - …
            - `followingCount` union, required
              - …
            - `postCount` union, required
              - …
            - `engagementCount` union, required: On X, how many posts the user has liked.
              - …
            - `listedCount` union, required: On X, how many lists include the profile.
              - …
            - `accountStatus` 'active' | 'suspended' | 'notFound', required: `suspended` by the platform, or `notFound` when deleted or deactivated.
            - `platformCreatedAt` string, date-time, nullable, required: When the account was created on the platform.
            - `profileUrl` string, nullable, required
            - `updatedAt` string, date-time, required: When Inboxapp last stored a change to this profile.
            - `platformData` union, required: Fields only one platform has, tagged by `_tag`. Ignore tags you don't know.
              - …
            - `relationships` Relationship[], required: One entry per team account link that has interacted with the profile.
              - …
          - `statusId` string, nullable, required: A status: a pipeline stage on the team's board.
          - `tagIds` string[], required
          - `notes` string, nullable, required
          - `valuation` union, required: What the person is worth to the team, in the team's `currency`.
            - number
            - 'Infinity' | '-Infinity' | 'NaN'
          - `assigneeId` string, nullable, required: A member: a person on the team.
          - `createdAt` string, date-time, required
          - `updatedAt` string, date-time, required
          - `status` Status: A pipeline stage on the team's board. A contact has at most one status.
            - `id` string, required
            - `name` string, required: Unique within the team, ignoring case and accents.
            - `color` string, nullable, required: A lowercase hex color.
            - `createdAt` string, date-time, required
          - `tags` Tag[]
            - `id` string, required
            - `name` string, required: Unique within the team, ignoring case and accents.
            - `color` string, required: A lowercase hex color.
          - `assignee` Member: A person on the team, who can be assigned threads and contacts.
            - `id` string, required: The member ID that `assigneeId` fields take.
            - `name` string, nullable, required
            - `email` string, required
            - `imageUrl` string, nullable, required
            - `role` 'owner' | 'admin' | 'user', required: `owner` and `admin` manage the team. A `user` can't change settings, billing or members.
            - `createdAt` string, date-time, required
      - object: Someone Inboxapp can't match to the account link or the thread's profile, such as another member of a group conversation. Expands to nothing.
        - `type` 'unknown', required
        - `platformId` string, required: The ID the platform gives this object. Only meaningful next to its `platform`.
    - `createdAt` string, date-time, nullable, required: Null when the platform reports no time.
  - `version` union, required
    - number
    - 'Infinity' | '-Infinity' | 'NaN'

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `422`: Unprocessable Entity
- `429`: Too Many Requests
- `500`: Internal Server Error
- `502`: Bad Gateway
- `503`: Service Unavailable

---

[API](https://skmtc.dev/inboxapp/apis/inboxapp-api.md) · [All operations](https://skmtc.dev/inboxapp/apis/inboxapp-api/llms.txt) · [OpenAPI document](https://skmtc.dev/inboxapp/apis/inboxapp-api/revisions/7f9bbf45e851?raw)
