Give Feedback

pydo.output_views.list()

Generated on 1 Oct 2026 from pydo version v0.43.0

Copy page as Markdown View page as Markdown

Usage

client.output_views.list(
    tool=None,
    tool_id=None,
    page_size=20,
    page_token=None,
)

Returns JSONRaises HttpResponseError

Description

Returns the output views your team can use: views DigitalOcean publishes to every team, plus your team’s own. Cursor-paged with page_size and page_token; no total is reported.

Parameters

tool string optional

At most one of tool or tool_id, as on create. With one set, the list is the published views plus your team's own on that tool version. With neither, it is every live view your team owns plus every published view on a tool version your catalog exposes, across tools.

tool_id string optional

Opaque ID of the tool version; see tool.

page_size integer optional

Page size, 1 to 100. Defaults to 20 when omitted or 0; other values are rejected with 400.

Min: 1

Max: 100

Default: 20

page_token string optional

next_page_token from the previous response. Valid only with the same tool selection; otherwise the request is rejected with 400.

Response Example

Show Response Example

{
  "views": [
    {
      "view_id": "ov_4f0c2a9d8e1b47c6a3d5f7e9b1c3a5d7",
      "tool_id": "tul_exa_web_search",
      "tool": "exa_web_search",
      "version": "v1",
      "team_id": "123456",
      "name": "titles-and-urls",
      "description": "Keep only result titles and URLs.",
      "kind": "OUTPUT_VIEW_KIND_PROJECTION",
      "fields": [
        "results.title",
        "results.url"
      ],
      "output_schema": {
        "type": "object",
        "properties": {
          "results": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "title": {
                  "type": "string"
                },
                "url": {
                  "type": "string"
                }
              }
            }
          }
        }
      },
      "audit": {
        "createdAt": "2026-09-01T16:00:00Z",
        "updatedAt": "2026-09-01T16:00:00Z",
        "deletedAt": null
      }
    }
  ],
  "tool_id": "tul_exa_web_search",
  "tool": "exa_web_search",
  "version": "v1",
  "next_page_token": ""
}

More Information

See /v2/action-gateway/output-views in the API reference for additional detail on responses, headers, parameters, and more.