{
  "service": "bot_star",
  "displayName": "BotStar",
  "categories": [
    "Communication",
    "Marketing"
  ],
  "authTypes": [
    "api_key"
  ],
  "auth": [
    {
      "type": "api_key",
      "label": "API Token",
      "placeholder": "BOTSTAR_API_TOKEN",
      "description": "BotStar API token sent as a Bearer token. Copy it from the BotStar account profile page: https://app.botstar.com/account/profile.",
      "extraFields": []
    }
  ],
  "homepageUrl": "https://botstar.com",
  "actions": [
    {
      "id": "bot_star.create_bot",
      "service": "bot_star",
      "name": "create_bot",
      "description": "Create a new BotStar bot.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 250,
            "description": "The new bot name."
          }
        },
        "additionalProperties": false,
        "required": [
          "name"
        ],
        "description": "Input for creating a BotStar bot."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "bot": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "The BotStar bot ID."
              },
              "name": {
                "type": "string",
                "description": "The bot name."
              },
              "team_name": {
                "type": "string",
                "description": "The BotStar team name associated with the bot."
              }
            },
            "additionalProperties": true,
            "required": [
              "id"
            ],
            "description": "A BotStar bot."
          }
        },
        "additionalProperties": false,
        "required": [
          "bot"
        ],
        "description": "A BotStar bot result."
      }
    },
    {
      "id": "bot_star.create_bot_attribute",
      "service": "bot_star",
      "name": "create_bot_attribute",
      "description": "Create an attribute on a BotStar bot.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "botId": {
            "type": "string",
            "minLength": 1,
            "description": "The BotStar bot ID."
          },
          "env": {
            "type": "string",
            "enum": [
              "draft",
              "draft,live"
            ],
            "description": "The BotStar environment target for mutation endpoints."
          },
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 250,
            "description": "The bot attribute name."
          },
          "data_type": {
            "type": "string",
            "enum": [
              "string",
              "number",
              "date"
            ],
            "description": "The bot attribute data type."
          },
          "desc": {
            "type": "string",
            "description": "The bot attribute description."
          },
          "value": {
            "anyOf": [
              {
                "type": "string",
                "description": "A string or date attribute value."
              },
              {
                "type": "number",
                "description": "A numeric attribute value."
              }
            ],
            "description": "A BotStar bot attribute value."
          },
          "localizedValues": {
            "type": "object",
            "additionalProperties": {
              "anyOf": [
                {
                  "type": "string",
                  "description": "A string or date attribute value."
                },
                {
                  "type": "number",
                  "description": "A numeric attribute value."
                }
              ],
              "description": "A BotStar bot attribute value."
            },
            "description": "Language-specific attribute values keyed by BotStar field name such as value_es."
          }
        },
        "additionalProperties": false,
        "required": [
          "botId",
          "name",
          "data_type"
        ],
        "description": "Input for creating a BotStar bot attribute."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "attribute": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "The BotStar bot attribute ID."
              },
              "name": {
                "type": "string",
                "description": "The bot attribute name."
              },
              "data_type": {
                "type": "string",
                "enum": [
                  "string",
                  "number",
                  "date"
                ],
                "description": "The BotStar bot attribute data type."
              },
              "desc": {
                "type": "string",
                "description": "The bot attribute description when returned."
              },
              "value": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "A string or date attribute value."
                  },
                  {
                    "type": "number",
                    "description": "A numeric attribute value."
                  }
                ],
                "description": "The default bot attribute value."
              }
            },
            "additionalProperties": true,
            "required": [
              "id",
              "name",
              "data_type"
            ],
            "description": "A BotStar bot attribute."
          }
        },
        "additionalProperties": false,
        "required": [
          "attribute"
        ],
        "description": "A BotStar bot attribute result."
      }
    },
    {
      "id": "bot_star.create_cms_entity",
      "service": "bot_star",
      "name": "create_cms_entity",
      "description": "Create a BotStar CMS entity.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "botId": {
            "type": "string",
            "minLength": 1,
            "description": "The BotStar bot ID."
          },
          "env": {
            "type": "string",
            "enum": [
              "draft",
              "draft,live"
            ],
            "description": "The BotStar environment target for mutation endpoints."
          },
          "name": {
            "type": "string",
            "minLength": 1,
            "description": "The CMS entity name."
          },
          "fields": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "unique_name": {
                  "type": "string",
                  "minLength": 1,
                  "description": "The unique BotStar field name."
                },
                "name": {
                  "type": "string",
                  "minLength": 1,
                  "description": "The CMS field display name."
                },
                "data_type": {
                  "type": "string",
                  "minLength": 1,
                  "description": "The BotStar CMS field data type."
                },
                "options": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": true,
                  "description": "Field options such as predefined_data or entity_id."
                }
              },
              "additionalProperties": false,
              "required": [
                "unique_name",
                "name",
                "data_type"
              ],
              "description": "A field definition to create with a BotStar CMS entity."
            },
            "description": "Fields to create with the CMS entity.",
            "minItems": 1
          }
        },
        "additionalProperties": false,
        "required": [
          "botId",
          "name"
        ],
        "description": "Input for creating a BotStar CMS entity."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "entity": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "The BotStar CMS entity ID."
              },
              "name": {
                "type": "string",
                "description": "The CMS entity name."
              },
              "fields": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "unique_name": {
                      "type": "string",
                      "description": "The unique BotStar field name."
                    },
                    "name": {
                      "type": "string",
                      "description": "The CMS field display name."
                    },
                    "data_type": {
                      "type": "string",
                      "description": "The BotStar CMS field data type."
                    },
                    "options": {
                      "type": "object",
                      "properties": {},
                      "additionalProperties": true,
                      "description": "Field options returned by BotStar when available."
                    }
                  },
                  "additionalProperties": true,
                  "description": "A BotStar CMS entity field."
                },
                "description": "The CMS entity fields returned by BotStar."
              }
            },
            "additionalProperties": true,
            "required": [
              "id",
              "name"
            ],
            "description": "A BotStar CMS entity."
          }
        },
        "additionalProperties": false,
        "required": [
          "entity"
        ],
        "description": "A BotStar CMS entity result."
      }
    },
    {
      "id": "bot_star.create_cms_entity_item",
      "service": "bot_star",
      "name": "create_cms_entity_item",
      "description": "Create an item in a BotStar CMS entity.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "botId": {
            "type": "string",
            "minLength": 1,
            "description": "The BotStar bot ID."
          },
          "entityId": {
            "type": "string",
            "minLength": 1,
            "description": "The BotStar CMS entity ID."
          },
          "env": {
            "type": "string",
            "enum": [
              "draft",
              "draft,live"
            ],
            "description": "The BotStar environment target for mutation endpoints."
          },
          "name": {
            "type": "string",
            "minLength": 1,
            "description": "The CMS entity item name."
          },
          "status": {
            "type": "string",
            "enum": [
              "enabled",
              "disabled"
            ],
            "description": "The BotStar CMS entity item status."
          },
          "data": {
            "type": "object",
            "additionalProperties": {
              "anyOf": [
                {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "A string field value."
                    },
                    {
                      "type": "number",
                      "description": "A numeric field value."
                    },
                    {
                      "type": "boolean",
                      "description": "A boolean field value."
                    },
                    {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "description": "One selected value."
                      },
                      "description": "A multi-value field value."
                    }
                  ],
                  "description": "A CMS item field value."
                },
                {
                  "type": "null"
                }
              ]
            },
            "description": "Dynamic CMS item field values keyed by BotStar field unique name, excluding name and status."
          }
        },
        "additionalProperties": false,
        "required": [
          "botId",
          "entityId",
          "name"
        ],
        "description": "Input for creating a BotStar CMS entity item."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "item": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "The BotStar CMS entity item ID."
              },
              "name": {
                "type": "string",
                "description": "The CMS entity item name."
              },
              "status": {
                "type": "string",
                "enum": [
                  "enabled",
                  "disabled"
                ],
                "description": "The BotStar CMS entity item status."
              },
              "entity_id": {
                "type": "string",
                "description": "The BotStar CMS entity ID associated with the item."
              }
            },
            "additionalProperties": true,
            "required": [
              "id",
              "name"
            ],
            "description": "A BotStar CMS entity item."
          }
        },
        "additionalProperties": false,
        "required": [
          "item"
        ],
        "description": "A BotStar CMS entity item result."
      }
    },
    {
      "id": "bot_star.create_user_attribute",
      "service": "bot_star",
      "name": "create_user_attribute",
      "description": "Create a custom user attribute field for a BotStar bot.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "botId": {
            "type": "string",
            "minLength": 1,
            "description": "The BotStar bot ID."
          },
          "field_name": {
            "type": "string",
            "minLength": 1,
            "description": "The custom user attribute field name."
          },
          "field_type": {
            "type": "string",
            "enum": [
              "string",
              "number",
              "date",
              "boolean"
            ],
            "description": "The custom user attribute type."
          }
        },
        "additionalProperties": false,
        "required": [
          "botId",
          "field_name",
          "field_type"
        ],
        "description": "Input for creating a custom BotStar user field."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "attribute": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "The BotStar custom user attribute ID."
              },
              "field_name": {
                "type": "string",
                "description": "The custom user attribute field name."
              },
              "field_type": {
                "type": "string",
                "enum": [
                  "string",
                  "number",
                  "date",
                  "boolean"
                ],
                "description": "The custom user attribute type."
              }
            },
            "additionalProperties": true,
            "description": "A BotStar custom user attribute."
          }
        },
        "additionalProperties": false,
        "required": [
          "attribute"
        ],
        "description": "A BotStar custom user attribute result."
      }
    },
    {
      "id": "bot_star.delete_bot_attribute",
      "service": "bot_star",
      "name": "delete_bot_attribute",
      "description": "Delete a BotStar bot attribute.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "botId": {
            "type": "string",
            "minLength": 1,
            "description": "The BotStar bot ID."
          },
          "attributeId": {
            "type": "string",
            "minLength": 1,
            "description": "The BotStar bot attribute ID."
          },
          "env": {
            "type": "string",
            "enum": [
              "draft",
              "draft,live"
            ],
            "description": "The BotStar environment target for mutation endpoints."
          }
        },
        "additionalProperties": false,
        "required": [
          "botId",
          "attributeId"
        ],
        "description": "Input for deleting a BotStar bot attribute."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "description": "Whether BotStar accepted the request."
          },
          "status": {
            "type": "string",
            "description": "The status string returned by BotStar."
          }
        },
        "additionalProperties": false,
        "required": [
          "success",
          "status"
        ],
        "description": "A BotStar success response."
      }
    },
    {
      "id": "bot_star.delete_cms_entity",
      "service": "bot_star",
      "name": "delete_cms_entity",
      "description": "Delete a BotStar CMS entity.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "botId": {
            "type": "string",
            "minLength": 1,
            "description": "The BotStar bot ID."
          },
          "entityId": {
            "type": "string",
            "minLength": 1,
            "description": "The BotStar CMS entity ID."
          },
          "env": {
            "type": "string",
            "enum": [
              "draft",
              "draft,live"
            ],
            "description": "The BotStar environment target for mutation endpoints."
          }
        },
        "additionalProperties": false,
        "required": [
          "botId",
          "entityId"
        ],
        "description": "Input for deleting a BotStar CMS entity."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "description": "Whether BotStar accepted the request."
          },
          "status": {
            "type": "string",
            "description": "The status string returned by BotStar."
          }
        },
        "additionalProperties": false,
        "required": [
          "success",
          "status"
        ],
        "description": "A BotStar success response."
      }
    },
    {
      "id": "bot_star.delete_cms_entity_item",
      "service": "bot_star",
      "name": "delete_cms_entity_item",
      "description": "Delete an item from a BotStar CMS entity.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "botId": {
            "type": "string",
            "minLength": 1,
            "description": "The BotStar bot ID."
          },
          "entityId": {
            "type": "string",
            "minLength": 1,
            "description": "The BotStar CMS entity ID."
          },
          "entityItemId": {
            "type": "string",
            "minLength": 1,
            "description": "The BotStar CMS entity item ID."
          },
          "env": {
            "type": "string",
            "enum": [
              "draft",
              "draft,live"
            ],
            "description": "The BotStar environment target for mutation endpoints."
          }
        },
        "additionalProperties": false,
        "required": [
          "botId",
          "entityId",
          "entityItemId"
        ],
        "description": "Input for deleting a BotStar CMS entity item."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "description": "Whether BotStar accepted the request."
          },
          "status": {
            "type": "string",
            "description": "The status string returned by BotStar."
          }
        },
        "additionalProperties": false,
        "required": [
          "success",
          "status"
        ],
        "description": "A BotStar success response."
      }
    },
    {
      "id": "bot_star.get_bot",
      "service": "bot_star",
      "name": "get_bot",
      "description": "Get one BotStar bot by ID.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "botId": {
            "type": "string",
            "minLength": 1,
            "description": "The BotStar bot ID."
          }
        },
        "additionalProperties": false,
        "required": [
          "botId"
        ],
        "description": "Input identifying one BotStar bot."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "bot": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "The BotStar bot ID."
              },
              "name": {
                "type": "string",
                "description": "The bot name."
              },
              "team_name": {
                "type": "string",
                "description": "The BotStar team name associated with the bot."
              }
            },
            "additionalProperties": true,
            "required": [
              "id"
            ],
            "description": "A BotStar bot."
          }
        },
        "additionalProperties": false,
        "required": [
          "bot"
        ],
        "description": "A BotStar bot result."
      }
    },
    {
      "id": "bot_star.get_cms_entity",
      "service": "bot_star",
      "name": "get_cms_entity",
      "description": "Get one BotStar CMS entity by ID.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "botId": {
            "type": "string",
            "minLength": 1,
            "description": "The BotStar bot ID."
          },
          "entityId": {
            "type": "string",
            "minLength": 1,
            "description": "The BotStar CMS entity ID."
          },
          "env": {
            "type": "string",
            "enum": [
              "draft",
              "live"
            ],
            "description": "The BotStar environment to read or mutate."
          }
        },
        "additionalProperties": false,
        "required": [
          "botId",
          "entityId"
        ],
        "description": "Input identifying one BotStar CMS entity."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "entity": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "The BotStar CMS entity ID."
              },
              "name": {
                "type": "string",
                "description": "The CMS entity name."
              },
              "fields": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "unique_name": {
                      "type": "string",
                      "description": "The unique BotStar field name."
                    },
                    "name": {
                      "type": "string",
                      "description": "The CMS field display name."
                    },
                    "data_type": {
                      "type": "string",
                      "description": "The BotStar CMS field data type."
                    },
                    "options": {
                      "type": "object",
                      "properties": {},
                      "additionalProperties": true,
                      "description": "Field options returned by BotStar when available."
                    }
                  },
                  "additionalProperties": true,
                  "description": "A BotStar CMS entity field."
                },
                "description": "The CMS entity fields returned by BotStar."
              }
            },
            "additionalProperties": true,
            "required": [
              "id",
              "name"
            ],
            "description": "A BotStar CMS entity."
          }
        },
        "additionalProperties": false,
        "required": [
          "entity"
        ],
        "description": "A BotStar CMS entity result."
      }
    },
    {
      "id": "bot_star.get_cms_entity_item",
      "service": "bot_star",
      "name": "get_cms_entity_item",
      "description": "Get one item from a BotStar CMS entity.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "botId": {
            "type": "string",
            "minLength": 1,
            "description": "The BotStar bot ID."
          },
          "entityId": {
            "type": "string",
            "minLength": 1,
            "description": "The BotStar CMS entity ID."
          },
          "entityItemId": {
            "type": "string",
            "minLength": 1,
            "description": "The BotStar CMS entity item ID."
          },
          "env": {
            "type": "string",
            "enum": [
              "draft",
              "live"
            ],
            "description": "The BotStar environment to read or mutate."
          }
        },
        "additionalProperties": false,
        "required": [
          "botId",
          "entityId",
          "entityItemId"
        ],
        "description": "Input for retrieving one BotStar CMS entity item."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "item": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "The BotStar CMS entity item ID."
              },
              "name": {
                "type": "string",
                "description": "The CMS entity item name."
              },
              "status": {
                "type": "string",
                "enum": [
                  "enabled",
                  "disabled"
                ],
                "description": "The BotStar CMS entity item status."
              },
              "entity_id": {
                "type": "string",
                "description": "The BotStar CMS entity ID associated with the item."
              }
            },
            "additionalProperties": true,
            "required": [
              "id",
              "name"
            ],
            "description": "A BotStar CMS entity item."
          }
        },
        "additionalProperties": false,
        "required": [
          "item"
        ],
        "description": "A BotStar CMS entity item result."
      }
    },
    {
      "id": "bot_star.get_user",
      "service": "bot_star",
      "name": "get_user",
      "description": "Get a BotStar audience user by bot ID and user ID.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "botId": {
            "type": "string",
            "minLength": 1,
            "description": "The BotStar bot ID."
          },
          "userId": {
            "type": "string",
            "minLength": 1,
            "description": "The BotStar audience user ID."
          }
        },
        "additionalProperties": false,
        "required": [
          "botId",
          "userId"
        ],
        "description": "Input identifying a BotStar audience user."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "user": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "The BotStar user ID."
              },
              "board_id": {
                "type": "string",
                "description": "The BotStar board ID associated with the user."
              },
              "name": {
                "type": "string",
                "description": "The user's full name when available."
              },
              "first_name": {
                "type": "string",
                "description": "The user's first name when available."
              },
              "last_name": {
                "type": "string",
                "description": "The user's last name when available."
              },
              "email": {
                "type": "string",
                "description": "The user's email address when available."
              },
              "channel": {
                "type": "string",
                "description": "The channel through which the user interacted."
              },
              "locale": {
                "type": "string",
                "description": "The user's locale when available."
              }
            },
            "additionalProperties": true,
            "description": "A BotStar audience user."
          }
        },
        "additionalProperties": false,
        "required": [
          "user"
        ],
        "description": "A BotStar user result."
      }
    },
    {
      "id": "bot_star.list_bot_attributes",
      "service": "bot_star",
      "name": "list_bot_attributes",
      "description": "List attributes configured for a BotStar bot.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "botId": {
            "type": "string",
            "minLength": 1,
            "description": "The BotStar bot ID."
          },
          "env": {
            "type": "string",
            "enum": [
              "draft",
              "live"
            ],
            "description": "The BotStar environment to read or mutate."
          }
        },
        "additionalProperties": false,
        "required": [
          "botId"
        ],
        "description": "Input for listing BotStar bot attributes."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "attributes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "The BotStar bot attribute ID."
                },
                "name": {
                  "type": "string",
                  "description": "The bot attribute name."
                },
                "data_type": {
                  "type": "string",
                  "enum": [
                    "string",
                    "number",
                    "date"
                  ],
                  "description": "The BotStar bot attribute data type."
                },
                "desc": {
                  "type": "string",
                  "description": "The bot attribute description when returned."
                },
                "value": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "A string or date attribute value."
                    },
                    {
                      "type": "number",
                      "description": "A numeric attribute value."
                    }
                  ],
                  "description": "The default bot attribute value."
                }
              },
              "additionalProperties": true,
              "required": [
                "id",
                "name",
                "data_type"
              ],
              "description": "A BotStar bot attribute."
            },
            "description": "The bot attributes returned by BotStar."
          }
        },
        "additionalProperties": false,
        "required": [
          "attributes"
        ],
        "description": "BotStar bot attributes result."
      }
    },
    {
      "id": "bot_star.list_bots",
      "service": "bot_star",
      "name": "list_bots",
      "description": "List bots available to the configured BotStar API token.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false,
        "description": "The empty input payload for this BotStar action."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "bots": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "The BotStar bot ID."
                },
                "name": {
                  "type": "string",
                  "description": "The bot name."
                },
                "team_name": {
                  "type": "string",
                  "description": "The BotStar team name associated with the bot."
                }
              },
              "additionalProperties": true,
              "required": [
                "id"
              ],
              "description": "A BotStar bot."
            },
            "description": "The bots returned by BotStar."
          }
        },
        "additionalProperties": false,
        "required": [
          "bots"
        ],
        "description": "BotStar bot list result."
      }
    },
    {
      "id": "bot_star.list_cms_entities",
      "service": "bot_star",
      "name": "list_cms_entities",
      "description": "List CMS entities configured for a BotStar bot.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "botId": {
            "type": "string",
            "minLength": 1,
            "description": "The BotStar bot ID."
          },
          "env": {
            "type": "string",
            "enum": [
              "draft",
              "live"
            ],
            "description": "The BotStar environment to read or mutate."
          }
        },
        "additionalProperties": false,
        "required": [
          "botId"
        ],
        "description": "Input for listing BotStar CMS entities."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "entities": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "The BotStar CMS entity ID."
                },
                "name": {
                  "type": "string",
                  "description": "The CMS entity name."
                },
                "fields": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "unique_name": {
                        "type": "string",
                        "description": "The unique BotStar field name."
                      },
                      "name": {
                        "type": "string",
                        "description": "The CMS field display name."
                      },
                      "data_type": {
                        "type": "string",
                        "description": "The BotStar CMS field data type."
                      },
                      "options": {
                        "type": "object",
                        "properties": {},
                        "additionalProperties": true,
                        "description": "Field options returned by BotStar when available."
                      }
                    },
                    "additionalProperties": true,
                    "description": "A BotStar CMS entity field."
                  },
                  "description": "The CMS entity fields returned by BotStar."
                }
              },
              "additionalProperties": true,
              "required": [
                "id",
                "name"
              ],
              "description": "A BotStar CMS entity."
            },
            "description": "The CMS entities returned by BotStar."
          }
        },
        "additionalProperties": false,
        "required": [
          "entities"
        ],
        "description": "BotStar CMS entities result."
      }
    },
    {
      "id": "bot_star.list_cms_entity_items",
      "service": "bot_star",
      "name": "list_cms_entity_items",
      "description": "List items in a BotStar CMS entity.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "botId": {
            "type": "string",
            "minLength": 1,
            "description": "The BotStar bot ID."
          },
          "entityId": {
            "type": "string",
            "minLength": 1,
            "description": "The BotStar CMS entity ID."
          },
          "env": {
            "type": "string",
            "enum": [
              "draft",
              "live"
            ],
            "description": "The BotStar environment to read or mutate."
          },
          "page": {
            "type": "integer",
            "minimum": 1,
            "description": "The 1-based page number to request."
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "description": "The maximum number of items to return."
          },
          "name": {
            "type": "string",
            "minLength": 1,
            "description": "Filter CMS entity items by name."
          },
          "status": {
            "type": "string",
            "enum": [
              "enabled",
              "disabled"
            ],
            "description": "The BotStar CMS entity item status."
          }
        },
        "additionalProperties": false,
        "required": [
          "botId",
          "entityId"
        ],
        "description": "Input for listing BotStar CMS entity items."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "The BotStar CMS entity item ID."
                },
                "name": {
                  "type": "string",
                  "description": "The CMS entity item name."
                },
                "status": {
                  "type": "string",
                  "enum": [
                    "enabled",
                    "disabled"
                  ],
                  "description": "The BotStar CMS entity item status."
                },
                "entity_id": {
                  "type": "string",
                  "description": "The BotStar CMS entity ID associated with the item."
                }
              },
              "additionalProperties": true,
              "required": [
                "id",
                "name"
              ],
              "description": "A BotStar CMS entity item."
            },
            "description": "The CMS entity items returned by BotStar."
          }
        },
        "additionalProperties": false,
        "required": [
          "items"
        ],
        "description": "BotStar CMS entity items result."
      }
    },
    {
      "id": "bot_star.publish_bot",
      "service": "bot_star",
      "name": "publish_bot",
      "description": "Publish BotStar bot changes to the live environment.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "botId": {
            "type": "string",
            "minLength": 1,
            "description": "The BotStar bot ID."
          }
        },
        "additionalProperties": false,
        "required": [
          "botId"
        ],
        "description": "Input identifying one BotStar bot."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "description": "Whether BotStar accepted the request."
          },
          "status": {
            "type": "string",
            "description": "The status string returned by BotStar."
          }
        },
        "additionalProperties": false,
        "required": [
          "success",
          "status"
        ],
        "description": "A BotStar success response."
      }
    },
    {
      "id": "bot_star.update_bot_attribute",
      "service": "bot_star",
      "name": "update_bot_attribute",
      "description": "Update an existing BotStar bot attribute.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "botId": {
            "type": "string",
            "minLength": 1,
            "description": "The BotStar bot ID."
          },
          "attributeId": {
            "type": "string",
            "minLength": 1,
            "description": "The BotStar bot attribute ID."
          },
          "env": {
            "type": "string",
            "enum": [
              "draft",
              "draft,live"
            ],
            "description": "The BotStar environment target for mutation endpoints."
          },
          "desc": {
            "type": "string",
            "description": "The updated bot attribute description."
          },
          "value": {
            "anyOf": [
              {
                "type": "string",
                "description": "A string or date attribute value."
              },
              {
                "type": "number",
                "description": "A numeric attribute value."
              }
            ],
            "description": "A BotStar bot attribute value."
          },
          "localizedValues": {
            "type": "object",
            "additionalProperties": {
              "anyOf": [
                {
                  "type": "string",
                  "description": "A string or date attribute value."
                },
                {
                  "type": "number",
                  "description": "A numeric attribute value."
                }
              ],
              "description": "A BotStar bot attribute value."
            },
            "description": "Language-specific attribute values keyed by BotStar field name such as value_es."
          }
        },
        "additionalProperties": false,
        "required": [
          "botId",
          "attributeId"
        ],
        "description": "Input for updating a BotStar bot attribute.",
        "anyOf": [
          {
            "required": [
              "desc"
            ]
          },
          {
            "required": [
              "value"
            ]
          },
          {
            "required": [
              "localizedValues"
            ]
          }
        ]
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "attribute": {
            "type": "object",
            "properties": {},
            "additionalProperties": true,
            "description": "The raw BotStar object returned by the Public API."
          }
        },
        "additionalProperties": false,
        "required": [
          "attribute"
        ],
        "description": "A BotStar bot attribute update result."
      }
    },
    {
      "id": "bot_star.update_cms_entity",
      "service": "bot_star",
      "name": "update_cms_entity",
      "description": "Update a BotStar CMS entity.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "botId": {
            "type": "string",
            "minLength": 1,
            "description": "The BotStar bot ID."
          },
          "entityId": {
            "type": "string",
            "minLength": 1,
            "description": "The BotStar CMS entity ID."
          },
          "env": {
            "type": "string",
            "enum": [
              "draft",
              "draft,live"
            ],
            "description": "The BotStar environment target for mutation endpoints."
          },
          "name": {
            "type": "string",
            "minLength": 1,
            "description": "The updated CMS entity name."
          }
        },
        "additionalProperties": false,
        "required": [
          "botId",
          "entityId",
          "name"
        ],
        "description": "Input for updating a BotStar CMS entity."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "description": "Whether BotStar accepted the request."
          },
          "status": {
            "type": "string",
            "description": "The status string returned by BotStar."
          }
        },
        "additionalProperties": false,
        "required": [
          "success",
          "status"
        ],
        "description": "A BotStar success response."
      }
    },
    {
      "id": "bot_star.update_cms_entity_item",
      "service": "bot_star",
      "name": "update_cms_entity_item",
      "description": "Update an item in a BotStar CMS entity.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "botId": {
            "type": "string",
            "minLength": 1,
            "description": "The BotStar bot ID."
          },
          "entityId": {
            "type": "string",
            "minLength": 1,
            "description": "The BotStar CMS entity ID."
          },
          "entityItemId": {
            "type": "string",
            "minLength": 1,
            "description": "The BotStar CMS entity item ID."
          },
          "env": {
            "type": "string",
            "enum": [
              "draft",
              "draft,live"
            ],
            "description": "The BotStar environment target for mutation endpoints."
          },
          "name": {
            "type": "string",
            "minLength": 1,
            "description": "The updated CMS entity item name."
          },
          "status": {
            "type": "string",
            "enum": [
              "enabled",
              "disabled"
            ],
            "description": "The BotStar CMS entity item status."
          },
          "data": {
            "type": "object",
            "additionalProperties": {
              "anyOf": [
                {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "A string field value."
                    },
                    {
                      "type": "number",
                      "description": "A numeric field value."
                    },
                    {
                      "type": "boolean",
                      "description": "A boolean field value."
                    },
                    {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "description": "One selected value."
                      },
                      "description": "A multi-value field value."
                    }
                  ],
                  "description": "A CMS item field value."
                },
                {
                  "type": "null"
                }
              ]
            },
            "description": "Dynamic CMS item field values keyed by BotStar field unique name, excluding name and status."
          }
        },
        "additionalProperties": false,
        "required": [
          "botId",
          "entityId",
          "entityItemId"
        ],
        "description": "Input for updating a BotStar CMS entity item.",
        "anyOf": [
          {
            "required": [
              "name"
            ]
          },
          {
            "required": [
              "status"
            ]
          },
          {
            "required": [
              "data"
            ]
          }
        ]
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "description": "Whether BotStar accepted the request."
          },
          "status": {
            "type": "string",
            "description": "The status string returned by BotStar."
          }
        },
        "additionalProperties": false,
        "required": [
          "success",
          "status"
        ],
        "description": "A BotStar success response."
      }
    },
    {
      "id": "bot_star.update_user_attributes",
      "service": "bot_star",
      "name": "update_user_attributes",
      "description": "Update attributes on a BotStar audience user.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "botId": {
            "type": "string",
            "minLength": 1,
            "description": "The BotStar bot ID."
          },
          "userId": {
            "type": "string",
            "minLength": 1,
            "description": "The BotStar audience user ID."
          },
          "attributes": {
            "type": "object",
            "additionalProperties": {
              "anyOf": [
                {
                  "type": "string",
                  "description": "A string, date, or empty string user attribute value."
                },
                {
                  "type": "number",
                  "description": "A numeric user attribute value."
                },
                {
                  "type": "boolean",
                  "description": "A boolean user attribute value."
                }
              ],
              "description": "A BotStar user attribute value."
            },
            "description": "User attributes to update by BotStar field name.",
            "minProperties": 1
          }
        },
        "additionalProperties": false,
        "required": [
          "botId",
          "userId",
          "attributes"
        ],
        "description": "Input for updating BotStar user attributes."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "attributes": {
            "type": "object",
            "additionalProperties": {
              "anyOf": [
                {
                  "type": "string",
                  "description": "A string, date, or empty string user attribute value."
                },
                {
                  "type": "number",
                  "description": "A numeric user attribute value."
                },
                {
                  "type": "boolean",
                  "description": "A boolean user attribute value."
                }
              ],
              "description": "A BotStar user attribute value."
            },
            "description": "The attributes returned by BotStar."
          }
        },
        "additionalProperties": false,
        "required": [
          "attributes"
        ],
        "description": "Updated BotStar user attributes."
      }
    }
  ]
}