List operators

​

Returns the operators visible to your account — the platform operators Simwood maintains plus your own custom operators — each at its current version. Narrow the list with scope (platform, custom, or all) and output_type. Results are returned newest first and paginated; follow next_cursor to page through them.

Required scope: intelligence:read

Query Parameters
  • scope
    Type: string · ScopePattern: ^(all|platform|custom)$

    Which operators to return: platform for Simwood-maintained operators, custom for your account's own operators, or all for both.

  • output_type
    Type: string · Output Typenullable

    Return only operators that emit this output type — one of classification, boolean, score, multi_tag, extraction, or text.

  • cursor
    Type: string · Cursornullable

    Pagination cursor from a previous response's next_cursor. Omit for the first page.

  • limit
    Type: integer · Limit
    min:  
    1
    max:  
    100

    Maximum number of operators to return (1–100, default 20).

Responses
  • application/json
  • application/json
  • application/json
Request Example for get/operators
curl https://api.simwood.com/intelligence/v1/operators \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "items": [
    {
      "name": "string",
      "description": "string",
      "prompt": "string",
      "output_type": "classification",
      "output_config": {
        "additionalProperty": "anything"
      },
      "model_tier": "fast",
      "include_reasoning": true,
      "parameters": [
        {
          "name": "string",
          "type": "kb_document",
          "description": "string"
        }
      ],
      "account": "string",
      "version": 1,
      "is_current": true,
      "created_at": "string",
      "updated_at": "string"
    }
  ],
  "next_cursor": "string"
}

Successful Response

Simwood API Documentation