Skip to content

Resolve a queue item

POST/v1/queue/{id}/resolveKey scope write

Resolves a review queue item by executing an action on its moderation: allow, reject or an action of your own. Send resolution for the two built-in outcomes, or action for any action key. The item is resolved only when the action's queue_behavior is resolve: an action that keeps the queue as it is, such as block_author, runs and leaves the item open.

Needs a key with the write scope. Authentication

curl https://api.useinfrared.com/v1/queue/qi_3mr0Fb23lDSkWuE29vDfTH/resolve \
  -H "Authorization: Bearer $INFRARED_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "resolution": "rejected",
    "note": "Phone number and a request to pay outside the platform."
  }'
200 OKResponse
{
  "object": "queue_item",
  "id": "qi_3mr0Fb23lDSkWuE29vDfTH",
  "project_id": "prj_0TBAgHGtdMketrbltGFHuk",
  "moderation_id": "mod_63ajou7C7QWp0VYZDPRRvY",
  "template_id": "tpl_64mYq4nD3NXNfu0gcdaMZa",
  "author_id": "aut_09rs1aKw1Rzu53E2C4ER7u",
  "state": "resolved",
  "priority": "urgent",
  "severity": "critical",
  "language": "en",
  "reason": "rule",
  "conflict": false,
  "resolution": "rejected",
  "assignee": null,
  "assigned_at": null,
  "sla_due_at": null,
  "resolved_by": null,
  "resolved_at": "2026-10-08T09:29:16.206Z",
  "reopened_at": null,
  "settled_by_case_id": null,
  "summary": {
    "type": "text",
    "author": {
      "id": "aut_09rs1aKw1Rzu53E2C4ER7u",
      "status": "enabled",
      "external_id": "user_1307",
      "trust_level": "new"
    },
    "scores": {
      "spam": 0,
      "sexual": 0,
      "illicit": 0.0038,
      "toxicity": 0,
      "violence": 0,
      "duplicate": 0,
      "gibberish": 0,
      "profanity": 0,
      "self_harm": 0,
      "watermark": 0,
      "screenshot": 0,
      "hate_speech": 0,
      "instructions": 0.8,
      "made_with_ai": 0,
      "image_quality": 0,
      "links_contact": 0.8,
      "personal_data": 0.75,
      "lookalike_characters": 0,
      "wordlist/competitors": 0.85,
      "guideline/no-off-site-deals": 1
    },
    "dry_run": false,
    "preview": "Road bike, 54 cm frame, serviced last month. I also list on Tradely. Text me on +44 7700 900142 and pay by bank transfer to skip the fees.",
    "language": "en",
    "severity": "critical",
    "template": "listing",
    "triggered": [
      "personal_data",
      "guideline/no-off-site-deals",
      "wordlist/competitors",
      "instructions"
    ],
    "content_id": "listing_20872"
  },
  "created_at": "2026-10-08T09:29:03.917Z",
  "updated_at": "2026-10-08T09:29:16.206Z"
}

Path parameters

idstringRequired

Id of the queue item: qi_ plus 22 base62 characters.

Request body

resolutionenum

allowed runs the built-in allow action and rejected runs reject. Required unless action is sent.

One ofallowedrejected

actionstring

Key of the action to execute, up to 64 characters, for example reject or the key of a custom action. Required unless resolution is sent. When both are sent, action is used.

valueany

A value passed to the action, of any JSON type. Only actions with accepts_value set to true take one, so it cannot be sent with allowed or rejected. The built-in block_author and suspend_author read a reason string, or an object with reason and until.

notestring

A note of up to 4,000 characters, stored on the queue item and in the action log.

Returns

The queue item. After a resolving action its state is resolved and its resolution is allowed, rejected or action:<key>, and the matching queue_item.* event and action.executed are emitted. An item that was already resolved is returned unchanged.

Errors

404
not_found

The key's project has no queue item with this id.

409
action_disabled

The action is disabled.

422
validation_error

Neither resolution nor action was sent, the action key is unknown, value was sent to an action that does not accept one, or an author action was used on a moderation that has no author.

Every endpoint can also answer the errors any request can meet: a missing key, a rate limit, a malformed body. Errors

Something missing or unclear on this page? Write to support@useinfrared.com.