Book a demo

list_beta_lists

Beta lists

read collection canonical-registry since 2026-10-01

Lists the beta lists flags can target: each list's name, what it is for, the person property that is the list in PostHog, and where it is declared. Who is on each is list_beta_members. Staff only.

Contract

shape
collection
authority
read
evidence
none
subscription
false
permission
any one of: staff.read (the staff role staff_read held in the Internal org, tradehq_role.staff_role); a deactivated caller is refused first
idempotency
safe
emits
none
MCP tool
list_beta_lists
REST
POST https://api.containertradehq.com/v1/cap/list_beta_lists

Idempotency: a read: calling again changes nothing

Inputs

No inputs.

Paginated: next next_after · ceiling not_declared

Response

  • items · object[]
  • next_after · stringnull · Pass as `after` for the next page; null on the last one.
Full JSON Schema 
{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The list's name, as flags and members name it.",
            "x-data-class": "operational"
          },
          "purpose": {
            "type": [
              "string",
              "null"
            ],
            "description": "What the list is for.",
            "x-data-class": "operational"
          },
          "property": {
            "type": "string",
            "description": "The person property that is the list.",
            "x-data-class": "operational"
          },
          "source": {
            "type": "string",
            "enum": [
              "declared"
            ],
            "description": "declared: in src/beta_lists.json, changed by pull request.",
            "x-data-class": "operational"
          }
        },
        "required": [
          "name",
          "purpose",
          "property",
          "source"
        ],
        "additionalProperties": false
      }
    },
    "next_after": {
      "type": [
        "string",
        "null"
      ],
      "description": "Pass as `after` for the next page; null on the last one."
    }
  },
  "required": [
    "items",
    "next_after"
  ],
  "additionalProperties": false
}

Refusals

not yet declared

The platform refusals apply to every call: version, authentication, authority, validation and rate limits, each in the same envelope.

Surfaces

DesktopF
MobileF
APIF
MCPF
VoiceD4
PushN
OneBoxN
OutboundN
  • Voice: degraded: visualization
  • Push: emits nothing
  • OneBox: no document originates a beta list
  • Outbound: staff tooling; crosses to no counterparty

Events

None emitted.

Related

None.