list_models

Use list_models first to see every accessible model, including other workspaces you belong to (OAuth only; tokens see just their own workspace). Carry the returned workspace_id into read_file, run_model, commit_files, or other follow-ups to target non-default workspaces.

read-only · idempotent

Parameters

Name	Type	Required	Default	Description
limit	Annotated[int, Field(ge=1, le=200, description='Maximum models per page (default 200).')]	No	200
cursor	`Annotated[str	None, Field(description=‘Opaque continuation cursor from a previous list_models response.’)]`	No	None

Returns

Returns a structured object. Top-level fields:

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

See the response example below for the full payload shape.

Example

Tool Call

{
  "name": "list_models",
  "arguments": {
    "limit": 50
  }
}

Response

{
  "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
}

Notes

• Module: Models
• Requires an authenticated Bridge Town session (OAuth) or an API token.