POSThttps://app.evoriqa.com/api/v1/conversations/bulk-status

Bulk-set conversation status

Sets the status of up to 200 conversations in one call. Ids outside the workspace are skipped rather than errored; over 200, or an unknown status, is 422.

Requires scope conversations:write

Access is gated — enable it before your first call

The API is off by default. A request succeeds only when all three switches are on: the platform master switch (off by default), your organisation’s API toggle, and your plan or client entitlement. Any one off returns 403 API access is not enabled for this workspace.

Request body

Content type: application/json

Field	Type	Required	Description
ids	array 1–200 items	Required	Conversation ids.
status	string one of `open` · `closed` · `spam` · `archived`	Required	Target status.

Request

curl

curl -X POST "https://app.evoriqa.com/api/v1/conversations/bulk-status" \
  -H "x-api-key: $EVORIQA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "ids": [ "8c1e4f2a-7b3d-4e91-a2f6-6d1c9b0e4a55" ], "status": "closed" }'

Node.js

const res = await fetch("https://app.evoriqa.com/api/v1/conversations/bulk-status", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.EVORIQA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "ids": [
      "8c1e4f2a-7b3d-4e91-a2f6-6d1c9b0e4a55"
    ],
    "status": "closed"
  }),
});

const responseBody = await res.json();

Python

import os
import requests

res = requests.post(
    "https://app.evoriqa.com/api/v1/conversations/bulk-status",
    headers={"Authorization": f"Bearer {os.environ['EVORIQA_API_KEY']}"},
    json={
      "ids": [
        "8c1e4f2a-7b3d-4e91-a2f6-6d1c9b0e4a55"
      ],
      "status": "closed"
    },
)

body = res.json()

Response

200 OK

{
  "success": true,
  "data": {
    "updated": 1
  }
}