For AI agents: The documentation index is at https://docs.digitalocean.com/llms.txt. Markdown versions of pages use the same URL with index.html.md in place of the HTML page (for example, append index.html.md to the directory path instead of opening the HTML document).

Usage

client.output_views.create(
    body={
        "tool": "exa_web_search",
        "tool_id": "",
        "name": "titles-and-urls",
        ...,
    },
)

Description

An output view is a named projection of one tool version’s output: tool calls that use it return only the listed fields, and its output_schema describes the result. The view is bound to the tool version your catalog currently releases. Returns 409 when your team already has a view with this name on the tool version, and 429 when your team already has the maximum of 20 views on it.

Parameters

tool string optional

Example: exa_web_search

Exactly one of tool or tool_id selects the tool version. tool is a provider-qualified slug, optionally pinned as <tool>@<version>. You can bind only the released version your catalog exposes: an unpinned slug resolves it and the response echoes it as version; a pin must equal it, and a tool_id (the opaque identity from tool search) must be that version. Any other version returns 404.

tool_id string optional

Opaque ID of the tool version; see tool.

name string required

Example: titles-and-urls

View name. Must match ^[a-z]`[a-z0-9_-]{0,63}$` and be unique per tool version within your team.

description string optional

Example: Keep only result titles and URLs.

Optional description. At most 512 bytes.

Max length: 512

fields array of strings required

Example: ['results.title', 'results.url']

Output paths to keep, 1 to 64 of them. Each is a dotted path of up to 8 segments made of [A-Za-z0-9_-], and must be declared by the tool's output schema; arrays are traversed element-wise. Paths may not repeat or be a prefix of one another. The tool version must declare an object output schema.

Request Sample

import os
from pydo import Client

client = Client(token=os.environ.get("DIGITALOCEAN_TOKEN"))

req = {
  "tool": "exa_web_search",
  "name": "titles-and-urls",
  "description": "Keep only result titles and URLs.",
  "fields": [
    "results.title",
    "results.url"
  ]
}

resp = client.output_views.create(body=req)

Response Example

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

More Information

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