Bulk-import comments across many threads (async)

Bulk-import comments across many threads of one fund — the asynchronous, batched form of ImportComments.

The request carries up to 100 items, each addressed by a threadId (resolve order-level general threads first with CreateOrGetCommentThread, or discover existing threads with ListCommentThreads). Every thread must belong to the fund in the URL — an item whose threadId is outside the fund fails as a per-item 404. Items targeting the same thread are combined and imported together, in payload order. Per-item fields are identical to ImportComments (body or bodyHtml, onBehalfOf, externalRef); notifyMode (default none; see ImportComments) applies to the whole job.

Per-item limits. Each item carries 1–100 comments (the same cap ImportComments applies per request), so one bulk job lands at most 100 items × 100 comments. The per-thread ceiling still holds: at most 200 stored comments per thread across all imports, and each comment at most 10,000 visible characters. Items may target different anchors (order general threads, form-question threads, …) — a single job can fan comments across many threads at once, and every item is reported in the status response.

Formatting. Send each comment as either body or bodyHtml — not both, and not neither (400).

  • body — plain text. Each line is a paragraph; lines starting with - or 1. become lists; @[[email protected]] mentions a member.
  • bodyHtml — keeps the formatting. Only <p> <br> <strong> <em> <u> <s> <ul> <ol> <li>, plus mentions as <span data-mention="@[[email protected]]">Label</span>; anything else is rejected.

See ImportComments for the full rules and the mention limits.

The endpoint validates the payload and the caller's access to the fund, then returns requestId immediately. A caller that is not a fund manager on the fund (403) or an invalid payload is rejected before any job is created — no item is applied.

Everything that genuinely varies per item — thread existence, the fund↔thread binding, per-order and per-visibility-tier permission, thread status, mention resolution, comment limits — is still evaluated inside the job, so one bad item never rejects the whole job. In particular a well-formed threadId that is unknown, deleted, or rooted in another fund is a per-item 404, not a request-level error. Threads are applied one at a time, each thread succeeding or failing independently. Items that target the same thread are imported together and share one outcome.

Resolved threads. An item targeting a thread whose status is resolved writes nothing and comes back Failed, with an error message telling you to reopen the thread — the same rule ImportComments applies, and for the same reason (the app hides the reply box on a resolved thread). Thread status varies from item to item, so this is never a request-level reject: a batch mixing open and resolved threads still returns 200 + requestId, the open items complete, and only the resolved ones are reported Failed. There is no public endpoint to reopen a thread — reopen it in the app and resubmit just those items.

Note that a failed item carries only status and a human-readable error. Bulk items have no machine-readable error code and no per-item HTTP status: the 409 and the THREAD_RESOLVED code documented on ImportComments belong to that synchronous endpoint only. To branch on the condition programmatically, read status from ListCommentThreads before submitting, or retry the item through ImportComments and inspect its 409.

Poll GET requests/{requestId}/status for progress. The job reports InProcessing with per-item statuses (Pending / Completed / Failed) while running, and Completed when every item has finished — including jobs where some items failed (each failed item carries its own error). An item's comments are not applied atomically, so a Failed item may have landed some of its comments before failing. Comment ids are system-generated and import is not idempotent: blindly re-sending a failed item re-imports (duplicates) the comments that had already landed. Treat the commentIds in the status response as the authoritative record of what landed (completed items list their commentIds in append order), and read the thread back before retrying a partial apply.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The Anduin ID of the Fund object, or its custom fund ID

Body Params
items
array of objects
required
length between 1 and 100
items*
string
enum
Allowed:
Responses

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json