---
title: "Apply action on conversation list"
method: POST
path: "/api/v1/conversation/action/list"
tags: ["Conversation"]
---

# Apply action on conversation list

`POST /api/v1/conversation/action/list`

## Request

- Base URL: `https://api.intheloop.io`
- URL: `https://api.intheloop.io/api/v1/conversation/action/list`
- Auth: API key in header `Authorization`

## Query parameters

- `forceAction` boolean

## Headers

- `Authorization` string
- `X-Impersonate-User` string

## Request body

- UpdateRequestBase: Conversation list update request base Possible types: ConversationSearchUpdateRequest, ConversationListUpdateRequest
  - `action` 'MarkAsRead' | 'MarkAsUnread' | 'MarkAsStarred' | 'MarkAsUnstarred' | 'Archive' | 'Delete' | 'MoveToInbox' | 'MoveToFolder' | 'MarkAsReadForAllUsers' | 'Follow' | 'UnFollow' | 'ChangeLabels' | 'ChangePrivateLabels' | 'ChangeClassification' | 'ChangeCategory' | 'Snooze' | 'SnoozeDiscard' | 'MarkAsJunk' | 'CloseConversation' | 'PinComment' | 'UnpinComment' | 'Purge' | 'UnPurge' | 'DeleteComment', required: Possible Action Types
  - `actionDescription` string: Conversation action description
  - `fromContext` ContextType: Context type
    - `context` 'Archive' | 'Delete' | 'Inbox' | 'Folder', required: Possible Context Types
    - `folderId` string: shared folder id if context type is Folder
  - `sharedActionContext` boolean, required: Conversation action context (private triaging) - if you delete conversation from group - context is shared - from loop inbox is non shared
  - `actionDate` string, date-time: Action date (for offline action - prevent executing action on new items)
  - `$type` string, required

## Response `204`

No Content

## Other responses

- `400`: Bad request. Check fields message and error code from response body for additional information.
- `401`: Unauthorized request. Check fields message and error code from response body for additional information.
- `429`: Too many requests. Check response header Retry-After indicating how long to wait before making a new request.
- `451`: Unavailable because account is not verified.

---

[API](https://skmtc.dev/intheloop/apis/loop-api.md) - [All operations](https://skmtc.dev/intheloop/apis/loop-api/llms.txt) - [OpenAPI document](https://skmtc.dev/intheloop/apis/loop-api/revisions/0892c5ba0787?raw)