Skip to main content
Glama

Create Forms integration

forms_subscriptions_create

Add an integration to a form hook to run on every new answer. Create it with active: false to configure without sending data; returns the integration ID.

Instructions

Add an integration to a hook; it runs on every new answer while active is true.

Create it with active: false to configure it without sending anything yet. Returns the integration with its integer id.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
bodyYesThe integration; ``type`` selects its schema. Its schema is not listed here: read `Subscription` with schema_get(service="forms", name="Subscription"), then the definitions it refers to.
hook_idYesIntegration group id (integer) from hooks_list.
survey_idYesForm id (24-char hex), from ``surveys_list``.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed4 schema fields changedv0.122.1
    • changedInput schema / properties / body / description
      Previous value: -"The integration; ``type`` selects its schema."New value: +"The integration; ``type`` selects its schema. Its schema is not listed here: read `Subscription` with schema_get(service=\"forms\", name=\"Subscription\"), then the definitions it refers to."
    • removedInput schema / properties / body / oneOf
      Removed value: -[
      -  {
      -    "additionalProperties": true,
      -    "description": "Send an e-mail.",
      -    "properties": {
      -      "active": {
      -        "anyOf": [
      -          {
      -            "type": "boolean"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Whether the integration runs."
      -      },
      -      "attachments": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": true,
      -            "description": "What a subscription attaches: answer files and fixed files.",
      -            "properties": {
      -              "question": {
      -                "anyOf": [
      -                  {
      -                    "additionalProperties": true,
      -                    "description": "File questions whose uploads a subscription attaches.",
      -                    "properties": {
      -                      "all": {
      -                        "anyOf": [
      -                          {
      -                            "type": "boolean"
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ],
      -                        "default": null,
      -                        "description": "Attach the files of every question."
      -                      },
      -                      "items": {
      -                        "anyOf": [
      -                          {
      -                            "items": {
      -                              "type": "string"
      -                            },
      -                            "type": "array"
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ],
      -                        "default": null,
      -                        "description": "Slugs of the file questions."
      -                      }
      -                    },
      -                    "type": "object"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "default": null,
      -                "description": "File questions whose uploads are attached."
      -              },
      -              "static": {
      -                "anyOf": [
      -                  {
      -                    "items": {
      -                      "additionalProperties": true,
      -                      "description": "A fixed file attached to every run (sent by ``path``; read back with ``id`` and links).",
      -                      "properties": {
      -                        "check_status": {
      -                          "anyOf": [
      -                            {
      -                              "type": "string"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "Scan status: check, ready, infected, error, deleted."
      -                        },
      -                        "id": {
      -                          "anyOf": [
      -                            {
      -                              "type": "integer"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "Attachment id (read only)."
      -                        },
      -                        "links": {
      -                          "anyOf": [
      -                            {
      -                              "additionalProperties": true,
      -                              "type": "object"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "Download links (read only)."
      -                        },
      -                        "name": {
      -                          "anyOf": [
      -                            {
      -                              "type": "string"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "File name (read only)."
      -                        },
      -                        "path": {
      -                          "anyOf": [
      -                            {
      -                              "type": "string"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "Uploaded file path (from `subscriptions attach`)."
      -                        }
      -                      },
      -                      "type": "object"
      -                    },
      -                    "type": "array"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "default": null,
      -                "description": "Fixed files attached to every run."
      -              }
      -            },
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Files to attach."
      -      },
      -      "body": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Message body."
      -      },
      -      "email_from_title": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Sender name (max 255)."
      -      },
      -      "email_to_address": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Recipient (max 255)."
      -      },
      -      "follow": {
      -        "anyOf": [
      -          {
      -            "type": "boolean"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Notify the form's followers about the run."
      -      },
      -      "headers": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "additionalProperties": true,
      -              "description": "A name/value pair: an e-mail or HTTP header, a JSON-RPC or function parameter.",
      -              "properties": {
      -                "name": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Header or parameter name (max 255)."
      -                },
      -                "only_with_value": {
      -                  "anyOf": [
      -                    {
      -                      "type": "boolean"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Send it only when the value is not empty."
      -                },
      -                "value": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Value; may embed variables such as {form.name} (max 500)."
      -                }
      -              },
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Extra message headers."
      -      },
      -      "id": {
      -        "anyOf": [
      -          {
      -            "type": "integer"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Subscription id (integer, read only)."
      -      },
      -      "subject": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Message subject (max 255)."
      -      },
      -      "type": {
      -        "const": "email",
      -        "default": "email",
      -        "description": "Discriminator: email.",
      -        "type": "string"
      -      },
      -      "variables": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "additionalProperties": true,
      -              "description": "A variable configured on a subscription and referenced from its texts by ``id``.",
      -              "properties": {
      -                "filters": {
      -                  "anyOf": [
      -                    {
      -                      "items": {
      -                        "type": "string"
      -                      },
      -                      "type": "array"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Filters applied to the value: md5, base64, lower, upper, …."
      -                },
      -                "id": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Variable id, referenced from the texts."
      -                },
      -                "name": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Variable display name."
      -                },
      -                "only_with_value": {
      -                  "anyOf": [
      -                    {
      -                      "type": "boolean"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Render only answered questions."
      -                },
      -                "question": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Question slug the variable reads (single-question types)."
      -                },
      -                "questions": {
      -                  "anyOf": [
      -                    {
      -                      "additionalProperties": true,
      -                      "description": "Which questions a variable covers (``all``, or the listed slugs).",
      -                      "properties": {
      -                        "all": {
      -                          "anyOf": [
      -                            {
      -                              "type": "boolean"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "Cover every question of the form."
      -                        },
      -                        "items": {
      -                          "anyOf": [
      -                            {
      -                              "items": {
      -                                "type": "string"
      -                              },
      -                              "type": "array"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "Slugs of the covered questions."
      -                        }
      -                      },
      -                      "type": "object"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Questions the variable reads (multi-question types)."
      -                },
      -                "renderer": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "How the value renders: txt, formatted, yfm, json, …."
      -                },
      -                "secret": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Secret value (write only)."
      -                },
      -                "show_filenames": {
      -                  "anyOf": [
      -                    {
      -                      "type": "boolean"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Render file answers as file names."
      -                },
      -                "type": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Variable type, e.g. form.name or form.question_answer."
      -                },
      -                "version": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Variable format version (write only)."
      -                }
      -              },
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Variables referenced from the subscription's texts."
      -      }
      -    },
      -    "required": [
      -      "type"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": true,
      -    "description": "Create a Tracker issue.",
      -    "properties": {
      -      "active": {
      -        "anyOf": [
      -          {
      -            "type": "boolean"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Whether the integration runs."
      -      },
      -      "assignee": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Assignee login."
      -      },
      -      "attachments": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": true,
      -            "description": "What a subscription attaches: answer files and fixed files.",
      -            "properties": {
      -              "question": {
      -                "anyOf": [
      -                  {
      -                    "additionalProperties": true,
      -                    "description": "File questions whose uploads a subscription attaches.",
      -                    "properties": {
      -                      "all": {
      -                        "anyOf": [
      -                          {
      -                            "type": "boolean"
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ],
      -                        "default": null,
      -                        "description": "Attach the files of every question."
      -                      },
      -                      "items": {
      -                        "anyOf": [
      -                          {
      -                            "items": {
      -                              "type": "string"
      -                            },
      -                            "type": "array"
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ],
      -                        "default": null,
      -                        "description": "Slugs of the file questions."
      -                      }
      -                    },
      -                    "type": "object"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "default": null,
      -                "description": "File questions whose uploads are attached."
      -              },
      -              "static": {
      -                "anyOf": [
      -                  {
      -                    "items": {
      -                      "additionalProperties": true,
      -                      "description": "A fixed file attached to every run (sent by ``path``; read back with ``id`` and links).",
      -                      "properties": {
      -                        "check_status": {
      -                          "anyOf": [
      -                            {
      -                              "type": "string"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "Scan status: check, ready, infected, error, deleted."
      -                        },
      -                        "id": {
      -                          "anyOf": [
      -                            {
      -                              "type": "integer"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "Attachment id (read only)."
      -                        },
      -                        "links": {
      -                          "anyOf": [
      -                            {
      -                              "additionalProperties": true,
      -                              "type": "object"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "Download links (read only)."
      -                        },
      -                        "name": {
      -                          "anyOf": [
      -                            {
      -                              "type": "string"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "File name (read only)."
      -                        },
      -                        "path": {
      -                          "anyOf": [
      -                            {
      -                              "type": "string"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "Uploaded file path (from `subscriptions attach`)."
      -                        }
      -                      },
      -                      "type": "object"
      -                    },
      -                    "type": "array"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "default": null,
      -                "description": "Fixed files attached to every run."
      -              }
      -            },
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Files to attach."
      -      },
      -      "author": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Issue author login."
      -      },
      -      "body": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Issue description."
      -      },
      -      "fields": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "additionalProperties": true,
      -              "description": "One Tracker issue field a tracker subscription fills.",
      -              "properties": {
      -                "key": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "additionalProperties": true,
      -                      "description": "A Tracker issue field addressed by slug.",
      -                      "properties": {
      -                        "name": {
      -                          "anyOf": [
      -                            {
      -                              "type": "string"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "Field display name."
      -                        },
      -                        "slug": {
      -                          "anyOf": [
      -                            {
      -                              "type": "string"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "Tracker field key, e.g. tags."
      -                        },
      -                        "type": {
      -                          "anyOf": [
      -                            {
      -                              "type": "string"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "Field type (default string)."
      -                        }
      -                      },
      -                      "type": "object"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Field key: a slug, or an object with slug/name/type."
      -                },
      -                "only_with_value": {
      -                  "anyOf": [
      -                    {
      -                      "type": "boolean"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Set the field only when the value is not empty."
      -                },
      -                "value": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Field value; may embed variables."
      -                }
      -              },
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Other issue fields."
      -      },
      -      "follow": {
      -        "anyOf": [
      -          {
      -            "type": "boolean"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Notify the form's followers about the run."
      -      },
      -      "id": {
      -        "anyOf": [
      -          {
      -            "type": "integer"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Subscription id (integer, read only)."
      -      },
      -      "issue_type": {
      -        "anyOf": [
      -          {
      -            "type": "integer"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Issue type id."
      -      },
      -      "parent": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Parent issue key."
      -      },
      -      "priority": {
      -        "anyOf": [
      -          {
      -            "type": "integer"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Priority id."
      -      },
      -      "queue": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Queue key (max 255)."
      -      },
      -      "subject": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Issue summary."
      -      },
      -      "type": {
      -        "const": "tracker",
      -        "default": "tracker",
      -        "description": "Discriminator: tracker.",
      -        "type": "string"
      -      },
      -      "variables": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "additionalProperties": true,
      -              "description": "A variable configured on a subscription and referenced from its texts by ``id``.",
      -              "properties": {
      -                "filters": {
      -                  "anyOf": [
      -                    {
      -                      "items": {
      -                        "type": "string"
      -                      },
      -                      "type": "array"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Filters applied to the value: md5, base64, lower, upper, …."
      -                },
      -                "id": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Variable id, referenced from the texts."
      -                },
      -                "name": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Variable display name."
      -                },
      -                "only_with_value": {
      -                  "anyOf": [
      -                    {
      -                      "type": "boolean"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Render only answered questions."
      -                },
      -                "question": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Question slug the variable reads (single-question types)."
      -                },
      -                "questions": {
      -                  "anyOf": [
      -                    {
      -                      "additionalProperties": true,
      -                      "description": "Which questions a variable covers (``all``, or the listed slugs).",
      -                      "properties": {
      -                        "all": {
      -                          "anyOf": [
      -                            {
      -                              "type": "boolean"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "Cover every question of the form."
      -                        },
      -                        "items": {
      -                          "anyOf": [
      -                            {
      -                              "items": {
      -                                "type": "string"
      -                              },
      -                              "type": "array"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "Slugs of the covered questions."
      -                        }
      -                      },
      -                      "type": "object"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Questions the variable reads (multi-question types)."
      -                },
      -                "renderer": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "How the value renders: txt, formatted, yfm, json, …."
      -                },
      -                "secret": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Secret value (write only)."
      -                },
      -                "show_filenames": {
      -                  "anyOf": [
      -                    {
      -                      "type": "boolean"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Render file answers as file names."
      -                },
      -                "type": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Variable type, e.g. form.name or form.question_answer."
      -                },
      -                "version": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Variable format version (write only)."
      -                }
      -              },
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Variables referenced from the subscription's texts."
      -      }
      -    },
      -    "required": [
      -      "type"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": true,
      -    "description": "Comment on a Tracker issue.",
      -    "properties": {
      -      "active": {
      -        "anyOf": [
      -          {
      -            "type": "boolean"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Whether the integration runs."
      -      },
      -      "attachments": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": true,
      -            "description": "What a subscription attaches: answer files and fixed files.",
      -            "properties": {
      -              "question": {
      -                "anyOf": [
      -                  {
      -                    "additionalProperties": true,
      -                    "description": "File questions whose uploads a subscription attaches.",
      -                    "properties": {
      -                      "all": {
      -                        "anyOf": [
      -                          {
      -                            "type": "boolean"
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ],
      -                        "default": null,
      -                        "description": "Attach the files of every question."
      -                      },
      -                      "items": {
      -                        "anyOf": [
      -                          {
      -                            "items": {
      -                              "type": "string"
      -                            },
      -                            "type": "array"
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ],
      -                        "default": null,
      -                        "description": "Slugs of the file questions."
      -                      }
      -                    },
      -                    "type": "object"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "default": null,
      -                "description": "File questions whose uploads are attached."
      -              },
      -              "static": {
      -                "anyOf": [
      -                  {
      -                    "items": {
      -                      "additionalProperties": true,
      -                      "description": "A fixed file attached to every run (sent by ``path``; read back with ``id`` and links).",
      -                      "properties": {
      -                        "check_status": {
      -                          "anyOf": [
      -                            {
      -                              "type": "string"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "Scan status: check, ready, infected, error, deleted."
      -                        },
      -                        "id": {
      -                          "anyOf": [
      -                            {
      -                              "type": "integer"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "Attachment id (read only)."
      -                        },
      -                        "links": {
      -                          "anyOf": [
      -                            {
      -                              "additionalProperties": true,
      -                              "type": "object"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "Download links (read only)."
      -                        },
      -                        "name": {
      -                          "anyOf": [
      -                            {
      -                              "type": "string"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "File name (read only)."
      -                        },
      -                        "path": {
      -                          "anyOf": [
      -                            {
      -                              "type": "string"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "Uploaded file path (from `subscriptions attach`)."
      -                        }
      -                      },
      -                      "type": "object"
      -                    },
      -                    "type": "array"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "default": null,
      -                "description": "Fixed files attached to every run."
      -              }
      -            },
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Files to attach."
      -      },
      -      "body": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Comment text."
      -      },
      -      "fields": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "additionalProperties": true,
      -              "description": "One Tracker issue field a tracker subscription fills.",
      -              "properties": {
      -                "key": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "additionalProperties": true,
      -                      "description": "A Tracker issue field addressed by slug.",
      -                      "properties": {
      -                        "name": {
      -                          "anyOf": [
      -                            {
      -                              "type": "string"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "Field display name."
      -                        },
      -                        "slug": {
      -                          "anyOf": [
      -                            {
      -                              "type": "string"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "Tracker field key, e.g. tags."
      -                        },
      -                        "type": {
      -                          "anyOf": [
      -                            {
      -                              "type": "string"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "Field type (default string)."
      -                        }
      -                      },
      -                      "type": "object"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Field key: a slug, or an object with slug/name/type."
      -                },
      -                "only_with_value": {
      -                  "anyOf": [
      -                    {
      -                      "type": "boolean"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Set the field only when the value is not empty."
      -                },
      -                "value": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Field value; may embed variables."
      -                }
      -              },
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Issue fields to set."
      -      },
      -      "follow": {
      -        "anyOf": [
      -          {
      -            "type": "boolean"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Notify the form's followers about the run."
      -      },
      -      "id": {
      -        "anyOf": [
      -          {
      -            "type": "integer"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Subscription id (integer, read only)."
      -      },
      -      "issue": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Issue key to comment on."
      -      },
      -      "type": {
      -        "const": "tracker_comment",
      -        "default": "tracker_comment",
      -        "description": "Discriminator: tracker_comment.",
      -        "type": "string"
      -      },
      -      "variables": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "additionalProperties": true,
      -              "description": "A variable configured on a subscription and referenced from its texts by ``id``.",
      -              "properties": {
      -                "filters": {
      -                  "anyOf": [
      -                    {
      -                      "items": {
      -                        "type": "string"
      -                      },
      -                      "type": "array"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Filters applied to the value: md5, base64, lower, upper, …."
      -                },
      -                "id": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Variable id, referenced from the texts."
      -                },
      -                "name": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Variable display name."
      -                },
      -                "only_with_value": {
      -                  "anyOf": [
      -                    {
      -                      "type": "boolean"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Render only answered questions."
      -                },
      -                "question": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Question slug the variable reads (single-question types)."
      -                },
      -                "questions": {
      -                  "anyOf": [
      -                    {
      -                      "additionalProperties": true,
      -                      "description": "Which questions a variable covers (``all``, or the listed slugs).",
      -                      "properties": {
      -                        "all": {
      -                          "anyOf": [
      -                            {
      -                              "type": "boolean"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "Cover every question of the form."
      -                        },
      -                        "items": {
      -                          "anyOf": [
      -                            {
      -                              "items": {
      -                                "type": "string"
      -                              },
      -                              "type": "array"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "Slugs of the covered questions."
      -                        }
      -                      },
      -                      "type": "object"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Questions the variable reads (multi-question types)."
      -                },
      -                "renderer": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "How the value renders: txt, formatted, yfm, json, …."
      -                },
      -                "secret": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Secret value (write only)."
      -                },
      -                "show_filenames": {
      -                  "anyOf": [
      -                    {
      -                      "type": "boolean"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Render file answers as file names."
      -                },
      -                "type": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Variable type, e.g. form.name or form.question_answer."
      -                },
      -                "version": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Variable format version (write only)."
      -                }
      -              },
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Variables referenced from the subscription's texts."
      -      }
      -    },
      -    "required": [
      -      "type"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": true,
      -    "description": "Write to a Wiki page (text, or a row of a grid).",
      -    "properties": {
      -      "active": {
      -        "anyOf": [
      -          {
      -            "type": "boolean"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Whether the integration runs."
      -      },
      -      "body": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Text to write."
      -      },
      -      "follow": {
      -        "anyOf": [
      -          {
      -            "type": "boolean"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Notify the form's followers about the run."
      -      },
      -      "grid_data": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "additionalProperties": true,
      -              "description": "One Wiki grid cell a wiki subscription fills.",
      -              "properties": {
      -                "key": {
      -                  "anyOf": [
      -                    {
      -                      "additionalProperties": true,
      -                      "description": "A Wiki grid column addressed by slug and type.",
      -                      "properties": {
      -                        "slug": {
      -                          "anyOf": [
      -                            {
      -                              "type": "string"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "Column slug."
      -                        },
      -                        "type": {
      -                          "anyOf": [
      -                            {
      -                              "type": "string"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "Column type."
      -                        }
      -                      },
      -                      "type": "object"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "The grid column."
      -                },
      -                "value": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Cell value; may embed variables."
      -                }
      -              },
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "additionalProperties": true,
      -            "description": "A Wiki grid a wiki subscription appends rows to.",
      -            "properties": {
      -              "cols": {
      -                "anyOf": [
      -                  {
      -                    "items": {
      -                      "additionalProperties": true,
      -                      "description": "One Wiki grid cell a wiki subscription fills.",
      -                      "properties": {
      -                        "key": {
      -                          "anyOf": [
      -                            {
      -                              "additionalProperties": true,
      -                              "description": "A Wiki grid column addressed by slug and type.",
      -                              "properties": {
      -                                "slug": {
      -                                  "anyOf": [
      -                                    {
      -                                      "type": "string"
      -                                    },
      -                                    {
      -                                      "type": "null"
      -                                    }
      -                                  ],
      -                                  "default": null,
      -                                  "description": "Column slug."
      -                                },
      -                                "type": {
      -                                  "anyOf": [
      -                                    {
      -                                      "type": "string"
      -                                    },
      -                                    {
      -                                      "type": "null"
      -                                    }
      -                                  ],
      -                                  "default": null,
      -                                  "description": "Column type."
      -                                }
      -                              },
      -                              "type": "object"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "The grid column."
      -                        },
      -                        "value": {
      -                          "anyOf": [
      -                            {
      -                              "type": "string"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "Cell value; may embed variables."
      -                        }
      -                      },
      -                      "type": "object"
      -                    },
      -                    "type": "array"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "default": null,
      -                "description": "The cells of a new row."
      -              },
      -              "grid_id": {
      -                "anyOf": [
      -                  {
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "default": null,
      -                "description": "Grid id."
      -              },
      -              "title": {
      -                "anyOf": [
      -                  {
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ],
      -                "default": null,
      -                "description": "Grid title."
      -              }
      -            },
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Grid row to add: a list of cells, or a grid with its cells."
      -      },
      -      "id": {
      -        "anyOf": [
      -          {
      -            "type": "integer"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Subscription id (integer, read only)."
      -      },
      -      "insert_to_begin": {
      -        "anyOf": [
      -          {
      -            "type": "boolean"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Insert at the top of the page instead of the bottom."
      -      },
      -      "supertag": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Wiki page slug (max 255)."
      -      },
      -      "type": {
      -        "const": "wiki",
      -        "default": "wiki",
      -        "description": "Discriminator: wiki.",
      -        "type": "string"
      -      },
      -      "variables": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "additionalProperties": true,
      -              "description": "A variable configured on a subscription and referenced from its texts by ``id``.",
      -              "properties": {
      -                "filters": {
      -                  "anyOf": [
      -                    {
      -                      "items": {
      -                        "type": "string"
      -                      },
      -                      "type": "array"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Filters applied to the value: md5, base64, lower, upper, …."
      -                },
      -                "id": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Variable id, referenced from the texts."
      -                },
      -                "name": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Variable display name."
      -                },
      -                "only_with_value": {
      -                  "anyOf": [
      -                    {
      -                      "type": "boolean"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Render only answered questions."
      -                },
      -                "question": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Question slug the variable reads (single-question types)."
      -                },
      -                "questions": {
      -                  "anyOf": [
      -                    {
      -                      "additionalProperties": true,
      -                      "description": "Which questions a variable covers (``all``, or the listed slugs).",
      -                      "properties": {
      -                        "all": {
      -                          "anyOf": [
      -                            {
      -                              "type": "boolean"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "Cover every question of the form."
      -                        },
      -                        "items": {
      -                          "anyOf": [
      -                            {
      -                              "items": {
      -                                "type": "string"
      -                              },
      -                              "type": "array"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "Slugs of the covered questions."
      -                        }
      -                      },
      -                      "type": "object"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Questions the variable reads (multi-question types)."
      -                },
      -                "renderer": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "How the value renders: txt, formatted, yfm, json, …."
      -                },
      -                "secret": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Secret value (write only)."
      -                },
      -                "show_filenames": {
      -                  "anyOf": [
      -                    {
      -                      "type": "boolean"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Render file answers as file names."
      -                },
      -                "type": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Variable type, e.g. form.name or form.question_answer."
      -                },
      -                "version": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Variable format version (write only)."
      -                }
      -              },
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Variables referenced from the subscription's texts."
      -      }
      -    },
      -    "required": [
      -      "type"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": true,
      -    "description": "Call a JSON-RPC method.",
      -    "properties": {
      -      "active": {
      -        "anyOf": [
      -          {
      -            "type": "boolean"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Whether the integration runs."
      -      },
      -      "follow": {
      -        "anyOf": [
      -          {
      -            "type": "boolean"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Notify the form's followers about the run."
      -      },
      -      "headers": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "additionalProperties": true,
      -              "description": "A name/value pair: an e-mail or HTTP header, a JSON-RPC or function parameter.",
      -              "properties": {
      -                "name": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Header or parameter name (max 255)."
      -                },
      -                "only_with_value": {
      -                  "anyOf": [
      -                    {
      -                      "type": "boolean"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Send it only when the value is not empty."
      -                },
      -                "value": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Value; may embed variables such as {form.name} (max 500)."
      -                }
      -              },
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "HTTP headers."
      -      },
      -      "id": {
      -        "anyOf": [
      -          {
      -            "type": "integer"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Subscription id (integer, read only)."
      -      },
      -      "method": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "JSON-RPC method name (max 255)."
      -      },
      -      "params": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "additionalProperties": true,
      -              "description": "A name/value pair: an e-mail or HTTP header, a JSON-RPC or function parameter.",
      -              "properties": {
      -                "name": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Header or parameter name (max 255)."
      -                },
      -                "only_with_value": {
      -                  "anyOf": [
      -                    {
      -                      "type": "boolean"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Send it only when the value is not empty."
      -                },
      -                "value": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Value; may embed variables such as {form.name} (max 500)."
      -                }
      -              },
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Call parameters."
      -      },
      -      "type": {
      -        "const": "jsonrpc",
      -        "default": "jsonrpc",
      -        "description": "Discriminator: jsonrpc.",
      -        "type": "string"
      -      },
      -      "url": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Endpoint URL (max 255)."
      -      },
      -      "variables": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "additionalProperties": true,
      -              "description": "A variable configured on a subscription and referenced from its texts by ``id``.",
      -              "properties": {
      -                "filters": {
      -                  "anyOf": [
      -                    {
      -                      "items": {
      -                        "type": "string"
      -                      },
      -                      "type": "array"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Filters applied to the value: md5, base64, lower, upper, …."
      -                },
      -                "id": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Variable id, referenced from the texts."
      -                },
      -                "name": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Variable display name."
      -                },
      -                "only_with_value": {
      -                  "anyOf": [
      -                    {
      -                      "type": "boolean"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Render only answered questions."
      -                },
      -                "question": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Question slug the variable reads (single-question types)."
      -                },
      -                "questions": {
      -                  "anyOf": [
      -                    {
      -                      "additionalProperties": true,
      -                      "description": "Which questions a variable covers (``all``, or the listed slugs).",
      -                      "properties": {
      -                        "all": {
      -                          "anyOf": [
      -                            {
      -                              "type": "boolean"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "Cover every question of the form."
      -                        },
      -                        "items": {
      -                          "anyOf": [
      -                            {
      -                              "items": {
      -                                "type": "string"
      -                              },
      -                              "type": "array"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "Slugs of the covered questions."
      -                        }
      -                      },
      -                      "type": "object"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Questions the variable reads (multi-question types)."
      -                },
      -                "renderer": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "How the value renders: txt, formatted, yfm, json, …."
      -                },
      -                "secret": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Secret value (write only)."
      -                },
      -                "show_filenames": {
      -                  "anyOf": [
      -                    {
      -                      "type": "boolean"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Render file answers as file names."
      -                },
      -                "type": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Variable type, e.g. form.name or form.question_answer."
      -                },
      -                "version": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Variable format version (write only)."
      -                }
      -              },
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Variables referenced from the subscription's texts."
      -      }
      -    },
      -    "required": [
      -      "type"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": true,
      -    "description": "Send an HTTP request.",
      -    "properties": {
      -      "active": {
      -        "anyOf": [
      -          {
      -            "type": "boolean"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Whether the integration runs."
      -      },
      -      "body": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Request body; may embed variables."
      -      },
      -      "follow": {
      -        "anyOf": [
      -          {
      -            "type": "boolean"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Notify the form's followers about the run."
      -      },
      -      "headers": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "additionalProperties": true,
      -              "description": "A name/value pair: an e-mail or HTTP header, a JSON-RPC or function parameter.",
      -              "properties": {
      -                "name": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Header or parameter name (max 255)."
      -                },
      -                "only_with_value": {
      -                  "anyOf": [
      -                    {
      -                      "type": "boolean"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Send it only when the value is not empty."
      -                },
      -                "value": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Value; may embed variables such as {form.name} (max 500)."
      -                }
      -              },
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "HTTP headers."
      -      },
      -      "id": {
      -        "anyOf": [
      -          {
      -            "type": "integer"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Subscription id (integer, read only)."
      -      },
      -      "method": {
      -        "anyOf": [
      -          {
      -            "enum": [
      -              "get",
      -              "post",
      -              "patch",
      -              "put",
      -              "delete"
      -            ],
      -            "type": "string"
      -          },
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "HTTP method: get, post, patch, put or delete."
      -      },
      -      "type": {
      -        "const": "http",
      -        "default": "http",
      -        "description": "Discriminator: http.",
      -        "type": "string"
      -      },
      -      "url": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Request URL (max 255)."
      -      },
      -      "variables": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "additionalProperties": true,
      -              "description": "A variable configured on a subscription and referenced from its texts by ``id``.",
      -              "properties": {
      -                "filters": {
      -                  "anyOf": [
      -                    {
      -                      "items": {
      -                        "type": "string"
      -                      },
      -                      "type": "array"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Filters applied to the value: md5, base64, lower, upper, …."
      -                },
      -                "id": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Variable id, referenced from the texts."
      -                },
      -                "name": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Variable display name."
      -                },
      -                "only_with_value": {
      -                  "anyOf": [
      -                    {
      -                      "type": "boolean"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Render only answered questions."
      -                },
      -                "question": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Question slug the variable reads (single-question types)."
      -                },
      -                "questions": {
      -                  "anyOf": [
      -                    {
      -                      "additionalProperties": true,
      -                      "description": "Which questions a variable covers (``all``, or the listed slugs).",
      -                      "properties": {
      -                        "all": {
      -                          "anyOf": [
      -                            {
      -                              "type": "boolean"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "Cover every question of the form."
      -                        },
      -                        "items": {
      -                          "anyOf": [
      -                            {
      -                              "items": {
      -                                "type": "string"
      -                              },
      -                              "type": "array"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "Slugs of the covered questions."
      -                        }
      -                      },
      -                      "type": "object"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Questions the variable reads (multi-question types)."
      -                },
      -                "renderer": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "How the value renders: txt, formatted, yfm, json, …."
      -                },
      -                "secret": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Secret value (write only)."
      -                },
      -                "show_filenames": {
      -                  "anyOf": [
      -                    {
      -                      "type": "boolean"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Render file answers as file names."
      -                },
      -                "type": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Variable type, e.g. form.name or form.question_answer."
      -                },
      -                "version": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Variable format version (write only)."
      -                }
      -              },
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Variables referenced from the subscription's texts."
      -      }
      -    },
      -    "required": [
      -      "type"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": true,
      -    "description": "Call a Yandex Cloud function.",
      -    "properties": {
      -      "active": {
      -        "anyOf": [
      -          {
      -            "type": "boolean"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Whether the integration runs."
      -      },
      -      "follow": {
      -        "anyOf": [
      -          {
      -            "type": "boolean"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Notify the form's followers about the run."
      -      },
      -      "function_id": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Cloud function id (max 255)."
      -      },
      -      "id": {
      -        "anyOf": [
      -          {
      -            "type": "integer"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Subscription id (integer, read only)."
      -      },
      -      "params": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "additionalProperties": true,
      -              "description": "A name/value pair: an e-mail or HTTP header, a JSON-RPC or function parameter.",
      -              "properties": {
      -                "name": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Header or parameter name (max 255)."
      -                },
      -                "only_with_value": {
      -                  "anyOf": [
      -                    {
      -                      "type": "boolean"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Send it only when the value is not empty."
      -                },
      -                "value": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Value; may embed variables such as {form.name} (max 500)."
      -                }
      -              },
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Function parameters."
      -      },
      -      "type": {
      -        "const": "function",
      -        "default": "function",
      -        "description": "Discriminator: function.",
      -        "type": "string"
      -      },
      -      "variables": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "additionalProperties": true,
      -              "description": "A variable configured on a subscription and referenced from its texts by ``id``.",
      -              "properties": {
      -                "filters": {
      -                  "anyOf": [
      -                    {
      -                      "items": {
      -                        "type": "string"
      -                      },
      -                      "type": "array"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Filters applied to the value: md5, base64, lower, upper, …."
      -                },
      -                "id": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Variable id, referenced from the texts."
      -                },
      -                "name": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Variable display name."
      -                },
      -                "only_with_value": {
      -                  "anyOf": [
      -                    {
      -                      "type": "boolean"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Render only answered questions."
      -                },
      -                "question": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Question slug the variable reads (single-question types)."
      -                },
      -                "questions": {
      -                  "anyOf": [
      -                    {
      -                      "additionalProperties": true,
      -                      "description": "Which questions a variable covers (``all``, or the listed slugs).",
      -                      "properties": {
      -                        "all": {
      -                          "anyOf": [
      -                            {
      -                              "type": "boolean"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "Cover every question of the form."
      -                        },
      -                        "items": {
      -                          "anyOf": [
      -                            {
      -                              "items": {
      -                                "type": "string"
      -                              },
      -                              "type": "array"
      -                            },
      -                            {
      -                              "type": "null"
      -                            }
      -                          ],
      -                          "default": null,
      -                          "description": "Slugs of the covered questions."
      -                        }
      -                      },
      -                      "type": "object"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Questions the variable reads (multi-question types)."
      -                },
      -                "renderer": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "How the value renders: txt, formatted, yfm, json, …."
      -                },
      -                "secret": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Secret value (write only)."
      -                },
      -                "show_filenames": {
      -                  "anyOf": [
      -                    {
      -                      "type": "boolean"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Render file answers as file names."
      -                },
      -                "type": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Variable type, e.g. form.name or form.question_answer."
      -                },
      -                "version": {
      -                  "anyOf": [
      -                    {
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ],
      -                  "default": null,
      -                  "description": "Variable format version (write only)."
      -                }
      -              },
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null,
      -        "description": "Variables referenced from the subscription's texts."
      -      }
      -    },
      -    "required": [
      -      "type"
      -    ],
      -    "type": "object"
      -  }
      -]
    • addedInput schema / properties / body / type
      Added value: +"object"
    • addedInput schema / properties / body / x-ycli-schema
      Added value: +"ycli.yandex.forms.subscriptions.models:Subscription"
  2. First observedv0.67.0

TDQS

A3.8/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly=false, idempotent=false, destructive=false and openWorld=true, so the safety profile is covered. The description adds real value beyond them by disclosing execution behavior ('runs on every new answer while active is true') and the deferred-activation path. It does not state auth or permission requirements.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three compact sentences front-load the purpose, then the configuration tip, then the return value. Nothing is redundant, though the trailing return-value sentence adds only modest value given a create tool typically echoes the entity.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a mutation tool with no output schema, the description covers the side effect, the activation caveat, and the returned id, while the schema documents survey_id and hook_id and routes body to schema_get. Most of what an agent needs is present; only permissions/auth expectations are absent.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so baseline is 3, but the description goes further by explaining the effect of 'active' (whether the integration fires on new answers) and that the call returns an integer 'id'. The nested body's shape is explicitly deferred to schema_get, which is a sensible pointer.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource ('Add an integration to a hook') and ties it to execution semantics, so an agent knows this creates a subscription rather than reading or deleting one. It does not explicitly name the neighboring update/delete/list siblings, so it is clear but lacks sibling differentiation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives useful mode guidance ('Create it with active: false to configure it without sending anything yet'), which is genuinely actionable context. However it never addresses when to choose this tool over forms_subscriptions_update, delete, or list, leaving alternative routing to inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server

Other Tools