> ## Documentation Index
> Fetch the complete documentation index at: https://docs.engini.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a catalog entry's schema

> The fields of one trigger, action or block as the plan writes them. With connectionId the fields that depend on the connected system are read live (rate limited per key); without it the static schema is returned.



## OpenAPI

````yaml /developers/api-reference/openapi.json get /v1/workflows/catalog/{slug}
openapi: 3.0.0
info:
  title: Engini API
  version: v1
  description: The Engini public API.
servers:
  - url: https://api.engini.io
security:
  - Bearer: []
  - ApiKey: []
tags:
  - name: Auth
    description: Identify the caller a Developer API request is authenticated as.
  - name: On-prem agents
    description: >-
      Provision and manage agents that run Engini tasks inside a customer's
      network.
  - name: Applications
    description: >-
      Discover the applications (toolkits) available in Engini and their
      connection requirements.
  - name: Tools
    description: Browse and execute the tools exposed by Engini applications.
  - name: Toolsets
    description: Manage toolsets - named groupings of connections and tools.
  - name: McpServers
    description: >-
      Inspect and maintain MCP servers - the account-wide endpoints that expose
      Engini tools and workflows over the Model Context Protocol. Distinct from
      the MCPClient connection kind, which is Engini consuming a third-party MCP
      server.
  - name: Connections
    description: >-
      Manage connections to applications, including OAuth sign-in and
      default-connection selection.
  - name: Folders
    description: >-
      List the folders that organize workflows in each workspace and
      environment.
  - name: Workflows
    description: >-
      List workflows, and build them from a plan: search the catalog, read
      schemas and options, compile, create and update.
  - name: Executions
    description: >-
      Read execution history for workflows, table automations and app business
      rules, including per-step logs and recorded payloads.
  - name: Triggers
    description: >-
      Create triggers that fire when something changes in a connected app, and
      manage the destinations their events are delivered to.
paths:
  /v1/workflows/catalog/{slug}:
    get:
      tags:
        - Workflows
      summary: Get a catalog entry's schema
      description: >-
        The fields of one trigger, action or block as the plan writes them. With
        connectionId the fields that depend on the connected system are read
        live (rate limited per key); without it the static schema is returned.
      operationId: Workflows_GetSchema
      parameters:
        - name: slug
          in: path
          required: true
          schema:
            type: string
          x-position: 1
        - name: connectionId
          in: query
          schema:
            type: integer
            format: int32
            nullable: true
          x-position: 2
        - name: kind
          in: query
          schema:
            type: string
            nullable: true
          x-position: 3
        - name: table
          in: query
          schema:
            type: string
            format: uuid
            nullable: true
          x-position: 4
      responses:
        '200':
          description: Success.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ToolSchema'
        '400':
          description: >-
            Bad request - an invalid parameter or body, or SCOPE_REQUIRED for a
            write with a key that has no workspace (problem+json).
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/BuilderProblem'
        '401':
          description: Unauthorized - missing or invalid bearer token or API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: >-
            Forbidden - API_KEY_REQUIRED for a Bearer token or an account-level
            key, PERMISSION_DENIED when the key's user may not create workflows
            here (problem+json); FORBIDDEN, GUEST_NOT_ALLOWED or
            SCOPE_UNRESOLVED when a gate in front of the builder refuses first
            (the ErrorResponse envelope, application/json).
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/BuilderProblem'
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: >-
            Not found - the workflow, app, table or connection is not visible to
            this key, or the key's user may not read here (problem+json).
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/BuilderProblem'
        '429':
          description: >-
            Too many requests - the account's limit (ErrorResponse body) or this
            key's per-operation limit (empty body). Both send Retry-After.
          headers:
            Retry-After:
              description: Number of seconds to wait before retrying.
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal server error (problem+json).
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/BuilderProblem'
        '502':
          description: >-
            Bad gateway - the connected system refused or failed the read
            (problem+json).
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/BuilderProblem'
      security:
        - Bearer: []
        - ApiKey: []
      x-codeSamples:
        - lang: python
          label: Python
          source: |-
            from engini import Engini

            client = Engini()  # reads ENGINI_API_KEY

            schema = client.workflows.get_schema("slack.post_message")
        - lang: typescript
          label: TypeScript
          source: >-
            import { Engini } from "@engini/sdk";


            const client = new Engini(); // reads ENGINI_API_KEY


            const schema = await
            client.workflows.getSchema("slack.post_message");
        - lang: bash
          label: CLI
          source: engini workflows schema slack.post_message
components:
  schemas:
    ToolSchema:
      type: object
      description: An activity's schemas. Input/Output are null when generation failed.
      additionalProperties: false
      required:
        - slug
        - dynamicFields
      properties:
        slug:
          type: string
        input:
          nullable: true
          oneOf:
            - $ref: '#/components/schemas/MCPDataSchema'
        output:
          nullable: true
          oneOf:
            - $ref: '#/components/schemas/MCPDataSchema'
        dynamicFields:
          type: array
          items:
            type: string
        schedule:
          description: >-
            Set only for a polling (schedule) trigger, built-in or an app's: the
            plan step may carry a schedule (Schedule).
          nullable: true
          oneOf:
            - $ref: '#/components/schemas/ScheduleSchema'
        query:
          description: >-
            Set only for a list tool that takes filters, top or sorts (Filters,
            Top, Sorts).
          nullable: true
          oneOf:
            - $ref: '#/components/schemas/QuerySchema'
        subItems:
          description: Set only for a tool with sub-item tables a plan may set (SubItems).
          nullable: true
          oneOf:
            - $ref: '#/components/schemas/SubItemsSchema'
        aiAgent:
          description: >-
            Set only for block.ai_agent: the step's model, memory and tools
            (PlanAiAgentMapper).
          nullable: true
          oneOf:
            - $ref: '#/components/schemas/AiAgentSchema'
        manualValue:
          description: >-
            Set only for block.init_variable: how the step's value tree is
            written (PlanVariableValueMapper).

            Its presence is also how a caller tells a server that takes value
            from an older one, which ignores it.
          nullable: true
          oneOf:
            - $ref: '#/components/schemas/ManualValueSchema'
        triggerGates:
          description: >-
            Set only for a trigger: whether its plan step may carry
            listenColumns and a condition

            (PlanTriggerGateMapper). Its presence is also how a caller tells a
            server that takes them from an older one.
          nullable: true
          oneOf:
            - $ref: '#/components/schemas/TriggerGatesSchema'
    BuilderProblem:
      type: object
      description: >-
        The builder's error body as it is sent (application/problem+json).
        Documentation only: the controller writes it

        from WorkflowBuilderApiError with the HTTP status added.
      additionalProperties: false
      required:
        - status
        - code
        - message
      properties:
        status:
          type: integer
          description: The HTTP status, repeated in the body.
          format: int32
        code:
          type: string
          description: >-
            A stable machine-readable code, such as PLAN_HAS_ERRORS or
            REVISION_CONFLICT.
        path:
          type: string
          description: The request member the refusal is about, when there is one.
          nullable: true
        message:
          type: string
          description: What failed, in plain words.
        fix:
          type: string
          description: What to do about it, when the builder knows.
          nullable: true
        diagnostics:
          type: array
          description: 'With PLAN_HAS_ERRORS: every diagnostic of the refused plan.'
          nullable: true
          items:
            $ref: '#/components/schemas/BuilderDiagnostic'
        currentRevisionId:
          type: integer
          description: 'With REVISION_CONFLICT: the workflow''s revision now.'
          format: int64
          nullable: true
    ErrorResponse:
      type: object
      description: >-
        Unified machine-readable error envelope returned by every non-200
        Developer API response.
      additionalProperties: false
      required:
        - errorCode
        - message
        - requestId
        - timestamp
      properties:
        errorCode:
          type: string
          description: Machine-readable error code identifying the failure.
        message:
          type: string
          description: Human-readable error message.
        requestId:
          type: string
          description: Identifier of the request, for support/correlation.
        timestamp:
          type: string
          description: Timestamp when the error occurred (ISO 8601).
        details:
          type: array
          description: Per-field validation details, when applicable.
          nullable: true
          items:
            $ref: '#/components/schemas/ErrorDetail'
    MCPDataSchema:
      type: object
      additionalProperties: false
      required:
        - type
        - description
      properties:
        type:
          type: string
        format:
          type: string
          nullable: true
        description:
          type: string
        properties:
          type: object
          nullable: true
          additionalProperties:
            $ref: '#/components/schemas/MCPDataSchema'
        items:
          nullable: true
          oneOf:
            - $ref: '#/components/schemas/MCPDataSchema'
        additionalProperties:
          description: >-
            JSON Schema additionalProperties, as a schema. Set only where the
            property names are

            genuinely not knowable up front - a connector whose sub-item
            children are per-record ERP

            metadata rather than a declared field list - so the shape of the
            VALUES can still be

            published even though the keys cannot be enumerated.
          nullable: true
          oneOf:
            - $ref: '#/components/schemas/MCPDataSchema'
        enum:
          type: array
          nullable: true
          items:
            type: string
        x-enum-varnames:
          type: array
          nullable: true
          items:
            type: string
        required:
          type: array
          nullable: true
          items:
            type: string
        anyOf:
          type: array
          nullable: true
          items:
            $ref: '#/components/schemas/MCPDataSchema'
        const:
          nullable: true
        default:
          nullable: true
    ScheduleSchema:
      type: object
      description: >-
        What a polling (schedule) trigger's schedule accepts, for the agent
        writing the plan.
      additionalProperties: false
      required:
        - frequencies
        - minIntervalMinutes
        - description
        - example
      properties:
        frequencies:
          type: array
          description: The frequency words.
          items:
            type: string
        minIntervalMinutes:
          type: integer
          description: >-
            This account's floor: no run (or time-frame repeat) more often than
            this.
          format: int32
        description:
          type: string
          description: How the fields read, in one paragraph.
        example:
          description: A schedule this trigger accepts.
          oneOf:
            - $ref: '#/components/schemas/PlanSchedule'
    QuerySchema:
      type: object
      description: >-
        A list tool's filters, top and sorts; a part is null when the tool does
        not take it.
      additionalProperties: false
      required:
        - description
      properties:
        filters:
          nullable: true
          oneOf:
            - $ref: '#/components/schemas/FilterSchema'
        top:
          nullable: true
          oneOf:
            - $ref: '#/components/schemas/TopSchema'
        sorts:
          nullable: true
          oneOf:
            - $ref: '#/components/schemas/SortSchema'
        description:
          type: string
    SubItemsSchema:
      type: object
      description: What a tool's subItems accepts, for the agent writing the plan.
      additionalProperties: false
      required:
        - tables
        - maxRowsPerTable
        - maxFieldsPerRow
        - description
      properties:
        tables:
          type: array
          description: The tables the plan may set (declared, not hidden).
          items:
            $ref: '#/components/schemas/SubItemTableSchema'
        maxRowsPerTable:
          type: integer
          description: At most this many rows in a table that takes many.
          format: int32
        maxFieldsPerRow:
          type: integer
          description: At most this many fields in a row.
          format: int32
        description:
          type: string
          description: How a table reads, in one paragraph.
    AiAgentSchema:
      type: object
      description: >-
        How a plan writes an AI agent's model, memory and tools, with a worked
        example.
      additionalProperties: false
      required:
        - providers
        - maxTools
        - description
        - example
      properties:
        providers:
          type: array
          items:
            type: string
        maxTools:
          type: integer
          format: int32
        description:
          type: string
        example:
          $ref: '#/components/schemas/PlanStep'
    ManualValueSchema:
      type: object
      description: >-
        How a plan writes an object or array variable as a JSON tree (Value),
        with a worked example.
      additionalProperties: false
      required:
        - types
        - reservedNames
        - maxFields
        - maxItems
        - maxLeafLength
        - maxDepth
        - description
        - example
      properties:
        types:
          type: array
          items:
            type: string
        reservedNames:
          type: array
          items:
            type: string
        maxFields:
          type: integer
          format: int32
        maxItems:
          type: integer
          format: int32
        maxLeafLength:
          type: integer
          format: int32
        maxDepth:
          type: integer
          format: int32
        description:
          type: string
        example:
          $ref: '#/components/schemas/PlanStep'
    TriggerGatesSchema:
      type: object
      description: >-
        A trigger's two gates: listen columns (provider-side, one subscription
        each) and a fire condition (checked after delivery).
      additionalProperties: false
      required:
        - supportsListenColumns
        - supportsCondition
      properties:
        supportsListenColumns:
          type: boolean
        supportsCondition:
          type: boolean
    BuilderDiagnostic:
      type: object
      additionalProperties: false
      required:
        - severity
        - code
        - message
      properties:
        severity:
          type: string
        code:
          type: string
        stepKey:
          type: string
          nullable: true
        field:
          type: string
          nullable: true
        message:
          type: string
    ErrorDetail:
      type: object
      description: A single field-level error detail within an ErrorResponse.
      additionalProperties: false
      required:
        - field
        - issue
      properties:
        field:
          type: string
          description: Name of the field the issue relates to.
        issue:
          type: string
          description: Description of the issue with the field.
    PlanSchedule:
      type: object
      description: >-
        A polling (schedule) trigger's schedule (the built-in Schedule trigger,
        or an app trigger that checks on a timer such as

        Gmail or Outlook "Check for new emails"), in the words of the designer's
        schedule editor. Times are UTC (the designer's

        "Starting (UTC)") unless TimeZone names the zone they are written in.
      additionalProperties: false
      properties:
        frequency:
          type: string
          description: minute|hour|day|week|month
          nullable: true
        interval:
          type: integer
          description: Run every interval units of Frequency.
          format: int32
          nullable: true
        startDate:
          type: string
          description: yyyy-MM-dd; today (UTC) when left out.
          nullable: true
        startTime:
          type: string
          description: HH:mm; 00:00 when left out.
          nullable: true
        weekDays:
          type: string
          description: >-
            Days of the week, 0 = Sunday … 6 = Saturday: "1,2,3,4,5" or
            [1,2,3,4,5]. Every day when left out. Only a weekly schedule

            reads them, so a subset with any other frequency is refused.
          nullable: true
        timeZone:
          type: string
          description: >-
            The IANA zone StartDate/StartTime/time frames are written in; UTC
            when left out. A monthly

            schedule whose start lands on another day in UTC is refused (it
            repeats on its UTC day of the month).
          nullable: true
        timeFrames:
          type: array
          description: Daily windows to repeat in, every EveryMinutes minutes.
          nullable: true
          items:
            $ref: '#/components/schemas/PlanTimeFrame'
    FilterSchema:
      type: object
      additionalProperties: false
      required:
        - required
        - operators
      properties:
        required:
          type: boolean
          description: The tool needs at least one filter.
        max:
          type: integer
          description: At most this many filters; null for no limit.
          format: int32
          nullable: true
        operators:
          type: array
          description: >-
            The operators the tool offers (a field may offer fewer: its own
            Operators).
          items:
            type: string
        fields:
          type: array
          description: >-
            The filterable fields; null when they depend on the object
            FieldsFrom picks.
          nullable: true
          items:
            $ref: '#/components/schemas/QueryField'
        fieldsFrom:
          type: string
          description: The input that picks the object whose fields these are.
          nullable: true
    TopSchema:
      type: object
      additionalProperties: false
      properties:
        default:
          type: integer
          description: What the run returns when 'top' is left out; null for every record.
          format: int32
          nullable: true
    SortSchema:
      type: object
      additionalProperties: false
      required:
        - required
      properties:
        required:
          type: boolean
          description: The tool needs at least one sort.
        max:
          type: integer
          description: At most this many sorts; null for no limit.
          format: int32
          nullable: true
        fields:
          type: array
          description: >-
            The sortable fields; null when they depend on the object FieldsFrom
            picks.
          nullable: true
          items:
            type: string
        fieldsFrom:
          type: string
          description: The input that picks the object whose fields these are.
          nullable: true
    SubItemTableSchema:
      type: object
      additionalProperties: false
      required:
        - table
        - manyRows
        - values
      properties:
        table:
          type: string
          description: The table's name, the key under 'subItems'.
        description:
          type: string
          description: The designer's label for it.
          nullable: true
        manyRows:
          type: boolean
          description: The table takes a list of rows; otherwise exactly one.
        fields:
          type: array
          description: >-
            The column names; null when the field names are the plan's own (a
            key/value table).
          nullable: true
          items:
            type: string
        values:
          type: string
          description: What a value may hold.
    PlanStep:
      type: object
      additionalProperties: false
      required:
        - key
        - type
        - connection
        - inputs
      properties:
        key:
          type: string
        type:
          type: string
          description: >-
            action|if|foreach|switch|do_while|scope|init_variable|set_variable|delay|stop|ai_agent|opaque
        tool:
          type: string
          description: Catalog slug, for action/trigger.
          nullable: true
        connection:
          type: string
          description: '"auto" | "none" | "<connectorId>"'
        inputs:
          type: object
          description: 'Never null: a JSON null is normalised to empty.'
          additionalProperties:
            type: string
        condition:
          nullable: true
          oneOf:
            - $ref: '#/components/schemas/PlanCondition'
        then:
          type: array
          nullable: true
          items:
            $ref: '#/components/schemas/PlanStep'
        else:
          type: array
          nullable: true
          items:
            $ref: '#/components/schemas/PlanStep'
        items:
          type: string
          nullable: true
        do:
          type: array
          description: >-
            The body of a foreach, a do_while (run while its condition holds) or
            a scope.
          nullable: true
          items:
            $ref: '#/components/schemas/PlanStep'
        cases:
          type: array
          description: >-
            A switch's cases, first case first; the value compared is the step's
            inputs.data. Every case whose

            value equals it is tried in order and the last match runs, so give
            each case a distinct value.
          nullable: true
          items:
            $ref: '#/components/schemas/PlanCase'
        default:
          type: array
          description: >-
            A switch's default branch: runs when no case matches. Every switch
            has one, possibly empty.
          nullable: true
          items:
            $ref: '#/components/schemas/PlanStep'
        onFailure:
          type: array
          description: >-
            The step's failure path: a chain that runs when this step fails,
            beside it in the same container (not inside it).

            Its first step runs only on failure; the rest follow it. A plan can
            add a failure path and edit the steps on one,

            but never re-point or delete an existing one (that stays a designer
            action).
          nullable: true
          items:
            $ref: '#/components/schemas/PlanStep'
        ref:
          type: integer
          description: 'Opaque steps: the StepNo in the base workflow.'
          format: int32
          nullable: true
        schedule:
          description: >-
            The trigger's schedule, only on a schedule (polling) trigger; see
            PlanScheduleMapper. Left out, an

            existing trigger keeps the schedule it has.
          nullable: true
          oneOf:
            - $ref: '#/components/schemas/PlanSchedule'
        listenColumns:
          type: array
          description: >-
            The trigger's "columns to listen to": only events that change one of
            them fire it, each column one provider

            subscription; see PlanTriggerGateMapper. Only on a trigger whose
            tool offers it. Left out, an existing

            trigger keeps the columns it has; [] removes them.
          nullable: true
          items:
            type: string
        filters:
          type: array
          description: >-
            A list tool's filters (the designer's filter rows, all of which must
            match): only on a tool that offers filters; see

            PlanQueryMapper. The step has exactly the filters, top and sorts the
            plan gives it: left out means none.
          nullable: true
          items:
            $ref: '#/components/schemas/PlanFilter'
        top:
          type: integer
          description: >-
            Return at most this many records (the designer's "Select top"); only
            on a tool that offers it.
          format: int32
          nullable: true
        sorts:
          type: array
          description: >-
            A list tool's sort order, first entry first; only on a tool that
            offers sorting.
          nullable: true
          items:
            $ref: '#/components/schemas/PlanSort'
        advancedFilter:
          type: boolean
          description: >-
            Sort & Filter only: each filter's field is an expression over the
            current record instead of a field name:

            the data reference followed by the field (data {{s2}}, field
            {{s2.Amount}}: a list action's array is the step itself).

            Left out means plain field-name filters.
          nullable: true
        offset:
          type: integer
          description: >-
            Sort & Filter only: skip this many records before the ones returned
            (the designer's "Offset").
          format: int32
          nullable: true
        sample:
          type: string
          description: >-
            A Parse JSON step's sample: a synthetic JSON (or XML) document of
            the shape the step's content will hold.

            Its output schema is generated from it, so {{key.field}} resolves.
            Stored in clear text with the workflow:

            never paste a real record. Left out on an existing step, the saved
            schema is kept.
          nullable: true
        mapDictionary:
          type: boolean
          description: >-
            A Parse JSON step: read JSON objects whose keys are ids (a
            dictionary) as an array of entries.
          nullable: true
        subItems:
          type: object
          description: >-
            A tool's sub-item tables (Http Request's Queries and Headers), by
            table name: one row

            ({field: value}) or a list of rows; see PlanSubItemMapper. Only on a
            tool that offers the

            table. Like filters, the step has exactly the tables the plan gives
            it: an offered table left out is cleared.
          nullable: true
          additionalProperties:
            type: array
            items:
              type: object
              additionalProperties:
                type: string
        model:
          description: >-
            An ai_agent step's LLM; see PlanAiAgentMapper. Left out on an
            existing agent, the agent keeps the

            model it has (it cannot run without one); required on a new agent.
          nullable: true
          oneOf:
            - $ref: '#/components/schemas/PlanAiModel'
        memory:
          description: >-
            An ai_agent step's chat memory. Left out, the agent has none (an
            existing one is cleared).
          nullable: true
          oneOf:
            - $ref: '#/components/schemas/PlanAiMemory'
        tools:
          type: array
          description: >-
            An ai_agent step's tools (connector actions the LLM may call), the
            full set. Left out, the agent has none (an

            existing set is cleared). Tools the plan cannot name (MCP,
            knowledge, worker, sub-agent) are never touched.
          nullable: true
          items:
            $ref: '#/components/schemas/PlanAiTool'
        value:
          description: >-
            An init_variable step's value as a JSON tree (TYPE object or array):
            the step is written in the

            designer's Manual mode, one typed property per leaf, so a
            {{key.path}} in a leaf resolves on its own; see

            PlanVariableValueMapper. Left out, VALUE is the raw text of
            inputs.VALUE (Raw mode).
          nullable: true
        valueTypes:
          type: object
          description: >-
            The designer type of a Value leaf, by JSON Pointer
            ("/customer/dueOn": "date"), where inference

            cannot tell it: a date (JSON has none), or a number or boolean
            written as a {{key.path}} reference.
          nullable: true
          additionalProperties:
            type: string
    PlanTimeFrame:
      type: object
      additionalProperties: false
      properties:
        start:
          type: string
          description: HH:mm
          nullable: true
        end:
          type: string
          description: HH:mm, after Start.
          nullable: true
        everyMinutes:
          type: integer
          description: Always minutes, whatever the schedule's frequency.
          format: int32
          nullable: true
    QueryField:
      type: object
      additionalProperties: false
      required:
        - field
      properties:
        field:
          type: string
        type:
          type: string
          nullable: true
        operators:
          type: array
          description: Null when the field offers the tool's Operators.
          nullable: true
          items:
            type: string
        hasOptions:
          type: boolean
          description: >-
            True when the designer offers the filter value from an option list
            the builder reads

            (HasFilterOptions, served by the options lookup for this field);
            null otherwise.
          nullable: true
    PlanCondition:
      type: object
      description: 'Op: eq|ne|gt|gte|lt|lte|contains|empty|notempty'
      additionalProperties: false
      required:
        - left
        - op
        - right
      properties:
        left:
          type: string
        op:
          type: string
        right:
          type: string
    PlanCase:
      type: object
      description: >-
        One case of a switch: the value it matches (a literal or a reference)
        and the steps it runs.
      additionalProperties: false
      properties:
        value:
          type: string
          nullable: true
        steps:
          type: array
          nullable: true
          items:
            $ref: '#/components/schemas/PlanStep'
    PlanFilter:
      type: object
      additionalProperties: false
      properties:
        field:
          type: string
          description: A filterable field of the tool's object.
          nullable: true
        operator:
          type: string
          description: >-
            eq|ne|gt|gte|lt|lte|contains|notcontains|startswith|endswith|notstartswith|notendswith|empty|notempty|in|notin
          nullable: true
        value:
          type: string
          description: Text, {{key.path}} references allowed; ignored by empty / notempty.
          nullable: true
    PlanSort:
      type: object
      additionalProperties: false
      properties:
        field:
          type: string
          description: A sortable field of the tool's object.
          nullable: true
        direction:
          type: string
          description: asc (the default) | desc
          nullable: true
    PlanAiModel:
      type: object
      additionalProperties: false
      properties:
        provider:
          type: string
          description: >-
            openai|anthropic|gemini|azure_openai|monday: the vendor whose chat
            model row the agent uses.
          nullable: true
        connection:
          type: string
          description: >-
            The vendor connection: auto or a connection id (never none: the
            agent needs one).
          nullable: true
        inputs:
          type: object
          description: The model row's inputs (model, temperature, ...), as written.
          nullable: true
          additionalProperties:
            type: string
    PlanAiMemory:
      type: object
      additionalProperties: false
      properties:
        sessionId:
          type: string
          description: 'The chat session the memory is kept under: text, references allowed.'
          nullable: true
        windowLength:
          type: string
          description: >-
            How many past messages the LLM sees (0-100); text, so a reference
            can be said.
          nullable: true
    PlanAiTool:
      type: object
      description: 'One tool of an AI agent: a connector action the LLM may call.'
      additionalProperties: false
      required:
        - connection
        - inputs
        - aiInputs
      properties:
        name:
          type: string
          description: >-
            The name the LLM calls the tool by: [a-z0-9_], 1-128, unique within
            the agent. Not a plan key.
          nullable: true
        tool:
          type: string
          description: The action's catalog slug.
          nullable: true
        connection:
          type: string
          description: '"auto" | "none" | "<connectorId>"'
        description:
          type: string
          description: >-
            What the LLM is told the tool does; left out, the action's own
            description is used.
          nullable: true
        inputs:
          type: object
          description: >-
            Fixed values, as a step's inputs; the LLM cannot change them. Never
            null.
          additionalProperties:
            type: string
        aiInputs:
          type: object
          description: >-
            Inputs the LLM fills at run time, by name, each with what the LLM is
            told it holds ("" for none). Never null.
          additionalProperties:
            type: string
  securitySchemes:
    Bearer:
      type: http
      description: Enter your JWT token
      scheme: bearer
      bearerFormat: JWT
    ApiKey:
      type: apiKey
      description: >-
        Opaque Developer API key (prefix `eng_`). Authenticates as the key's
        owner and resolves the account automatically.
      name: x-api-key
      in: header

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.