{
  "openapi": "3.1.0",
  "info": {
    "title": "Rippit API",
    "version": "1.0.0",
    "description": "Every operation is an MCP tool with the same name and parameters. The /v1 HTTP endpoints are not available yet; call the tools through the Rippit MCP server."
  },
  "servers": [
    {
      "url": "https://api.rippit.com"
    }
  ],
  "security": [
    {
      "bearer": []
    }
  ],
  "components": {
    "securitySchemes": {
      "bearer": {
        "type": "http",
        "scheme": "bearer"
      }
    },
    "schemas": {
      "aggregate_table____schema0": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "columnId": {
                "type": "string",
                "minLength": 1,
                "description": "Column id, not its label."
              },
              "operator": {
                "type": "string",
                "enum": [
                  "=",
                  "!=",
                  ">",
                  "<",
                  ">=",
                  "<=",
                  "IN",
                  "NOT IN",
                  "LIKE",
                  "CONTAINS_ALL",
                  "ANY",
                  "ALL",
                  "NONE",
                  "NOT_EMPTY",
                  "EMPTY",
                  "IS",
                  "IS NOT"
                ],
                "description": "IN/NOT IN match exact values or array elements; CONTAINS_ALL needs all. ANY/ALL/NONE: case-insensitive substring matches, never for id columns (they over-match). LIKE is case-sensitive and matches the whole value, so wrap a substring in `%`."
              },
              "value": {
                "description": "Array for multi-value operators (ANY/ALL/NONE: at most 250 strings). singleSelect columns store option ids (opt_*): filter by id; a label matches no rows. describe_column with `search` resolves a label to its id. A time without an offset in a comparison is a clock time, in the reported timezone or UTC.",
                "anyOf": [
                  {
                    "type": [
                      "string",
                      "number",
                      "boolean",
                      "null"
                    ]
                  },
                  {
                    "type": "array",
                    "items": {
                      "type": [
                        "string",
                        "number",
                        "boolean",
                        "null"
                      ]
                    }
                  }
                ]
              }
            },
            "required": [
              "columnId",
              "operator"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "columnId": {
                "type": "string",
                "minLength": 1,
                "description": "Date column id."
              },
              "operator": {
                "type": "string",
                "const": "BETWEEN"
              },
              "date_from": {
                "type": "string",
                "description": "Inclusive. Plain dates cover whole days, and times without an offset are clock times, in the reported timezone or UTC."
              },
              "date_to": {
                "type": "string",
                "description": "Inclusive; a plain date covers that whole day."
              }
            },
            "required": [
              "columnId",
              "operator",
              "date_from",
              "date_to"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "columnId": {
                "type": "string",
                "minLength": 1,
                "description": "Date column id."
              },
              "period": {
                "type": "object",
                "properties": {
                  "n": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991,
                    "description": "Signed units; negative values reach into the past."
                  },
                  "unit": {
                    "type": "string",
                    "enum": [
                      "hours",
                      "days",
                      "weeks",
                      "months",
                      "years"
                    ]
                  }
                },
                "required": [
                  "n",
                  "unit"
                ],
                "additionalProperties": false,
                "description": "Whole days in the read timezone, including today: { n: -7, unit: \"days\" } keeps today and the six prior days. Months/years follow the calendar; hours are exact. Reads re-resolve; worksheets keep a snapshot."
              },
              "offset": {
                "description": "Shifts the anchor before period applies; { n: -1, unit: \"weeks\" } moves it one week into the past.",
                "type": "object",
                "properties": {
                  "n": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991,
                    "description": "Signed units; negative values reach into the past."
                  },
                  "unit": {
                    "type": "string",
                    "enum": [
                      "hours",
                      "days",
                      "weeks",
                      "months",
                      "years"
                    ]
                  }
                },
                "required": [
                  "n",
                  "unit"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "columnId",
              "period"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "or_filters": {
                "minItems": 1,
                "type": "array",
                "items": {
                  "minItems": 1,
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/aggregate_table____schema0"
                  }
                },
                "description": "ORs branches of ANDed items."
              }
            },
            "required": [
              "or_filters"
            ],
            "additionalProperties": false
          }
        ]
      },
      "create_worksheet____schema0": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "columnId": {
                "type": "string",
                "minLength": 1,
                "description": "Column id, not its label."
              },
              "operator": {
                "type": "string",
                "enum": [
                  "=",
                  "!=",
                  ">",
                  "<",
                  ">=",
                  "<=",
                  "IN",
                  "NOT IN",
                  "LIKE",
                  "CONTAINS_ALL",
                  "ANY",
                  "ALL",
                  "NONE",
                  "NOT_EMPTY",
                  "EMPTY",
                  "IS",
                  "IS NOT"
                ],
                "description": "IN/NOT IN match exact values or array elements; CONTAINS_ALL needs all. ANY/ALL/NONE: case-insensitive substring matches, never for id columns (they over-match). LIKE is case-sensitive and matches the whole value, so wrap a substring in `%`."
              },
              "value": {
                "description": "Array for multi-value operators (ANY/ALL/NONE: at most 250 strings). singleSelect columns store option ids (opt_*): filter by id; a label matches no rows. describe_column with `search` resolves a label to its id. A time without an offset in a comparison is a clock time, in the reported timezone or UTC.",
                "anyOf": [
                  {
                    "type": [
                      "string",
                      "number",
                      "boolean",
                      "null"
                    ]
                  },
                  {
                    "type": "array",
                    "items": {
                      "type": [
                        "string",
                        "number",
                        "boolean",
                        "null"
                      ]
                    }
                  }
                ]
              }
            },
            "required": [
              "columnId",
              "operator"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "columnId": {
                "type": "string",
                "minLength": 1,
                "description": "Date column id."
              },
              "operator": {
                "type": "string",
                "const": "BETWEEN"
              },
              "date_from": {
                "type": "string",
                "description": "Inclusive. Plain dates cover whole days, and times without an offset are clock times, in the reported timezone or UTC."
              },
              "date_to": {
                "type": "string",
                "description": "Inclusive; a plain date covers that whole day."
              }
            },
            "required": [
              "columnId",
              "operator",
              "date_from",
              "date_to"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "columnId": {
                "type": "string",
                "minLength": 1,
                "description": "Date column id."
              },
              "period": {
                "type": "object",
                "properties": {
                  "n": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991,
                    "description": "Signed units; negative values reach into the past."
                  },
                  "unit": {
                    "type": "string",
                    "enum": [
                      "hours",
                      "days",
                      "weeks",
                      "months",
                      "years"
                    ]
                  }
                },
                "required": [
                  "n",
                  "unit"
                ],
                "additionalProperties": false,
                "description": "Whole days in the read timezone, including today: { n: -7, unit: \"days\" } keeps today and the six prior days. Months/years follow the calendar; hours are exact. Reads re-resolve; worksheets keep a snapshot."
              },
              "offset": {
                "description": "Shifts the anchor before period applies; { n: -1, unit: \"weeks\" } moves it one week into the past.",
                "type": "object",
                "properties": {
                  "n": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991,
                    "description": "Signed units; negative values reach into the past."
                  },
                  "unit": {
                    "type": "string",
                    "enum": [
                      "hours",
                      "days",
                      "weeks",
                      "months",
                      "years"
                    ]
                  }
                },
                "required": [
                  "n",
                  "unit"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "columnId",
              "period"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "or_filters": {
                "minItems": 1,
                "type": "array",
                "items": {
                  "minItems": 1,
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/create_worksheet____schema0"
                  }
                },
                "description": "ORs branches of ANDed items."
              }
            },
            "required": [
              "or_filters"
            ],
            "additionalProperties": false
          }
        ]
      },
      "enrich_worksheet____schema0": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "columnId": {
                "type": "string",
                "minLength": 1,
                "description": "Column id, not its label."
              },
              "operator": {
                "type": "string",
                "enum": [
                  "=",
                  "!=",
                  ">",
                  "<",
                  ">=",
                  "<=",
                  "IN",
                  "NOT IN",
                  "LIKE",
                  "CONTAINS_ALL",
                  "ANY",
                  "ALL",
                  "NONE",
                  "NOT_EMPTY",
                  "EMPTY",
                  "IS",
                  "IS NOT"
                ],
                "description": "IN/NOT IN match exact values or array elements; CONTAINS_ALL needs all. ANY/ALL/NONE: case-insensitive substring matches, never for id columns (they over-match). LIKE is case-sensitive and matches the whole value, so wrap a substring in `%`."
              },
              "value": {
                "description": "Array for multi-value operators (ANY/ALL/NONE: at most 250 strings). singleSelect columns store option ids (opt_*): filter by id; a label matches no rows. describe_column with `search` resolves a label to its id. A time without an offset in a comparison is a clock time, in the reported timezone or UTC.",
                "anyOf": [
                  {
                    "type": [
                      "string",
                      "number",
                      "boolean",
                      "null"
                    ]
                  },
                  {
                    "type": "array",
                    "items": {
                      "type": [
                        "string",
                        "number",
                        "boolean",
                        "null"
                      ]
                    }
                  }
                ]
              }
            },
            "required": [
              "columnId",
              "operator"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "columnId": {
                "type": "string",
                "minLength": 1,
                "description": "Date column id."
              },
              "operator": {
                "type": "string",
                "const": "BETWEEN"
              },
              "date_from": {
                "type": "string",
                "description": "Inclusive. Plain dates cover whole days, and times without an offset are clock times, in the reported timezone or UTC."
              },
              "date_to": {
                "type": "string",
                "description": "Inclusive; a plain date covers that whole day."
              }
            },
            "required": [
              "columnId",
              "operator",
              "date_from",
              "date_to"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "columnId": {
                "type": "string",
                "minLength": 1,
                "description": "Date column id."
              },
              "period": {
                "type": "object",
                "properties": {
                  "n": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991,
                    "description": "Signed units; negative values reach into the past."
                  },
                  "unit": {
                    "type": "string",
                    "enum": [
                      "hours",
                      "days",
                      "weeks",
                      "months",
                      "years"
                    ]
                  }
                },
                "required": [
                  "n",
                  "unit"
                ],
                "additionalProperties": false,
                "description": "Whole days in the read timezone, including today: { n: -7, unit: \"days\" } keeps today and the six prior days. Months/years follow the calendar; hours are exact. Reads re-resolve; worksheets keep a snapshot."
              },
              "offset": {
                "description": "Shifts the anchor before period applies; { n: -1, unit: \"weeks\" } moves it one week into the past.",
                "type": "object",
                "properties": {
                  "n": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991,
                    "description": "Signed units; negative values reach into the past."
                  },
                  "unit": {
                    "type": "string",
                    "enum": [
                      "hours",
                      "days",
                      "weeks",
                      "months",
                      "years"
                    ]
                  }
                },
                "required": [
                  "n",
                  "unit"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "columnId",
              "period"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "or_filters": {
                "minItems": 1,
                "type": "array",
                "items": {
                  "minItems": 1,
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/enrich_worksheet____schema0"
                  }
                },
                "description": "ORs branches of ANDed items."
              }
            },
            "required": [
              "or_filters"
            ],
            "additionalProperties": false
          }
        ]
      },
      "pivot_table____schema0": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "columnId": {
                "type": "string",
                "minLength": 1,
                "description": "Column id, not its label."
              },
              "operator": {
                "type": "string",
                "enum": [
                  "=",
                  "!=",
                  ">",
                  "<",
                  ">=",
                  "<=",
                  "IN",
                  "NOT IN",
                  "LIKE",
                  "CONTAINS_ALL",
                  "ANY",
                  "ALL",
                  "NONE",
                  "NOT_EMPTY",
                  "EMPTY",
                  "IS",
                  "IS NOT"
                ],
                "description": "IN/NOT IN match exact values or array elements; CONTAINS_ALL needs all. ANY/ALL/NONE: case-insensitive substring matches, never for id columns (they over-match). LIKE is case-sensitive and matches the whole value, so wrap a substring in `%`."
              },
              "value": {
                "description": "Array for multi-value operators (ANY/ALL/NONE: at most 250 strings). singleSelect columns store option ids (opt_*): filter by id; a label matches no rows. describe_column with `search` resolves a label to its id. A time without an offset in a comparison is a clock time, in the reported timezone or UTC.",
                "anyOf": [
                  {
                    "type": [
                      "string",
                      "number",
                      "boolean",
                      "null"
                    ]
                  },
                  {
                    "type": "array",
                    "items": {
                      "type": [
                        "string",
                        "number",
                        "boolean",
                        "null"
                      ]
                    }
                  }
                ]
              }
            },
            "required": [
              "columnId",
              "operator"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "columnId": {
                "type": "string",
                "minLength": 1,
                "description": "Date column id."
              },
              "operator": {
                "type": "string",
                "const": "BETWEEN"
              },
              "date_from": {
                "type": "string",
                "description": "Inclusive. Plain dates cover whole days, and times without an offset are clock times, in the reported timezone or UTC."
              },
              "date_to": {
                "type": "string",
                "description": "Inclusive; a plain date covers that whole day."
              }
            },
            "required": [
              "columnId",
              "operator",
              "date_from",
              "date_to"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "columnId": {
                "type": "string",
                "minLength": 1,
                "description": "Date column id."
              },
              "period": {
                "type": "object",
                "properties": {
                  "n": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991,
                    "description": "Signed units; negative values reach into the past."
                  },
                  "unit": {
                    "type": "string",
                    "enum": [
                      "hours",
                      "days",
                      "weeks",
                      "months",
                      "years"
                    ]
                  }
                },
                "required": [
                  "n",
                  "unit"
                ],
                "additionalProperties": false,
                "description": "Whole days in the read timezone, including today: { n: -7, unit: \"days\" } keeps today and the six prior days. Months/years follow the calendar; hours are exact. Reads re-resolve; worksheets keep a snapshot."
              },
              "offset": {
                "description": "Shifts the anchor before period applies; { n: -1, unit: \"weeks\" } moves it one week into the past.",
                "type": "object",
                "properties": {
                  "n": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991,
                    "description": "Signed units; negative values reach into the past."
                  },
                  "unit": {
                    "type": "string",
                    "enum": [
                      "hours",
                      "days",
                      "weeks",
                      "months",
                      "years"
                    ]
                  }
                },
                "required": [
                  "n",
                  "unit"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "columnId",
              "period"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "or_filters": {
                "minItems": 1,
                "type": "array",
                "items": {
                  "minItems": 1,
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/pivot_table____schema0"
                  }
                },
                "description": "ORs branches of ANDed items."
              }
            },
            "required": [
              "or_filters"
            ],
            "additionalProperties": false
          }
        ]
      },
      "read_table____schema0": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "columnId": {
                "type": "string",
                "minLength": 1,
                "description": "Column id, not its label."
              },
              "operator": {
                "type": "string",
                "enum": [
                  "=",
                  "!=",
                  ">",
                  "<",
                  ">=",
                  "<=",
                  "IN",
                  "NOT IN",
                  "LIKE",
                  "CONTAINS_ALL",
                  "ANY",
                  "ALL",
                  "NONE",
                  "NOT_EMPTY",
                  "EMPTY",
                  "IS",
                  "IS NOT"
                ],
                "description": "IN/NOT IN match exact values or array elements; CONTAINS_ALL needs all. ANY/ALL/NONE: case-insensitive substring matches, never for id columns (they over-match). LIKE is case-sensitive and matches the whole value, so wrap a substring in `%`."
              },
              "value": {
                "description": "Array for multi-value operators (ANY/ALL/NONE: at most 250 strings). singleSelect columns store option ids (opt_*): filter by id; a label matches no rows. describe_column with `search` resolves a label to its id. A time without an offset in a comparison is a clock time, in the reported timezone or UTC.",
                "anyOf": [
                  {
                    "type": [
                      "string",
                      "number",
                      "boolean",
                      "null"
                    ]
                  },
                  {
                    "type": "array",
                    "items": {
                      "type": [
                        "string",
                        "number",
                        "boolean",
                        "null"
                      ]
                    }
                  }
                ]
              }
            },
            "required": [
              "columnId",
              "operator"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "columnId": {
                "type": "string",
                "minLength": 1,
                "description": "Date column id."
              },
              "operator": {
                "type": "string",
                "const": "BETWEEN"
              },
              "date_from": {
                "type": "string",
                "description": "Inclusive. Plain dates cover whole days, and times without an offset are clock times, in the reported timezone or UTC."
              },
              "date_to": {
                "type": "string",
                "description": "Inclusive; a plain date covers that whole day."
              }
            },
            "required": [
              "columnId",
              "operator",
              "date_from",
              "date_to"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "columnId": {
                "type": "string",
                "minLength": 1,
                "description": "Date column id."
              },
              "period": {
                "type": "object",
                "properties": {
                  "n": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991,
                    "description": "Signed units; negative values reach into the past."
                  },
                  "unit": {
                    "type": "string",
                    "enum": [
                      "hours",
                      "days",
                      "weeks",
                      "months",
                      "years"
                    ]
                  }
                },
                "required": [
                  "n",
                  "unit"
                ],
                "additionalProperties": false,
                "description": "Whole days in the read timezone, including today: { n: -7, unit: \"days\" } keeps today and the six prior days. Months/years follow the calendar; hours are exact. Reads re-resolve; worksheets keep a snapshot."
              },
              "offset": {
                "description": "Shifts the anchor before period applies; { n: -1, unit: \"weeks\" } moves it one week into the past.",
                "type": "object",
                "properties": {
                  "n": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991,
                    "description": "Signed units; negative values reach into the past."
                  },
                  "unit": {
                    "type": "string",
                    "enum": [
                      "hours",
                      "days",
                      "weeks",
                      "months",
                      "years"
                    ]
                  }
                },
                "required": [
                  "n",
                  "unit"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "columnId",
              "period"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "or_filters": {
                "minItems": 1,
                "type": "array",
                "items": {
                  "minItems": 1,
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/read_table____schema0"
                  }
                },
                "description": "ORs branches of ANDed items."
              }
            },
            "required": [
              "or_filters"
            ],
            "additionalProperties": false
          }
        ]
      }
    },
    "responses": {
      "400": {
        "description": "The arguments have a valid shape but refer to ids or values Rippit rejects. The same call fails again. Through MCP this is a tool result with `isError: true` whose text gives the status and a `Reference` id. See [Errors](/api-reference/errors)."
      },
      "401": {
        "description": "The sign-in or token is no longer accepted. Sign in again, or reconnect Rippit in your assistant. Through MCP this is a tool result with `isError: true` whose text gives the status and a `Reference` id. See [Errors](/api-reference/errors)."
      },
      "402": {
        "description": "The workspace reached its AI spend limit or is out of Credits. See [Billing and Credits](/billing). Through MCP this is a tool result with `isError: true` whose text gives the status and a `Reference` id. See [Errors](/api-reference/errors)."
      },
      "403": {
        "description": "The user or workspace is not allowed to do this. Through MCP this is a tool result with `isError: true` whose text gives the status and a `Reference` id. See [Errors](/api-reference/errors)."
      },
      "404": {
        "description": "An id in the call matches nothing you can see. Through MCP this is a tool result with `isError: true` whose text gives the status and a `Reference` id. See [Errors](/api-reference/errors)."
      },
      "422": {
        "description": "The service does not accept one of the values. The message names the field. Through MCP this is a tool result with `isError: true` whose text gives the status and a `Reference` id. See [Errors](/api-reference/errors)."
      },
      "429": {
        "description": "The call was rate limited and did not run. Wait a second and retry. See [Rate limits](/api-reference/rate-limits). Through MCP this is a tool result with `isError: true` whose text gives the status and a `Reference` id. See [Errors](/api-reference/errors)."
      },
      "504": {
        "description": "The call timed out. For a read, ask for fewer rows or columns, or a narrower filter. Through MCP this is a tool result with `isError: true` whose text gives the status and a `Reference` id. See [Errors](/api-reference/errors)."
      },
      "5XX": {
        "description": "A Rippit service error. Retry a read; check before repeating a write. See [Idempotency and retries](/api-reference/idempotency). Through MCP this is a tool result with `isError: true` whose text gives the status and a `Reference` id. See [Errors](/api-reference/errors)."
      }
    }
  },
  "paths": {
    "/v1/aggregate_table": {
      "post": {
        "operationId": "aggregate_table",
        "summary": "aggregate_table",
        "description": "Compute measures over a table or worksheet, optionally grouped; pivot_table lays measures out as a cross-tab of row and column dimensions with totals, and read_table returns individual rows. Array columns group on the whole array value unless expanded with `arrayExpansions`. singleSelect values are option ids that `columns[].options` maps to labels. `pagination.truncated` means more groups exist than were returned.\n\nThis operation is an MCP tool today. Call it through the [Rippit MCP server](/mcp-server/overview) with the same name and parameters. The HTTP endpoint is not available yet.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "tableId": {
                    "type": "string",
                    "minLength": 1,
                    "pattern": "^[A-Za-z0-9_-]+$",
                    "description": "Data table or worksheet id."
                  },
                  "select": {
                    "minItems": 1,
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "columnId": {
                          "type": "string",
                          "minLength": 1,
                          "description": "Column id, not its label."
                        },
                        "agg": {
                          "type": "string",
                          "enum": [
                            "count",
                            "count_distinct",
                            "sum",
                            "avg",
                            "min",
                            "max",
                            "stddev_pop",
                            "stddev_samp"
                          ]
                        },
                        "alias": {
                          "description": "Result key for the measure; defaults to `<columnId>_<agg>`.",
                          "type": "string",
                          "minLength": 1
                        }
                      },
                      "required": [
                        "columnId",
                        "agg"
                      ],
                      "additionalProperties": false
                    },
                    "description": "Measures to compute; grouped columns appear in results without an entry here."
                  },
                  "groupBy": {
                    "description": "Omit for one scalar row over the whole table.",
                    "maxItems": 10,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "columnId": {
                          "type": "string",
                          "minLength": 1,
                          "description": "Column id, not its label."
                        },
                        "dateTrunc": {
                          "description": "Date grain; the result key becomes `<columnId>_<dateTrunc>`. `option` is a synonym.",
                          "type": "string",
                          "enum": [
                            "minute",
                            "hour",
                            "day",
                            "week",
                            "month",
                            "year"
                          ]
                        }
                      },
                      "required": [
                        "columnId"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "where": {
                    "description": "Filters rows before aggregation.",
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "$ref": "#/components/schemas/aggregate_table____schema0"
                    }
                  },
                  "arrayExpansions": {
                    "description": "Explode array columns into one row per element, referenced by alias; empty arrays yield no rows, and counts describe elements, not records.",
                    "maxItems": 3,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "columnId": {
                          "type": "string",
                          "minLength": 1,
                          "description": "Array column id."
                        },
                        "alias": {
                          "type": "string",
                          "pattern": "^[A-Za-z][A-Za-z0-9_]*$",
                          "description": "Unused column id for the elements."
                        }
                      },
                      "required": [
                        "columnId",
                        "alias"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "having": {
                    "description": "AND-combined filters on measure values, applied after aggregation and before sorting and paging.",
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "alias": {
                          "type": "string",
                          "minLength": 1,
                          "description": "A selected measure alias."
                        },
                        "operator": {
                          "type": "string",
                          "enum": [
                            "=",
                            "!=",
                            ">",
                            "<",
                            ">=",
                            "<=",
                            "IS",
                            "IS NOT"
                          ],
                          "description": "IS and IS NOT compare with null."
                        },
                        "value": {
                          "description": "Literal threshold; dates as ISO 8601 strings.",
                          "type": [
                            "string",
                            "number",
                            "boolean",
                            "null"
                          ]
                        }
                      },
                      "required": [
                        "alias",
                        "operator",
                        "value"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "orderBy": {
                    "description": "Sort keys in priority order; defaults to the first groupBy column, ascending.",
                    "maxItems": 10,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "alias": {
                          "type": "string",
                          "minLength": 1,
                          "description": "Result key: a measure alias, a groupBy column id or `<columnId>_<dateTrunc>`."
                        },
                        "direction": {
                          "description": "Defaults to ascending.",
                          "type": "string",
                          "enum": [
                            "asc",
                            "desc"
                          ]
                        }
                      },
                      "required": [
                        "alias"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "limit": {
                    "description": "Defaults to 100.",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 10000
                  },
                  "offset": {
                    "description": "Zero-based offset over groups.",
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  }
                },
                "required": [
                  "tableId",
                  "select"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Tool result."
          },
          "400": {
            "$ref": "#/components/responses/400"
          },
          "401": {
            "$ref": "#/components/responses/401"
          },
          "402": {
            "$ref": "#/components/responses/402"
          },
          "403": {
            "$ref": "#/components/responses/403"
          },
          "404": {
            "$ref": "#/components/responses/404"
          },
          "422": {
            "$ref": "#/components/responses/422"
          },
          "429": {
            "$ref": "#/components/responses/429"
          },
          "504": {
            "$ref": "#/components/responses/504"
          },
          "5XX": {
            "$ref": "#/components/responses/5XX"
          }
        },
        "x-mint": {
          "metadata": {
            "playground": "none"
          }
        }
      }
    },
    "/v1/connect_integration": {
      "post": {
        "operationId": "connect_integration",
        "summary": "connect_integration",
        "description": "Create a requester-only authorization link for Zendesk, Intercom, Slack ingestion, Salesforce, Gong, Pylon, Gorgias, Freshdesk, Decagon, Granola, Fireflies, Attention, Nooks, Kustomer, Ada, or Sierra. Use only after the user requests the connection; get_integration_state confirms the destination workspace and supported providers. Reuse an already authenticated connection when it is the one the user wants. For API-key providers, pass only source; the user enters credentials and any provider configuration in the browser form. Attention also handles the import-scope choice there. Nooks, Kustomer, Ada, and Sierra require workspace beta access.\n\nFor Salesforce, confirm Service Cloud, Sales Cloud, or both and whether this is a sandbox. Pass serviceCloud and salesCloud explicitly; isSandbox true uses sandbox login. Salesforce is available only for enabled PLG or hybrid workspaces. Authorization does not select which objects to import.\n\nClients supporting URL elicitation display an authorization prompt outside the model conversation. After the user continues, this call verifies the same stored request. If authorizationMode is url_elicitation, do not claim that no prompt appeared because it is absent from the transcript. Otherwise, show authorizationUrl and ask the user to open it. They must sign into the same Rippit account, review the destination workspace, and authorize the provider in the browser. Never ask for passwords, API keys, access tokens, or authorization codes in chat. This authorizes data access only; importing is a separate step. For Slack, the bot can read only channels it has access to; ask the user to add it to the channels they want imported.\n\nRetain request.id. After the 30-minute native prompt window expires, the transport returns url_elicitation_expired and the original requestId; if the client does not resume, tell the user to return and say Done, then check that exact request with get_integration_state rather than creating another. Do not create another link while one is pending unless the user requests a replacement.\n\nThis operation is an MCP tool today. Call it through the [Rippit MCP server](/mcp-server/overview) with the same name and parameters. The HTTP endpoint is not available yet.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "provider": {
                    "oneOf": [
                      {
                        "type": "object",
                        "properties": {
                          "source": {
                            "type": "string",
                            "const": "zendesk"
                          },
                          "subdomain": {
                            "type": "string",
                            "minLength": 1,
                            "pattern": "^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$",
                            "description": "Zendesk subdomain without .zendesk.com."
                          }
                        },
                        "required": [
                          "source",
                          "subdomain"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "source": {
                            "type": "string",
                            "const": "intercom"
                          },
                          "regionCode": {
                            "type": "string",
                            "enum": [
                              "us",
                              "eu",
                              "au"
                            ],
                            "description": "Intercom data hosting region."
                          }
                        },
                        "required": [
                          "source",
                          "regionCode"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "source": {
                            "type": "string",
                            "const": "slack_ingest"
                          }
                        },
                        "required": [
                          "source"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "source": {
                            "type": "string",
                            "enum": [
                              "gong",
                              "pylon",
                              "gorgias",
                              "freshdesk",
                              "decagon",
                              "granola",
                              "fireflies",
                              "attention",
                              "nooks",
                              "kustomer",
                              "ada",
                              "sierra"
                            ]
                          }
                        },
                        "required": [
                          "source"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "source": {
                            "type": "string",
                            "const": "salesforce"
                          },
                          "serviceCloud": {
                            "type": "boolean",
                            "description": "Enable Service Cloud and verify read access to Cases."
                          },
                          "salesCloud": {
                            "type": "boolean",
                            "description": "Enable Sales Cloud and verify read access to Opportunities."
                          },
                          "isSandbox": {
                            "description": "True for a Salesforce sandbox; omitted or false uses production login.",
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "source",
                          "serviceCloud",
                          "salesCloud"
                        ],
                        "additionalProperties": false
                      }
                    ],
                    "description": "Provider the user asked to connect to the displayed Rippit workspace."
                  }
                },
                "required": [
                  "provider"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Tool result."
          },
          "400": {
            "$ref": "#/components/responses/400"
          },
          "401": {
            "$ref": "#/components/responses/401"
          },
          "402": {
            "$ref": "#/components/responses/402"
          },
          "403": {
            "$ref": "#/components/responses/403"
          },
          "404": {
            "$ref": "#/components/responses/404"
          },
          "422": {
            "$ref": "#/components/responses/422"
          },
          "429": {
            "$ref": "#/components/responses/429"
          },
          "504": {
            "$ref": "#/components/responses/504"
          },
          "5XX": {
            "$ref": "#/components/responses/5XX"
          }
        },
        "x-mint": {
          "metadata": {
            "playground": "none"
          }
        }
      }
    },
    "/v1/create_integration_tables": {
      "post": {
        "operationId": "create_integration_tables",
        "summary": "create_integration_tables",
        "description": "Add up to 10 objects from a connected integration as data tables in one call; split a larger request into calls of 10. Every object is checked against that connection first, and the create call is not made unless all of them are available. Columns are the connection's default first 500; do not ask the user which fields to include. Each object gets a `result` of `created` (including a table the connection already had) or `failed`, with an `error` explaining a failure when one is given. One table failing does not stop the others. To retry, pass only the `failed` objects; an existing table is never created twice.\nPass etl_id from list_active_integrations.\n\nThis operation is an MCP tool today. Call it through the [Rippit MCP server](/mcp-server/overview) with the same name and parameters. The HTTP endpoint is not available yet.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "etl_id": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991,
                    "description": "ETL id of the connected integration, from list_active_integrations."
                  },
                  "objects": {
                    "minItems": 1,
                    "maxItems": 10,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1
                    },
                    "description": "Integration object names to add as tables on this connection, such as Salesforce object names. At most 10 per call. Every name is checked against the connection before any table is created."
                  }
                },
                "required": [
                  "etl_id",
                  "objects"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Tool result."
          }
        },
        "x-mint": {
          "metadata": {
            "playground": "none"
          }
        }
      }
    },
    "/v1/create_worksheet": {
      "post": {
        "operationId": "create_worksheet",
        "summary": "create_worksheet",
        "description": "Create a saved analysis worksheet from table rows, with support for AI and formula columns; read_table and aggregate_table query existing columns. Added columns can be inspected, filtered, aggregated and reused, and the source table is unchanged.\n\nAt most 10000 rows are copied (server-enforced). When more rows match and neither `rowLimit` nor `sampleRows` is set, the kept rows are an arbitrary subset, not a random sample; `rowsMatchingFilter` (or `rowsBefore` without a filter) above `rowsAfter` shows the cut. Admin-configured Table View filters apply before `where`, and the counts include them.\n\nThe worksheet exists when this returns, but its rows load asynchronously, so it can briefly read as empty and `rowsAfter` can be absent. A large source can outlast the call's timeout while the server keeps working; a blind retry then creates a duplicate worksheet, and list_worksheets shows whether the first one was created.\n\nThis operation is an MCP tool today. Call it through the [Rippit MCP server](/mcp-server/overview) with the same name and parameters. The HTTP endpoint is not available yet.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "tableId": {
                    "type": "string",
                    "minLength": 1,
                    "pattern": "^[A-Za-z0-9_-]+$",
                    "description": "Source Rippit table id: a custom data table or a worksheet."
                  },
                  "title": {
                    "description": "Worksheet display name; defaults to \"Untitled Worksheet\".",
                    "type": "string",
                    "maxLength": 200
                  },
                  "where": {
                    "description": "Filters on source rows, combined with AND (`or_filters` groups OR); omitted copies the whole table.",
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "$ref": "#/components/schemas/create_worksheet____schema0"
                    }
                  },
                  "columnIds": {
                    "description": "Source column ids to copy; omitted copies every non-system column. A narrowed list keeps `ticket_sid` or the column whose kind is `external_gradable_reference`, or enrichment cannot read the conversations.",
                    "maxItems": 200,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1
                    }
                  },
                  "workbookId": {
                    "description": "Existing workbook for the worksheet; omitted creates a new workbook.",
                    "type": "string",
                    "minLength": 1
                  },
                  "rowLimit": {
                    "description": "Keep the N most recent rows by row date after `where` (an arbitrary N without a row-date column). Not combinable with `sampleRows`.",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 10000
                  },
                  "sampleRows": {
                    "description": "Keep a uniform random sample of N rows drawn after `where`, fresh on each call. Not combinable with `rowLimit`.",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 10000
                  }
                },
                "required": [
                  "tableId"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Tool result."
          },
          "400": {
            "$ref": "#/components/responses/400"
          },
          "401": {
            "$ref": "#/components/responses/401"
          },
          "402": {
            "$ref": "#/components/responses/402"
          },
          "403": {
            "$ref": "#/components/responses/403"
          },
          "404": {
            "$ref": "#/components/responses/404"
          },
          "422": {
            "$ref": "#/components/responses/422"
          },
          "429": {
            "$ref": "#/components/responses/429"
          },
          "504": {
            "$ref": "#/components/responses/504"
          },
          "5XX": {
            "$ref": "#/components/responses/5XX"
          }
        },
        "x-mint": {
          "metadata": {
            "playground": "none"
          }
        }
      }
    },
    "/v1/describe_column": {
      "post": {
        "operationId": "describe_column",
        "summary": "describe_column",
        "description": "Describe one column of a table or worksheet, in the shape describe_table uses for every column: type, label, full description and, for enum and select columns, its values. For an AI enrichment column, `description` is the prompt that fills each row. Entity-reference columns (agents, agent groups) filter by id and do not list their values. Works on worksheets and customDataTables only.\n\nThis operation is an MCP tool today. Call it through the [Rippit MCP server](/mcp-server/overview) with the same name and parameters. The HTTP endpoint is not available yet.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "tableId": {
                    "type": "string",
                    "minLength": 1,
                    "pattern": "^[A-Za-z0-9_-]+$",
                    "description": "Data table or worksheet id."
                  },
                  "columnId": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Column id, not its label."
                  },
                  "search": {
                    "description": "Case-insensitive substring that resolves to filter values: agent and group names to their ids, select option labels to `opt_*` ids, label-mapped names to their ids, and other categorical columns to matching stored values.",
                    "type": "string",
                    "minLength": 1
                  }
                },
                "required": [
                  "tableId",
                  "columnId"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Tool result."
          },
          "400": {
            "$ref": "#/components/responses/400"
          },
          "401": {
            "$ref": "#/components/responses/401"
          },
          "402": {
            "$ref": "#/components/responses/402"
          },
          "403": {
            "$ref": "#/components/responses/403"
          },
          "404": {
            "$ref": "#/components/responses/404"
          },
          "422": {
            "$ref": "#/components/responses/422"
          },
          "429": {
            "$ref": "#/components/responses/429"
          },
          "504": {
            "$ref": "#/components/responses/504"
          },
          "5XX": {
            "$ref": "#/components/responses/5XX"
          }
        },
        "x-mint": {
          "metadata": {
            "playground": "none"
          }
        }
      }
    },
    "/v1/describe_snowflake_table": {
      "post": {
        "operationId": "describe_snowflake_table",
        "summary": "describe_snowflake_table",
        "description": "Read the columns of a table in the customer's own Snowflake account, before importing it. Not for Rippit tables — use describe_table for those.\n\nHow to use:\n- Pick the import's `primary_keys` and `updated_at_column` from these columns. Snowflake rarely declares primary keys, so an empty `primary_keys` is normal: choose the column(s) that uniquely identify a row.\n- `merge_keys` is the key the pipeline itself loads on, derived from the last 7 days of successful MERGE, DELETE and UPDATE statements in Snowflake's query history. It's the strongest evidence for `primary_keys`. If the import rejects it for duplicates, report that as an upstream data bug and show the user the stats; don't swap in other columns. It's empty when no load matched or the role can't read query history.\n- `merge_updated_at` is the best `updated_at_column` when it comes from that same query history: the column in the pipeline's own incremental `> (SELECT MAX(col) ...)` filter. Without one, it's a guess: the only timestamp column named like updated, modified or loaded, or an ETL tool's sync column such as `_fivetran_synced` or `_airbyte_extracted_at`.\n- Workspace admins only; anyone else gets a 403 on every Snowflake call, so don't retry.\n\nThis operation is an MCP tool today. Call it through the [Rippit MCP server](/mcp-server/overview) with the same name and parameters. The HTTP endpoint is not available yet.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "connection_id": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Snowflake connection id from list_snowflake_connections."
                  },
                  "database": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 256,
                    "description": "Snowflake database, exactly as Snowflake lists it."
                  },
                  "schema_name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 256,
                    "description": "Snowflake schema, exactly as Snowflake lists it."
                  },
                  "table": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 256,
                    "description": "Snowflake table, exactly as Snowflake lists it."
                  }
                },
                "required": [
                  "connection_id",
                  "database",
                  "schema_name",
                  "table"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Tool result."
          },
          "400": {
            "$ref": "#/components/responses/400"
          },
          "401": {
            "$ref": "#/components/responses/401"
          },
          "402": {
            "$ref": "#/components/responses/402"
          },
          "403": {
            "$ref": "#/components/responses/403"
          },
          "404": {
            "$ref": "#/components/responses/404"
          },
          "422": {
            "$ref": "#/components/responses/422"
          },
          "429": {
            "$ref": "#/components/responses/429"
          },
          "504": {
            "$ref": "#/components/responses/504"
          },
          "5XX": {
            "$ref": "#/components/responses/5XX"
          }
        },
        "x-mint": {
          "metadata": {
            "playground": "none"
          }
        }
      }
    },
    "/v1/describe_table": {
      "post": {
        "operationId": "describe_table",
        "summary": "describe_table",
        "description": "Describe the columns of a table or worksheet: type, description (cut at 200 characters; describe_column covers a single column in full), and values for enum and select columns. Data tables also list numeric ranges and the distinct values of low-cardinality text columns. Columns with `entity_reference` or `label_mapped` hold ids, so filter them by id. Works on worksheets and customDataTables only.\n\nThe result opens with a Data coverage block. Its Sync window line is the floor of what data exists, and its row count applies the table's admin Table View filters. Column profiles ignore those filters, so a listed value can match no rows in reads and aggregations.\n\nThis operation is an MCP tool today. Call it through the [Rippit MCP server](/mcp-server/overview) with the same name and parameters. The HTTP endpoint is not available yet.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "tableId": {
                    "type": "string",
                    "minLength": 1,
                    "pattern": "^[A-Za-z0-9_-]+$",
                    "description": "Data table or worksheet id."
                  }
                },
                "required": [
                  "tableId"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Tool result."
          },
          "400": {
            "$ref": "#/components/responses/400"
          },
          "401": {
            "$ref": "#/components/responses/401"
          },
          "402": {
            "$ref": "#/components/responses/402"
          },
          "403": {
            "$ref": "#/components/responses/403"
          },
          "404": {
            "$ref": "#/components/responses/404"
          },
          "422": {
            "$ref": "#/components/responses/422"
          },
          "429": {
            "$ref": "#/components/responses/429"
          },
          "504": {
            "$ref": "#/components/responses/504"
          },
          "5XX": {
            "$ref": "#/components/responses/5XX"
          }
        },
        "x-mint": {
          "metadata": {
            "playground": "none"
          }
        }
      }
    },
    "/v1/edit_table": {
      "post": {
        "operationId": "edit_table",
        "summary": "edit_table",
        "description": "Change the saved description or the saved column metadata of a table or worksheet, open or not. One kind of edit per call: `description` or `operations`.\n\nA non-empty description counts as user-written and automatic generation leaves it alone; clearing it lets generation write a new one. describe_table can show the previous description for up to a minute.\n\nLabels, visibility, pinning, order and width work on every table; wrap, format, groups and delete are worksheet-only. Delete removes any column from a worksheet; use it only when the user asks for it. Formula, notes, enrichment and option columns, and their computation, are edited by their own tools. Unmentioned columns and attributes stay unchanged. Creating or renaming a group issues a new group id, which read_table's `columns[].groupId` shows.\n\n`status: \"applied\"` means the edit is saved; after a column edit `updatedColumnIds` lists the changed columns.\n\nThis operation is an MCP tool today. Call it through the [Rippit MCP server](/mcp-server/overview) with the same name and parameters. The HTTP endpoint is not available yet.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "tableId": {
                    "type": "string",
                    "minLength": 1,
                    "pattern": "^[A-Za-z0-9_-]+$",
                    "description": "Id of a table or worksheet the user can edit."
                  },
                  "description": {
                    "description": "Replacement table description. An empty string clears it.",
                    "type": "string"
                  },
                  "operations": {
                    "description": "Column edits, applied in order.",
                    "minItems": 1,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "op": {
                              "type": "string",
                              "const": "rename",
                              "description": "Rename the visible column header."
                            },
                            "columnId": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Column id to rename."
                            },
                            "label": {
                              "type": "string",
                              "minLength": 1,
                              "description": "New visible column header. Must be non-blank."
                            }
                          },
                          "required": [
                            "op",
                            "columnId",
                            "label"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "op": {
                              "type": "string",
                              "const": "set_visibility",
                              "description": "Hide or show one column."
                            },
                            "columnId": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Column id whose visibility to change."
                            },
                            "hidden": {
                              "type": "boolean",
                              "description": "True hides; false shows."
                            }
                          },
                          "required": [
                            "op",
                            "columnId",
                            "hidden"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "op": {
                              "type": "string",
                              "const": "set_pinning",
                              "description": "Pin or unpin the column."
                            },
                            "columnId": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Column id whose pinning to change."
                            },
                            "pinned": {
                              "type": "boolean",
                              "description": "True pins; false unpins."
                            }
                          },
                          "required": [
                            "op",
                            "columnId",
                            "pinned"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "op": {
                              "type": "string",
                              "const": "reorder",
                              "description": "Move one column next to another, at most once per column per request. Crossing the pinned boundary requires an earlier set_pinning for that column in the same request."
                            },
                            "columnId": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Column id to move."
                            },
                            "anchorColumnId": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Column id to place this column relative to."
                            },
                            "position": {
                              "type": "string",
                              "enum": [
                                "before",
                                "after"
                              ]
                            },
                            "groupId": {
                              "description": "Worksheet-only column group change. Omit to preserve the current group; use null to ungroup.",
                              "anyOf": [
                                {
                                  "type": "string",
                                  "minLength": 1
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [
                            "op",
                            "columnId",
                            "anchorColumnId",
                            "position"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "op": {
                              "type": "string",
                              "const": "resize",
                              "description": "Change the column width."
                            },
                            "columnId": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Column id to resize."
                            },
                            "width": {
                              "type": "number",
                              "exclusiveMinimum": 0,
                              "description": "Pixels."
                            }
                          },
                          "required": [
                            "op",
                            "columnId",
                            "width"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "op": {
                              "type": "string",
                              "const": "delete",
                              "description": "Remove columns from a worksheet. Worksheet-only."
                            },
                            "columnIds": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1
                              },
                              "description": "One or more column ids to remove from the worksheet."
                            }
                          },
                          "required": [
                            "op",
                            "columnIds"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "op": {
                              "type": "string",
                              "const": "set_wrap_text",
                              "description": "Wrap or unwrap cell text. Worksheet-only."
                            },
                            "columnId": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Column id whose wrapping to change."
                            },
                            "wrapText": {
                              "type": "boolean",
                              "description": "True to wrap cell text; false to unwrap it."
                            }
                          },
                          "required": [
                            "op",
                            "columnId",
                            "wrapText"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "op": {
                              "type": "string",
                              "const": "set_format",
                              "description": "Set number or date display format. Worksheet-only."
                            },
                            "columnId": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Column id whose format to change."
                            },
                            "format": {
                              "anyOf": [
                                {
                                  "anyOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "number"
                                        },
                                        "style": {
                                          "type": "string",
                                          "enum": [
                                            "plain",
                                            "percent"
                                          ]
                                        },
                                        "useThousandsSeparator": {
                                          "type": "boolean"
                                        },
                                        "maxDecimalPlaces": {
                                          "description": "Decimal places to display, from 0 to 100.",
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 100
                                        },
                                        "prefix": {
                                          "type": "string"
                                        },
                                        "suffix": {
                                          "type": "string"
                                        }
                                      },
                                      "required": [
                                        "type",
                                        "style"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "date"
                                        },
                                        "pattern": {
                                          "type": "string",
                                          "enum": [
                                            "[Q]Q YYYY",
                                            "MMM YYYY",
                                            "MMM D, YYYY",
                                            "MMM D YYYY, h:mm A",
                                            "YYYY-MM-DD HH:mm:ss",
                                            "h:mm A"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "type",
                                        "pattern"
                                      ],
                                      "additionalProperties": false
                                    }
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Null resets a date column to the source format."
                            }
                          },
                          "required": [
                            "op",
                            "columnId",
                            "format"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "op": {
                              "type": "string",
                              "const": "create_group",
                              "description": "Group columns under a shared header. Worksheet-only."
                            },
                            "columnIds": {
                              "minItems": 2,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1
                              }
                            },
                            "name": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Visible group name. Must be non-blank."
                            }
                          },
                          "required": [
                            "op",
                            "columnIds",
                            "name"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "op": {
                              "type": "string",
                              "const": "rename_group",
                              "description": "Rename a column group. Worksheet-only."
                            },
                            "groupId": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Encoded group id to rename."
                            },
                            "name": {
                              "type": "string",
                              "minLength": 1,
                              "description": "New visible group name. Must be non-blank."
                            }
                          },
                          "required": [
                            "op",
                            "groupId",
                            "name"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "op": {
                              "type": "string",
                              "const": "ungroup",
                              "description": "Remove columns from their group. Worksheet-only."
                            },
                            "columnIds": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1
                              },
                              "description": "One or more column ids to ungroup."
                            }
                          },
                          "required": [
                            "op",
                            "columnIds"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    }
                  }
                },
                "required": [
                  "tableId"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Tool result."
          },
          "400": {
            "$ref": "#/components/responses/400"
          },
          "401": {
            "$ref": "#/components/responses/401"
          },
          "402": {
            "$ref": "#/components/responses/402"
          },
          "403": {
            "$ref": "#/components/responses/403"
          },
          "404": {
            "$ref": "#/components/responses/404"
          },
          "422": {
            "$ref": "#/components/responses/422"
          },
          "429": {
            "$ref": "#/components/responses/429"
          },
          "504": {
            "$ref": "#/components/responses/504"
          },
          "5XX": {
            "$ref": "#/components/responses/5XX"
          }
        },
        "x-mint": {
          "metadata": {
            "playground": "none"
          }
        }
      }
    },
    "/v1/enrich_worksheet": {
      "post": {
        "operationId": "enrich_worksheet",
        "summary": "enrich_worksheet",
        "description": "Add AI columns that judge worksheet rows from their full transcripts, concurrently in a background job. Columns classify themes and root causes, score records or extract evidence. Each row's conversation transcript is found through the worksheet's `ticket_sid` column or the column whose kind is `external_gradable_reference`, and any `contextColumnIds` values are judged with it; a worksheet with neither reference is judged on its own columns instead. Results persist as columns that can be filtered and aggregated.\n\nOnly rows already on the worksheet are processed; rows that load after the job starts are not enriched. All columns requested together are filled in a single LLM call per row.\n\nThis returns the job's `jobId` at once; get_enrich_status with the worksheetId and jobId reports progress and completion. `columns` pairs each new column's display name with its `id`, and queries take the `id`. list_ai_models lists the accepted `model` ids.\n\nThis operation is an MCP tool today. Call it through the [Rippit MCP server](/mcp-server/overview) with the same name and parameters. The HTTP endpoint is not available yet.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "worksheetId": {
                    "type": "string",
                    "minLength": 1,
                    "pattern": "^[A-Za-z0-9_-]+$",
                    "description": "Worksheet to add the columns to."
                  },
                  "enrichments": {
                    "minItems": 1,
                    "maxItems": 25,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 120,
                          "description": "New column display name, unique within the call ignoring case and treating spaces as underscores."
                        },
                        "instructions": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 10000,
                          "description": "Per-row task for the model. With `overrides`, the default for rows no override matches."
                        },
                        "outputType": {
                          "oneOf": [
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "enum": [
                                    "string",
                                    "array(string)",
                                    "integer",
                                    "array(integer)",
                                    "float",
                                    "boolean"
                                  ]
                                }
                              },
                              "required": [
                                "type"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "enum"
                                },
                                "values": {
                                  "anyOf": [
                                    {
                                      "minItems": 2,
                                      "type": "array",
                                      "items": {
                                        "type": "string"
                                      }
                                    },
                                    {
                                      "minItems": 2,
                                      "type": "array",
                                      "items": {
                                        "type": "integer",
                                        "minimum": -9007199254740991,
                                        "maximum": 9007199254740991
                                      }
                                    }
                                  ],
                                  "description": "Allowed labels; rows the model cannot judge are forced into one unless a catch-all such as \"unknown\" is listed."
                                },
                                "multi": {
                                  "type": "boolean"
                                }
                              },
                              "required": [
                                "type",
                                "values"
                              ],
                              "additionalProperties": false
                            }
                          ],
                          "description": "Result type; `enum` values are stored as text labels. With `overrides`, the default-case type."
                        },
                        "overrideCaseColumnId": {
                          "description": "Existing pipeline-born column whose row value selects the override; required with `overrides`. Every column in one call that uses overrides must branch on the same column.",
                          "type": "string"
                        },
                        "overrides": {
                          "description": "Per-value instructions, one entry per overrideCaseColumnId value; rows matching no entry use the column-level instructions and outputType.",
                          "minItems": 1,
                          "maxItems": 60,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "case": {
                                "type": "string",
                                "minLength": 1,
                                "description": "The overrideCaseColumnId row value this entry applies to: an enum column's label text, or a single-select column's `opt_*` id."
                              },
                              "instructions": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 10000,
                                "description": "Instructions for rows whose overrideCaseColumnId matches `case`."
                              },
                              "outputType": {
                                "description": "This branch's output type; omitted reuses the column's. It must keep the default's underlying data type (string enums and plain strings mix).",
                                "oneOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "enum": [
                                          "string",
                                          "array(string)",
                                          "integer",
                                          "array(integer)",
                                          "float",
                                          "boolean"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "type"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "enum"
                                      },
                                      "values": {
                                        "anyOf": [
                                          {
                                            "minItems": 2,
                                            "type": "array",
                                            "items": {
                                              "type": "string"
                                            }
                                          },
                                          {
                                            "minItems": 2,
                                            "type": "array",
                                            "items": {
                                              "type": "integer",
                                              "minimum": -9007199254740991,
                                              "maximum": 9007199254740991
                                            }
                                          }
                                        ],
                                        "description": "Allowed labels; rows the model cannot judge are forced into one unless a catch-all such as \"unknown\" is listed."
                                      },
                                      "multi": {
                                        "type": "boolean"
                                      }
                                    },
                                    "required": [
                                      "type",
                                      "values"
                                    ],
                                    "additionalProperties": false
                                  }
                                ]
                              }
                            },
                            "required": [
                              "case",
                              "instructions"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "name",
                        "instructions",
                        "outputType"
                      ],
                      "additionalProperties": false
                    },
                    "description": "Columns to create and fill."
                  },
                  "contextColumnIds": {
                    "description": "Existing column ids whose per-row values the model reads alongside the conversation.",
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "where": {
                    "description": "Enrich only rows matching these filters.",
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "$ref": "#/components/schemas/enrich_worksheet____schema0"
                    }
                  },
                  "sampleRows": {
                    "description": "Enrich only a uniform random sample of this many rows, drawn after `where` and fresh on each run.",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 10000
                  },
                  "model": {
                    "description": "Model id; omitted uses the server default. Choose another supported model when the task calls for it. Ids are tenant-specific, and unknown ones are rejected.",
                    "type": "string",
                    "minLength": 1
                  },
                  "createScaffoldIfMissing": {
                    "description": "True turns a worksheet with no pipeline columns into a reusable pipeline on this enrichment; unset runs a plain one-off job.",
                    "type": "boolean"
                  }
                },
                "required": [
                  "worksheetId",
                  "enrichments"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Tool result."
          },
          "400": {
            "$ref": "#/components/responses/400"
          },
          "401": {
            "$ref": "#/components/responses/401"
          },
          "402": {
            "$ref": "#/components/responses/402"
          },
          "403": {
            "$ref": "#/components/responses/403"
          },
          "404": {
            "$ref": "#/components/responses/404"
          },
          "422": {
            "$ref": "#/components/responses/422"
          },
          "429": {
            "$ref": "#/components/responses/429"
          },
          "504": {
            "$ref": "#/components/responses/504"
          },
          "5XX": {
            "$ref": "#/components/responses/5XX"
          }
        },
        "x-mint": {
          "metadata": {
            "playground": "none"
          }
        }
      }
    },
    "/v1/export_worksheet": {
      "post": {
        "operationId": "export_worksheet",
        "summary": "export_worksheet",
        "description": "Export chosen worksheet columns as a CSV file and return its download `url`; read_table returns rows into the conversation instead. Every row matching `where` is exported without passing through the conversation; filters on the user's screen are not applied, and derived values must already exist as worksheet columns. The `url` opens in a browser and refreshes its temporary storage link; `fileUrl` is the CSV itself, for curl or a script, and expires after 7 days. The file is also listed on the Exports page.\n\nThis operation is an MCP tool today. Call it through the [Rippit MCP server](/mcp-server/overview) with the same name and parameters. The HTTP endpoint is not available yet.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "worksheetId": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128,
                    "pattern": "^[A-Za-z0-9_-]+$",
                    "description": "Worksheet to export, under the calling user’s access permissions."
                  },
                  "columnIds": {
                    "minItems": 1,
                    "maxItems": 200,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1
                    },
                    "description": "Columns to export, in CSV column order."
                  },
                  "headers": {
                    "description": "CSV header per column id; columns left out use their id.",
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200
                    }
                  },
                  "where": {
                    "description": "AND filters. Saved worksheet view filters are not applied automatically.",
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "columnId": {
                          "type": "string",
                          "minLength": 1
                        },
                        "operator": {
                          "type": "string",
                          "enum": [
                            "=",
                            "!=",
                            ">",
                            "<",
                            ">=",
                            "<=",
                            "IN",
                            "NOT IN",
                            "LIKE",
                            "IS",
                            "IS NOT"
                          ],
                          "description": "Comparison operator; IN/NOT IN require an array value; IS/IS NOT require null. LIKE is case-sensitive and matches the whole value, so wrap a substring in `%`."
                        },
                        "value": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "type": [
                                  "string",
                                  "number",
                                  "boolean"
                                ]
                              }
                            }
                          ],
                          "description": "Filter value; date bounds use ISO timestamp strings. A timestamp without an offset is interpreted as UTC."
                        }
                      },
                      "required": [
                        "columnId",
                        "operator",
                        "value"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "orderBy": {
                    "description": "Sort keys in priority order; a ranking by an aggregate must already exist as a column.",
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "columnId": {
                          "type": "string",
                          "minLength": 1
                        },
                        "direction": {
                          "type": "string",
                          "enum": [
                            "asc",
                            "desc"
                          ]
                        }
                      },
                      "required": [
                        "columnId",
                        "direction"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "worksheetId",
                  "columnIds"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Tool result."
          },
          "400": {
            "$ref": "#/components/responses/400"
          },
          "401": {
            "$ref": "#/components/responses/401"
          },
          "402": {
            "$ref": "#/components/responses/402"
          },
          "403": {
            "$ref": "#/components/responses/403"
          },
          "404": {
            "$ref": "#/components/responses/404"
          },
          "422": {
            "$ref": "#/components/responses/422"
          },
          "429": {
            "$ref": "#/components/responses/429"
          },
          "504": {
            "$ref": "#/components/responses/504"
          },
          "5XX": {
            "$ref": "#/components/responses/5XX"
          }
        },
        "x-mint": {
          "metadata": {
            "playground": "none"
          }
        }
      }
    },
    "/v1/get_enrich_status": {
      "post": {
        "operationId": "get_enrich_status",
        "summary": "get_enrich_status",
        "description": "Report the progress of a worksheet column job started by enrich_worksheet, blocking until it settles or a fixed server-side wait cap passes.\n\n`done: false` means the job is still running; its worksheetId and jobId are unchanged. `done` is true for `finished`, `failed` (with the worker's `error` when recorded), `timed_out`, `stopped` and `untracked`: no column carries the jobId, from a wrong id or cleaned-up tracking, so the outcome is unknown. A tool error means the status could not be read; it does not establish that the job finished or failed.\n\nFor a failed formula job, report the worker's `error` when recorded and leave the existing worksheet and column in place; do not create another worksheet or column, or start an enrichment.\n\n`answerAggregates` counts only each column's most common values, so it cannot give a true min or max; `numericSummaries` holds exact full-column statistics. While the job runs, the top 5 `sampleValues` and top 10 counts per column are a rough preview. A finished result may omit breakdowns that did not fit the request time; that is not a failure.\n\nThis operation is an MCP tool today. Call it through the [Rippit MCP server](/mcp-server/overview) with the same name and parameters. The HTTP endpoint is not available yet.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "worksheetId": {
                    "type": "string",
                    "minLength": 1,
                    "pattern": "^[A-Za-z0-9_-]+$",
                    "description": "Worksheet the column job runs on."
                  },
                  "jobId": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Job id returned when the enrichment or formula computation started."
                  },
                  "wait": {
                    "default": true,
                    "description": "True (default) blocks until the job settles or the wait cap passes; false reads once.",
                    "type": "boolean"
                  }
                },
                "required": [
                  "worksheetId",
                  "jobId",
                  "wait"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Tool result."
          },
          "400": {
            "$ref": "#/components/responses/400"
          },
          "401": {
            "$ref": "#/components/responses/401"
          },
          "402": {
            "$ref": "#/components/responses/402"
          },
          "403": {
            "$ref": "#/components/responses/403"
          },
          "404": {
            "$ref": "#/components/responses/404"
          },
          "422": {
            "$ref": "#/components/responses/422"
          },
          "429": {
            "$ref": "#/components/responses/429"
          },
          "504": {
            "$ref": "#/components/responses/504"
          },
          "5XX": {
            "$ref": "#/components/responses/5XX"
          }
        },
        "x-mint": {
          "metadata": {
            "playground": "none"
          }
        }
      }
    },
    "/v1/get_integration_state": {
      "post": {
        "operationId": "get_integration_state",
        "summary": "get_integration_state",
        "description": "Read workspace connections, provider authorization, import fields, and initial import progress. Pass query: {kind: workspace} to confirm the destination workspace, signed-in email, supported providers, and current connections. Pass {kind: request, request_id} for an authorization request, or {kind: connection, source, account_id, etl_id} for import status; add fields: true inside the connection query to inspect optional import fields. For Salesforce, use {kind: objects, source: salesforce, account_id, etl_id} instead of fields: true to list available objects. Results are returned in the setup object.\n\nstatus.workspaceTableId is the readable Rippit table id; pass it as tableId to describe_table, read_table, or aggregate_table. status.tableId is an internal id and must not be passed to those tools. If workspaceTableId is absent, discover the table before reading it.\n\nSalesforce status.tables lists each selected object, its progress, and its workspaceTableId. Use those readable ids for table tools. The overall state stays importing until all selected tables finish; do not infer completion from Cases alone. objects[].doFullRepull means that object imports all history regardless of history_days.\n\nAuthorization request status completed means authorized, not imported. A ready initial import does not guarantee complete history; match the connection's ETL id to the resulting table and check coverage before analysis. Report status.warning and do not retry a ready import. Use connect_integration for authorization. Use import_integration to start or retry an import, or to extend a ready import with older history when status.canExtendHistory is true. status.extendHistoryOptions lists the ranges an extension can add, shortest first, each with the day it reaches back to; the last is the earliest day available.\n\nThis operation is an MCP tool today. Call it through the [Rippit MCP server](/mcp-server/overview) with the same name and parameters. The HTTP endpoint is not available yet.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "wait_seconds": {
                    "description": "Wait up to 45 seconds for authorization or import progress to finish. Omit for an immediate check. Return to the user after a bounded wait; do not poll indefinitely.",
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 45
                  },
                  "query": {
                    "oneOf": [
                      {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "const": "workspace"
                          }
                        },
                        "required": [
                          "kind"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "const": "request"
                          },
                          "request_id": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255
                          }
                        },
                        "required": [
                          "kind",
                          "request_id"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "const": "objects"
                          },
                          "source": {
                            "type": "string",
                            "const": "salesforce"
                          },
                          "account_id": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255,
                            "description": "Exact provider account id returned by get_integration_state."
                          },
                          "etl_id": {
                            "type": "integer",
                            "exclusiveMinimum": 0,
                            "maximum": 9007199254740991,
                            "description": "ETL id of that same connection."
                          }
                        },
                        "required": [
                          "kind",
                          "source",
                          "account_id",
                          "etl_id"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "const": "connection"
                          },
                          "source": {
                            "type": "string",
                            "enum": [
                              "zendesk",
                              "intercom",
                              "slack_ingest",
                              "gong",
                              "decagon",
                              "granola",
                              "fireflies",
                              "attention",
                              "nooks",
                              "kustomer",
                              "ada",
                              "sierra",
                              "pylon",
                              "gorgias",
                              "salesforce",
                              "freshdesk"
                            ],
                            "description": "Provider returned by get_integration_state."
                          },
                          "account_id": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 255,
                            "description": "Exact provider account id returned by get_integration_state."
                          },
                          "etl_id": {
                            "type": "integer",
                            "exclusiveMinimum": 0,
                            "maximum": 9007199254740991,
                            "description": "ETL id of that same connection."
                          },
                          "fields": {
                            "description": "Read available import fields instead of import progress.",
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "kind",
                          "source",
                          "account_id",
                          "etl_id"
                        ],
                        "additionalProperties": false
                      }
                    ],
                    "description": "Inspect the workspace, an authorization attempt, a connected provider, or available Salesforce import objects."
                  }
                },
                "required": [
                  "query"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Tool result."
          },
          "400": {
            "$ref": "#/components/responses/400"
          },
          "401": {
            "$ref": "#/components/responses/401"
          },
          "402": {
            "$ref": "#/components/responses/402"
          },
          "403": {
            "$ref": "#/components/responses/403"
          },
          "404": {
            "$ref": "#/components/responses/404"
          },
          "422": {
            "$ref": "#/components/responses/422"
          },
          "429": {
            "$ref": "#/components/responses/429"
          },
          "504": {
            "$ref": "#/components/responses/504"
          },
          "5XX": {
            "$ref": "#/components/responses/5XX"
          }
        },
        "x-mint": {
          "metadata": {
            "playground": "none"
          }
        }
      }
    },
    "/v1/import_integration": {
      "post": {
        "operationId": "import_integration",
        "summary": "import_integration",
        "description": "Start an initial data import for an authenticated provider, retry a failed initial import with its saved configuration, or extend a ready import with older history. Use the exact source, account id, and ETL id returned by get_integration_state.\n\nConfirm the requested history and optional field choices before starting. Repeating start on an importing or ready connection reports its current state instead of restarting it or expanding its history. Use retry only after a failed import; it preserves the original selection and does not accept history_days, selected_fields, or selected_objects. Workspace import limits still apply. Slack imports and retries require the bot to be in at least one selected channel; if none are available, ask the user to add Rippit to a channel before trying again.\n\nUse extend only when get_integration_state reports status.canExtendHistory for a ready import. Pick the range from status.extendHistoryOptions: match a request like \"add 30 days\" to the option with those days, or offer the options when the user names none. Before calling, confirm the range with the user, stating the day it reaches back to, then pass that option's from as extend_from. If the request is longer than the last option, say the last option's from is the earliest day available and confirm it. Extensions reach the requested start, up to all remaining history for Zendesk, Intercom, Salesforce, Gong, Pylon, Freshdesk, Gorgias, Decagon, Attention, Granola, Fireflies, Sierra, and Nooks. Extend accepts no history_days or selections, runs for minutes to hours while the table stays ready, and status.historyExtension reports it. A 400 names the days extend_from may take. Only one extension runs at a time. A failed extension may be extended again when status.canExtendHistory is true; the new extension replaces it. A 409 means there is no older history to add or an extension is already running; report it instead of retrying.\n\nSalesforce start requires selected_objects from get_integration_state query.kind objects, not selected_fields. Confirm the objects and history with the user. Case is the conversation table; other objects create separate tables. Objects marked doFullRepull import all history even when history_days is smaller, and extend adds older history for Case and its child objects when Case was imported. Retry preserves the saved objects and Case choice. If status.warning says retry is unavailable, report it instead of retrying.\n\nThis call starts work and returns; get_integration_state reports progress and the resulting table. After a timeout or server error, the import may still be running: check that same connection's state before repeating this call. For an extension, check status.historyExtension.\n\nThis operation is an MCP tool today. Call it through the [Rippit MCP server](/mcp-server/overview) with the same name and parameters. The HTTP endpoint is not available yet.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "source": {
                    "type": "string",
                    "enum": [
                      "zendesk",
                      "intercom",
                      "slack_ingest",
                      "gong",
                      "decagon",
                      "granola",
                      "fireflies",
                      "attention",
                      "nooks",
                      "kustomer",
                      "ada",
                      "sierra",
                      "pylon",
                      "gorgias",
                      "salesforce",
                      "freshdesk"
                    ],
                    "description": "Provider returned by get_integration_state."
                  },
                  "account_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 255,
                    "description": "Exact provider account id returned by get_integration_state."
                  },
                  "etl_id": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991,
                    "description": "ETL id of that same connection."
                  },
                  "action": {
                    "type": "string",
                    "enum": [
                      "start",
                      "retry",
                      "extend"
                    ],
                    "description": "Start the initial import, retry a failed initial import, or extend a ready import with older history."
                  },
                  "history_days": {
                    "description": "Required for start: days of history counted back from today. Confirm an ambiguous period. Forbidden for retry, which preserves the existing import configuration, and for extend, which takes extend_from.",
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 104249991374
                  },
                  "extend_from": {
                    "description": "Required for extend: the ISO day (YYYY-MM-DD) to add history back to, before status.backfillDate and no earlier than the last status.extendHistoryOptions from. Use the from of the option the user confirmed. Forbidden for start and retry.",
                    "type": "string",
                    "format": "date",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
                  },
                  "selected_objects": {
                    "description": "Required for Salesforce start: exact object names returned by get_integration_state query.kind objects. Confirm any doFullRepull objects import all history. Forbidden for other providers, retry, and extend.",
                    "minItems": 1,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 255
                    }
                  },
                  "selected_fields": {
                    "description": "Nonempty fields[].rawFieldName values returned by get_integration_state, not fieldName display labels. Omit to use provider defaults. Forbidden for retry and extend.",
                    "minItems": 1,
                    "maxItems": 150,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 255
                    }
                  }
                },
                "required": [
                  "source",
                  "account_id",
                  "etl_id",
                  "action"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Tool result."
          },
          "400": {
            "$ref": "#/components/responses/400"
          },
          "401": {
            "$ref": "#/components/responses/401"
          },
          "402": {
            "$ref": "#/components/responses/402"
          },
          "403": {
            "$ref": "#/components/responses/403"
          },
          "404": {
            "$ref": "#/components/responses/404"
          },
          "422": {
            "$ref": "#/components/responses/422"
          },
          "429": {
            "$ref": "#/components/responses/429"
          },
          "504": {
            "$ref": "#/components/responses/504"
          },
          "5XX": {
            "$ref": "#/components/responses/5XX"
          }
        },
        "x-mint": {
          "metadata": {
            "playground": "none"
          }
        }
      }
    },
    "/v1/list_active_integrations": {
      "post": {
        "operationId": "list_active_integrations",
        "summary": "list_active_integrations",
        "description": "List the workspace's active integrations with their ETL and provider account ids, without the authentication and initialization state. `flavor` is the connection's sub-type, such as \"s3\", or null when unclassified.\n\nThis operation is an MCP tool today. Call it through the [Rippit MCP server](/mcp-server/overview) with the same name and parameters. The HTTP endpoint is not available yet.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {},
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Tool result."
          },
          "400": {
            "$ref": "#/components/responses/400"
          },
          "401": {
            "$ref": "#/components/responses/401"
          },
          "402": {
            "$ref": "#/components/responses/402"
          },
          "403": {
            "$ref": "#/components/responses/403"
          },
          "404": {
            "$ref": "#/components/responses/404"
          },
          "422": {
            "$ref": "#/components/responses/422"
          },
          "429": {
            "$ref": "#/components/responses/429"
          },
          "504": {
            "$ref": "#/components/responses/504"
          },
          "5XX": {
            "$ref": "#/components/responses/5XX"
          }
        },
        "x-mint": {
          "metadata": {
            "playground": "none"
          }
        }
      }
    },
    "/v1/list_ai_models": {
      "post": {
        "operationId": "list_ai_models",
        "summary": "list_ai_models",
        "description": "List the AI models this account can use in a tool's `model` field, as `{ id, name, thinking, inputPrice, outputPrice }` in display order. External MCP clients can request every catalog except `askai`. Availability depends on account settings, and only a listed `id`, passed verbatim, is accepted. Prices are USD per million tokens, or null when unknown. `agent_search` models also report `provider`, `available`, `evidence` and maintained `pricing`, and only `available` ones can run.\n\nThis operation is an MCP tool today. Call it through the [Rippit MCP server](/mcp-server/overview) with the same name and parameters. The HTTP endpoint is not available yet.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "useCase": {
                    "description": "Catalog (default llm_column): llm_column for the enrich_worksheet `model`; ai_engine for the `model_hint` of a pipeline AI job; action_agent for the `model` of a pipeline agent job; agent_search for the agent_search `models`.",
                    "type": "string",
                    "enum": [
                      "llm_column",
                      "ai_engine",
                      "action_agent",
                      "agent_search"
                    ]
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Tool result."
          },
          "400": {
            "$ref": "#/components/responses/400"
          },
          "401": {
            "$ref": "#/components/responses/401"
          },
          "402": {
            "$ref": "#/components/responses/402"
          },
          "403": {
            "$ref": "#/components/responses/403"
          },
          "404": {
            "$ref": "#/components/responses/404"
          },
          "422": {
            "$ref": "#/components/responses/422"
          },
          "429": {
            "$ref": "#/components/responses/429"
          },
          "504": {
            "$ref": "#/components/responses/504"
          },
          "5XX": {
            "$ref": "#/components/responses/5XX"
          }
        },
        "x-mint": {
          "metadata": {
            "playground": "none"
          }
        }
      }
    },
    "/v1/list_data_sources": {
      "post": {
        "operationId": "list_data_sources",
        "summary": "list_data_sources",
        "description": "List the live data tables the user can access, newest first; prior analyses are worksheets, listed by list_worksheets.\n\nThis operation is an MCP tool today. Call it through the [Rippit MCP server](/mcp-server/overview) with the same name and parameters. The HTTP endpoint is not available yet.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "search": {
                    "description": "Case-insensitive search over names and descriptions.",
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  },
                  "originType": {
                    "description": "integration | api | ai_table | transform.",
                    "type": "string",
                    "enum": [
                      "integration",
                      "api",
                      "ai_table",
                      "transform"
                    ]
                  },
                  "provider": {
                    "description": "e.g. zendesk, snowflake, rippit.",
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  "accountId": {
                    "description": "Exact origin.account_id from a prior result.",
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  },
                  "limit": {
                    "description": "Defaults to 50.",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 200
                  },
                  "offset": {
                    "description": "Zero-based starting index.",
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Tool result."
          },
          "400": {
            "$ref": "#/components/responses/400"
          },
          "401": {
            "$ref": "#/components/responses/401"
          },
          "402": {
            "$ref": "#/components/responses/402"
          },
          "403": {
            "$ref": "#/components/responses/403"
          },
          "404": {
            "$ref": "#/components/responses/404"
          },
          "422": {
            "$ref": "#/components/responses/422"
          },
          "429": {
            "$ref": "#/components/responses/429"
          },
          "504": {
            "$ref": "#/components/responses/504"
          },
          "5XX": {
            "$ref": "#/components/responses/5XX"
          }
        },
        "x-mint": {
          "metadata": {
            "playground": "none"
          }
        }
      }
    },
    "/v1/list_snowflake_connections": {
      "post": {
        "operationId": "list_snowflake_connections",
        "summary": "list_snowflake_connections",
        "description": "List the workspace's connections to the customer's own Snowflake account, plus a ready-to-run setup script for a new one.\n\nHow to use:\n- Any Snowsight link fills `setup` (a database or table page also names the database); ask the user only for what `setup` still has null.\n- `setup_sql` runs as ACCOUNTADMIN and creates a user, role and warehouse, so confirm with the user before running it through a Snowflake SQL tool of your own. Otherwise give it to them as one block, with `setup.worksheets_url` as the blank SQL file to paste it into. `connect_url` is the same setup as a web page.\n- Once it has run, pass `setup`'s account, user, user_role and warehouse to manage_snowflake_connection create.\n- A connection with `active: false` and a `setup_error` needs that error fixed in Snowflake, then manage_snowflake_connection with action `update`.\n- Workspace admins only; anyone else gets a 403 on every Snowflake call, so don't retry.\n\nThis operation is an MCP tool today. Call it through the [Rippit MCP server](/mcp-server/overview) with the same name and parameters. The HTTP endpoint is not available yet.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "snowflake_url": {
                    "description": "Any app.snowflake.com link the user pasted (account, database, table page, ...). Fills account, database, schema and table into `setup`.",
                    "type": "string",
                    "maxLength": 2048
                  },
                  "warehouse": {
                    "description": "Existing warehouse to use. Omit to have the script create RIPPIT_WH (XSMALL, auto-suspends after 60s).",
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 256
                  },
                  "database": {
                    "description": "Database to grant read on, when the link has none.",
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 256
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Tool result."
          },
          "400": {
            "$ref": "#/components/responses/400"
          },
          "401": {
            "$ref": "#/components/responses/401"
          },
          "402": {
            "$ref": "#/components/responses/402"
          },
          "403": {
            "$ref": "#/components/responses/403"
          },
          "404": {
            "$ref": "#/components/responses/404"
          },
          "422": {
            "$ref": "#/components/responses/422"
          },
          "429": {
            "$ref": "#/components/responses/429"
          },
          "504": {
            "$ref": "#/components/responses/504"
          },
          "5XX": {
            "$ref": "#/components/responses/5XX"
          }
        },
        "x-mint": {
          "metadata": {
            "playground": "none"
          }
        }
      }
    },
    "/v1/list_snowflake_imports": {
      "post": {
        "operationId": "list_snowflake_imports",
        "summary": "list_snowflake_imports",
        "description": "List Snowflake tables being synced into Rippit, with each sync's schedule, status, rows written and last error.\n\nHow to use:\n- `status` failed with an `error` usually needs a fix in Snowflake (permissions, dropped column), then manage_snowflake_import with action `run`.\n- Workspace admins only; anyone else gets a 403 on every Snowflake call, so don't retry.\n\nThis operation is an MCP tool today. Call it through the [Rippit MCP server](/mcp-server/overview) with the same name and parameters. The HTTP endpoint is not available yet.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "connection_id": {
                    "description": "Only imports on this connection.",
                    "type": "string",
                    "minLength": 1
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Tool result."
          },
          "400": {
            "$ref": "#/components/responses/400"
          },
          "401": {
            "$ref": "#/components/responses/401"
          },
          "402": {
            "$ref": "#/components/responses/402"
          },
          "403": {
            "$ref": "#/components/responses/403"
          },
          "404": {
            "$ref": "#/components/responses/404"
          },
          "422": {
            "$ref": "#/components/responses/422"
          },
          "429": {
            "$ref": "#/components/responses/429"
          },
          "504": {
            "$ref": "#/components/responses/504"
          },
          "5XX": {
            "$ref": "#/components/responses/5XX"
          }
        },
        "x-mint": {
          "metadata": {
            "playground": "none"
          }
        }
      }
    },
    "/v1/list_snowflake_tables": {
      "post": {
        "operationId": "list_snowflake_tables",
        "summary": "list_snowflake_tables",
        "description": "List tables in the customer's own Snowflake account that a connection can read. These are not Rippit tables.\n\nHow to use:\n- When `truncated` is true, narrow with `database` and/or `schema_name` rather than raising `limit`.\n- Views are not listed and can't be imported.\n- Workspace admins only; anyone else gets a 403 on every Snowflake call, so don't retry.\n\nThis operation is an MCP tool today. Call it through the [Rippit MCP server](/mcp-server/overview) with the same name and parameters. The HTTP endpoint is not available yet.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "connection_id": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Snowflake connection id from list_snowflake_connections."
                  },
                  "database": {
                    "description": "Only tables in this database (case-insensitive).",
                    "type": "string",
                    "minLength": 1
                  },
                  "schema_name": {
                    "description": "Only tables in this schema (case-insensitive).",
                    "type": "string",
                    "minLength": 1
                  },
                  "limit": {
                    "description": "Max tables returned. Defaults to 200.",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 1000
                  }
                },
                "required": [
                  "connection_id"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Tool result."
          },
          "400": {
            "$ref": "#/components/responses/400"
          },
          "401": {
            "$ref": "#/components/responses/401"
          },
          "402": {
            "$ref": "#/components/responses/402"
          },
          "403": {
            "$ref": "#/components/responses/403"
          },
          "404": {
            "$ref": "#/components/responses/404"
          },
          "422": {
            "$ref": "#/components/responses/422"
          },
          "429": {
            "$ref": "#/components/responses/429"
          },
          "504": {
            "$ref": "#/components/responses/504"
          },
          "5XX": {
            "$ref": "#/components/responses/5XX"
          }
        },
        "x-mint": {
          "metadata": {
            "playground": "none"
          }
        }
      }
    },
    "/v1/list_worksheets": {
      "post": {
        "operationId": "list_worksheets",
        "summary": "list_worksheets",
        "description": "List the user's existing worksheets, newest first; list_data_sources lists the live tables a new worksheet is built from. A worksheet is a snapshot copied from a table when it was created, plus any columns added since, so its rows can be stale. Worksheet templates are not included.\n\nThis operation is an MCP tool today. Call it through the [Rippit MCP server](/mcp-server/overview) with the same name and parameters. The HTTP endpoint is not available yet.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "search": {
                    "description": "Case-insensitive text search across worksheet names and descriptions.",
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  },
                  "limit": {
                    "description": "Page size; default 50.",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 200
                  },
                  "offset": {
                    "description": "Zero-based start index; `total` counts every match across pages.",
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Tool result."
          },
          "400": {
            "$ref": "#/components/responses/400"
          },
          "401": {
            "$ref": "#/components/responses/401"
          },
          "402": {
            "$ref": "#/components/responses/402"
          },
          "403": {
            "$ref": "#/components/responses/403"
          },
          "404": {
            "$ref": "#/components/responses/404"
          },
          "422": {
            "$ref": "#/components/responses/422"
          },
          "429": {
            "$ref": "#/components/responses/429"
          },
          "504": {
            "$ref": "#/components/responses/504"
          },
          "5XX": {
            "$ref": "#/components/responses/5XX"
          }
        },
        "x-mint": {
          "metadata": {
            "playground": "none"
          }
        }
      }
    },
    "/v1/manage_snowflake_connection": {
      "post": {
        "operationId": "manage_snowflake_connection",
        "summary": "manage_snowflake_connection",
        "description": "Create, update, disconnect or delete a connection to the customer's own Snowflake account. Rippit logs in with its own key pair, so no password or private key is ever passed.\n\nHow to use:\n- Run `setup_sql` from list_snowflake_connections in Snowflake first; create then logs in to verify. A login or permission failure comes back as `setup_error` on an inactive connection: fix it in Snowflake, then `update`.\n- `update` re-verifies; pass only the fields that change. Account, user and region can't change on a verified connection — create a new one. `update` also reconnects a disconnected connection.\n- Workspace admins only; anyone else gets a 403 on every Snowflake call, so don't retry.\n\nThis operation is an MCP tool today. Call it through the [Rippit MCP server](/mcp-server/overview) with the same name and parameters. The HTTP endpoint is not available yet.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "action": {
                    "type": "string",
                    "enum": [
                      "create",
                      "update",
                      "disconnect",
                      "delete"
                    ],
                    "description": "create a connection, update one (re-verifies login), disconnect it (pauses its imports), or delete one whose setup never finished."
                  },
                  "connection_id": {
                    "description": "Required for update, disconnect and delete.",
                    "type": "string",
                    "minLength": 1
                  },
                  "account": {
                    "description": "Snowflake account identifier, e.g. \"abc12345\" or \"myorg-myaccount\". Required for create.",
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 256
                  },
                  "user": {
                    "description": "Snowflake service user from the setup script. Required for create.",
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 256
                  },
                  "warehouse": {
                    "description": "Warehouse the user may run queries on. Required for create.",
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 256
                  },
                  "region": {
                    "description": "Snowflake region, if the account id needs one.",
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 256
                  },
                  "user_role": {
                    "description": "Role from the setup script.",
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 256
                  },
                  "idempotency_key": {
                    "description": "create only: retries with the same key return the same connection.",
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128
                  }
                },
                "required": [
                  "action"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Tool result."
          },
          "400": {
            "$ref": "#/components/responses/400"
          },
          "401": {
            "$ref": "#/components/responses/401"
          },
          "402": {
            "$ref": "#/components/responses/402"
          },
          "403": {
            "$ref": "#/components/responses/403"
          },
          "404": {
            "$ref": "#/components/responses/404"
          },
          "422": {
            "$ref": "#/components/responses/422"
          },
          "429": {
            "$ref": "#/components/responses/429"
          },
          "504": {
            "$ref": "#/components/responses/504"
          },
          "5XX": {
            "$ref": "#/components/responses/5XX"
          }
        },
        "x-mint": {
          "metadata": {
            "playground": "none"
          }
        }
      }
    },
    "/v1/manage_snowflake_import": {
      "post": {
        "operationId": "manage_snowflake_import",
        "summary": "manage_snowflake_import",
        "description": "Import tables from the customer's own Snowflake account into Rippit as scheduled syncs, change them, or run, pause, resume, reset or delete one. `create` starts a full-table sync immediately, then repeats every `cadence_hours`, running queries on the customer's warehouse and copying the rows into Rippit.\n\nHow to use:\n- create and update touch only the listed tables (up to 100); other imports on the connection keep running. update needs only the fields that change.\n- Changing `primary_keys` or `updated_at_column` replaces the import with a new table and a full re-pull.\n- `run` only works on an active import; `resume` also syncs a paused one right away. Syncs are async; list_snowflake_imports shows progress.\n- `delete` removes the import from Rippit's table list; rows already imported stay stored.\n- Workspace admins only; anyone else gets a 403 on every Snowflake call, so don't retry.\n\nThis operation is an MCP tool today. Call it through the [Rippit MCP server](/mcp-server/overview) with the same name and parameters. The HTTP endpoint is not available yet.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "action": {
                    "type": "string",
                    "enum": [
                      "create",
                      "update",
                      "run",
                      "pause",
                      "resume",
                      "reset",
                      "delete"
                    ],
                    "description": "create or update imports for tables on a connection; run syncs an active import now; pause/resume its schedule; reset re-imports the whole table; delete stops it."
                  },
                  "connection_id": {
                    "description": "create and update only.",
                    "type": "string",
                    "minLength": 1
                  },
                  "tables": {
                    "description": "create and update only: tables to import or change.",
                    "minItems": 1,
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "database": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 256,
                          "description": "Snowflake database, exactly as Snowflake lists it."
                        },
                        "schema_name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 256,
                          "description": "Snowflake schema, exactly as Snowflake lists it."
                        },
                        "table": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 256,
                          "description": "Snowflake table, exactly as Snowflake lists it."
                        },
                        "primary_keys": {
                          "description": "Columns that uniquely identify a row. Required for create.",
                          "minItems": 1,
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1
                          }
                        },
                        "updated_at_column": {
                          "description": "Timestamp column used as the high-watermark filter for incremental syncs and the version ordering key to deduplicate rows by primary key (e.g., updated_at). null re-reads the whole table each sync.",
                          "anyOf": [
                            {
                              "type": "string",
                              "minLength": 1
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "cadence_hours": {
                          "description": "Sync every 1 or 24 hours. Defaults to 24.",
                          "anyOf": [
                            {
                              "type": "number",
                              "const": 1
                            },
                            {
                              "type": "number",
                              "const": 24
                            }
                          ]
                        }
                      },
                      "required": [
                        "database",
                        "schema_name",
                        "table"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "import_id": {
                    "description": "Import id from list_snowflake_imports. Required for run, pause, resume, reset and delete.",
                    "type": "string",
                    "minLength": 1
                  }
                },
                "required": [
                  "action"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Tool result."
          },
          "400": {
            "$ref": "#/components/responses/400"
          },
          "401": {
            "$ref": "#/components/responses/401"
          },
          "402": {
            "$ref": "#/components/responses/402"
          },
          "403": {
            "$ref": "#/components/responses/403"
          },
          "404": {
            "$ref": "#/components/responses/404"
          },
          "422": {
            "$ref": "#/components/responses/422"
          },
          "429": {
            "$ref": "#/components/responses/429"
          },
          "504": {
            "$ref": "#/components/responses/504"
          },
          "5XX": {
            "$ref": "#/components/responses/5XX"
          }
        },
        "x-mint": {
          "metadata": {
            "playground": "none"
          }
        }
      }
    },
    "/v1/pivot_table": {
      "post": {
        "operationId": "pivot_table",
        "summary": "pivot_table",
        "description": "Build a pivot over a table or worksheet: row dimensions down the side, column dimensions across the top, measures in each cell, with subtotals and totals; aggregate_table runs a flat group-by. Works on worksheets and customDataTables only. Results are not paginated: a query over 10000 intermediate groups fails rather than returning partial cells; `rowTopN` and `columnTopN` trim the returned groups, not the query.\n\n`layout` lists the dimensions, measures and the `columnGroups` kept after `columnTopN`; `layout.columnGroupsTruncated` and `rowsTruncated` flag trimmed axes. Each record has a `level` (`cell`, `rowSubtotal`, `columnTotal` or `grandTotal`), `row` and `column` maps of the dimension values held fixed, keyed by dimension alias, and `values` keyed by measure alias. Records are sparse: a missing intersection means no data, not zero. Totals cover the full filtered dataset, so when groups are trimmed the visible cells do not sum to them. Dimension values group as stored, without case or whitespace merging. singleSelect values come back as option ids (`opt_*`) with no label map; describe_column lists each id's label.\n\nThis operation is an MCP tool today. Call it through the [Rippit MCP server](/mcp-server/overview) with the same name and parameters. The HTTP endpoint is not available yet.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "tableId": {
                    "type": "string",
                    "minLength": 1,
                    "pattern": "^[A-Za-z0-9_-]+$",
                    "description": "Data table or worksheet id."
                  },
                  "rowDimensions": {
                    "minItems": 1,
                    "maxItems": 5,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "columnId": {
                          "type": "string",
                          "minLength": 1,
                          "description": "Column id, not its label."
                        },
                        "dateTrunc": {
                          "description": "Date grain; the alias becomes `<columnId>_<dateTrunc>`.",
                          "type": "string",
                          "enum": [
                            "minute",
                            "hour",
                            "day",
                            "week",
                            "month",
                            "year"
                          ]
                        }
                      },
                      "required": [
                        "columnId"
                      ],
                      "additionalProperties": false
                    },
                    "description": "Row hierarchy, top level first; subtotals return at every level."
                  },
                  "columnDimensions": {
                    "description": "Each value combination becomes a column group; omit for row subtotals only.",
                    "maxItems": 3,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "columnId": {
                          "type": "string",
                          "minLength": 1,
                          "description": "Column id, not its label."
                        },
                        "dateTrunc": {
                          "description": "Date grain; the alias becomes `<columnId>_<dateTrunc>`.",
                          "type": "string",
                          "enum": [
                            "minute",
                            "hour",
                            "day",
                            "week",
                            "month",
                            "year"
                          ]
                        }
                      },
                      "required": [
                        "columnId"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "measures": {
                    "minItems": 1,
                    "maxItems": 10,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "columnId": {
                          "type": "string",
                          "minLength": 1,
                          "description": "Column id, not its label."
                        },
                        "agg": {
                          "type": "string",
                          "enum": [
                            "count",
                            "count_distinct",
                            "sum",
                            "avg",
                            "min",
                            "max"
                          ]
                        },
                        "alias": {
                          "description": "Key under `values`; defaults to `<columnId>_<agg>`.",
                          "type": "string",
                          "minLength": 1
                        }
                      },
                      "required": [
                        "columnId",
                        "agg"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "where": {
                    "description": "Filters source rows before pivoting.",
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "$ref": "#/components/schemas/pivot_table____schema0"
                    }
                  },
                  "arrayExpansions": {
                    "description": "Explode array columns into one row per element, referenced by alias; empty arrays yield no rows, and counts describe elements, not records.",
                    "maxItems": 3,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "columnId": {
                          "type": "string",
                          "minLength": 1,
                          "description": "Array column id."
                        },
                        "alias": {
                          "type": "string",
                          "pattern": "^[A-Za-z][A-Za-z0-9_]*$",
                          "description": "Unused column id for the elements."
                        }
                      },
                      "required": [
                        "columnId",
                        "alias"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "sort": {
                    "description": "Defaults to the first measure, descending.",
                    "type": "object",
                    "properties": {
                      "alias": {
                        "type": "string",
                        "minLength": 1,
                        "description": "A measure alias ranks row groups by their total across columns; a row-dimension column id orders each level by label."
                      },
                      "direction": {
                        "description": "Defaults to desc for a measure, asc for a dimension.",
                        "type": "string",
                        "enum": [
                          "asc",
                          "desc"
                        ]
                      }
                    },
                    "required": [
                      "alias"
                    ],
                    "additionalProperties": false
                  },
                  "columnTopN": {
                    "description": "Keeps the top column groups by the first measure's total; defaults to 10.",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 50
                  },
                  "rowTopN": {
                    "description": "Keeps the top-level row groups ranked first by `sort`; omitted, up to 500 row groups return.",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 500
                  }
                },
                "required": [
                  "tableId",
                  "rowDimensions",
                  "measures"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Tool result."
          },
          "400": {
            "$ref": "#/components/responses/400"
          },
          "401": {
            "$ref": "#/components/responses/401"
          },
          "402": {
            "$ref": "#/components/responses/402"
          },
          "403": {
            "$ref": "#/components/responses/403"
          },
          "404": {
            "$ref": "#/components/responses/404"
          },
          "422": {
            "$ref": "#/components/responses/422"
          },
          "429": {
            "$ref": "#/components/responses/429"
          },
          "504": {
            "$ref": "#/components/responses/504"
          },
          "5XX": {
            "$ref": "#/components/responses/5XX"
          }
        },
        "x-mint": {
          "metadata": {
            "playground": "none"
          }
        }
      }
    },
    "/v1/read_conversations": {
      "post": {
        "operationId": "read_conversations",
        "summary": "read_conversations",
        "description": "Read full transcripts for up to 10 specific tickets per call, returned as up to 400KB of text; read_table returns table rows; enrich_worksheet judges worksheet rows' transcripts concurrently in a background job. `shortIds` and `externalIds` share the id limit. Results cover only the requested ids; the tool does not select a representative sample or calculate population counts. The response flags truncation when size limits omit messages or conversations.\n\nEach ticket is a `# conversation <id>` block, where `<id>` is the `external_id` when the ticket has one, else its `short_id`, followed by metadata lines and one `## <id>#<n>` header per message with body lines prefixed `<id>#<n> | `. `searchable_fields_omitted` names custom fields cut for size. A final `# not found` block lists unresolved ids with the reason.\n\nThis operation is an MCP tool today. Call it through the [Rippit MCP server](/mcp-server/overview) with the same name and parameters. The HTTP endpoint is not available yet.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "shortIds": {
                    "description": "Rippit `ticket_sid` values from a table or tool result, not worksheet row ids such as `__pkey`.",
                    "maxItems": 10,
                    "type": "array",
                    "items": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    }
                  },
                  "externalIds": {
                    "description": "Source-system ticket ids (an `external_id` column); a ticket number the user names is usually one of these.",
                    "maxItems": 10,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1
                    }
                  },
                  "bodyMode": {
                    "description": "Defaults to `stripped`: HTML and quoted email history removed, each body capped at 10,000 characters. `full` returns the stored body.",
                    "type": "string",
                    "enum": [
                      "stripped",
                      "full"
                    ]
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Tool result."
          },
          "400": {
            "$ref": "#/components/responses/400"
          },
          "401": {
            "$ref": "#/components/responses/401"
          },
          "402": {
            "$ref": "#/components/responses/402"
          },
          "403": {
            "$ref": "#/components/responses/403"
          },
          "404": {
            "$ref": "#/components/responses/404"
          },
          "422": {
            "$ref": "#/components/responses/422"
          },
          "429": {
            "$ref": "#/components/responses/429"
          },
          "504": {
            "$ref": "#/components/responses/504"
          },
          "5XX": {
            "$ref": "#/components/responses/5XX"
          }
        },
        "x-mint": {
          "metadata": {
            "playground": "none"
          }
        }
      }
    },
    "/v1/read_table": {
      "post": {
        "operationId": "read_table",
        "summary": "read_table",
        "description": "Read rows from a Rippit table or worksheet; aggregate_table computes counts, sums and group-bys. Rows are keyed by column id, and without `orderBy` they come in storage order, not as a random sample. Worksheet rows always include `__pkey`, a decimal integer string to pass back unchanged when writing cells; source ids such as `sys_id` are separate columns. singleSelect values are option ids that `columns[].options` maps to labels. `pagination.nextOffset` is present while more rows may exist.\n\nThis operation is an MCP tool today. Call it through the [Rippit MCP server](/mcp-server/overview) with the same name and parameters. The HTTP endpoint is not available yet.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "tableId": {
                    "type": "string",
                    "minLength": 1,
                    "pattern": "^[A-Za-z0-9_-]+$",
                    "description": "Table or worksheet id."
                  },
                  "limit": {
                    "description": "Defaults to 100.",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 1000
                  },
                  "offset": {
                    "description": "Zero-based row offset.",
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  "columnIds": {
                    "description": "Columns to return; omit for all.",
                    "maxItems": 50,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "description": "Column id, not its label."
                    }
                  },
                  "orderBy": {
                    "description": "Sort keys in priority order. Ties break on the primary key except on external tables, so their pages can overlap.",
                    "maxItems": 10,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "columnId": {
                          "type": "string",
                          "minLength": 1,
                          "description": "Column id, not its label."
                        },
                        "direction": {
                          "description": "Defaults to ascending.",
                          "type": "string",
                          "enum": [
                            "asc",
                            "desc"
                          ]
                        }
                      },
                      "required": [
                        "columnId"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "where": {
                    "description": "AND-combined filters. They narrow within any admin Table View filters, which the server applies to every read and aggregation.",
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "$ref": "#/components/schemas/read_table____schema0"
                    }
                  },
                  "arrayExpansions": {
                    "description": "Explode array columns into one row per element, referenced by alias; empty arrays yield no rows, and counts describe elements, not records.",
                    "maxItems": 3,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "columnId": {
                          "type": "string",
                          "minLength": 1,
                          "description": "Array column id."
                        },
                        "alias": {
                          "type": "string",
                          "pattern": "^[A-Za-z][A-Za-z0-9_]*$",
                          "description": "Unused column id for the elements."
                        }
                      },
                      "required": [
                        "columnId",
                        "alias"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "tableId"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Tool result."
          },
          "400": {
            "$ref": "#/components/responses/400"
          },
          "401": {
            "$ref": "#/components/responses/401"
          },
          "402": {
            "$ref": "#/components/responses/402"
          },
          "403": {
            "$ref": "#/components/responses/403"
          },
          "404": {
            "$ref": "#/components/responses/404"
          },
          "422": {
            "$ref": "#/components/responses/422"
          },
          "429": {
            "$ref": "#/components/responses/429"
          },
          "504": {
            "$ref": "#/components/responses/504"
          },
          "5XX": {
            "$ref": "#/components/responses/5XX"
          }
        },
        "x-mint": {
          "metadata": {
            "playground": "none"
          }
        }
      }
    }
  }
}
