LLM-readable documentation index
Open Dashboard
ApiV3GeneratedReview Queue
DocumentationAPI Reference

List Review Queue

Hand off to an LLM

List entities awaiting curation, for a human reviewer's queue.

Returns a cursor-paginated set of entities scoped to your account+environment (and optional bucket), each carrying a small preview of its first mentions so a reviewer can triage without opening every entity. All filters AND together.

  • status (repeatable) restricts to the given lifecycle states. Omitting it defaults to the pre-terminal states extracted and proposed.
  • type (repeatable, ety_... IDs) matches the entity's effective type: an entity matches when its assigned type is one of these IDs, or it has no assigned type and its bem-inferred type name matches one of them.
  • assignedTo (me or a usr_... ID) restricts to entities whose effective type the given user reviews. me resolves to the calling user.
  • since (RFC3339) restricts to entities created at or after the time.

Pagination is cursor-based on entityID ascending; default limit is 50, maximum 200.

GET
/v3/review-queue

Authorization

API Key
x-api-key<token>

Authenticate using API Key in request header

In: header

Query Parameters

status?array<>

Restrict to these lifecycle states. Defaults to extracted + proposed.

type?array<>

Restrict to entities whose effective type is one of these ety_... IDs.

assignedTo?string

me or a usr_... ID — restrict to entities whose effective type that user reviews.

since?string

RFC3339 timestamp — restrict to entities created at or after this time.

cursor?string

Cursor — an entityID defining your place in the list.

bucket?string

Optional bucket public ID (bkt_...) to scope to. Omit for all buckets.

limit?integer
Default50
Formatint32
Range1 <= value <= 200

Response Body

application/json

curl -X GET "https://api.bem.ai/v3/review-queue"
{
  "entities": [
    {
      "entityID": "string",
      "canonical": "string",
      "type": "string",
      "description": "string",
      "mentionCount": 0,
      "surfaceForms": [
        "string"
      ],
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z",
      "status": "string",
      "typeID": "string",
      "validatedAt": "2019-08-24T14:15:22Z",
      "validatedByUserID": "string",
      "previewMentions": [
        {
          "mentionID": "string",
          "entityID": "string",
          "referenceID": "string",
          "transformationID": "string",
          "page": 0,
          "sectionLabel": "string",
          "surface": "string",
          "createdAt": "2019-08-24T14:15:22Z"
        }
      ]
    }
  ],
  "hasMore": true,
  "nextCursor": "string"
}