Skip to content

list_models

Use list_models to find an accessible model or select another workspace. Omit workspace_id for the current workspace; carry the selected row’s returned ID only when targeting a different workspace.

read-only · idempotent

NameTypeRequiredDefaultDescription
limitAnnotated[int, Field(ge=1, le=200, description='Maximum models per page (default 200).')]No200
cursor`Annotated[strNone, Field(description=‘Opaque continuation cursor from a previous list_models response.’)]`NoNone

Returns a structured object. Top-level fields:

  • models (array<object>)
  • count (integer)

See the response example below for the full payload shape.

{
"name": "list_models",
"arguments": {
"limit": 50
}
}
{
"models": [
{
"model": "forecasts",
"role": "owner",
"url": "https://app.bridgetown.example/acme/forecasts"
},
{
"model": "headcount-plan",
"role": "editor",
"url": "https://app.bridgetown.example/acme/headcount-plan"
}
],
"count": 2
}
  • Module: Models
  • Requires an authenticated Bridge Town session (OAuth) or an API token.