{
  "components": {
    "parameters": {
      "AssetIDParam": {
        "in": "path",
        "name": "asset_id",
        "required": true,
        "schema": {
          "$ref": "#/components/schemas/AssetID"
        }
      },
      "BoardIDParam": {
        "in": "path",
        "name": "board_id",
        "required": true,
        "schema": {
          "$ref": "#/components/schemas/BoardID"
        }
      },
      "ChangelogDraftIDParam": {
        "in": "path",
        "name": "changelog_draft_id",
        "required": true,
        "schema": {
          "$ref": "#/components/schemas/ChangelogDraftID"
        }
      },
      "ChangelogEntryIDParam": {
        "in": "path",
        "name": "changelog_entry_id",
        "required": true,
        "schema": {
          "$ref": "#/components/schemas/ChangelogEntryID"
        }
      },
      "CommentIDParam": {
        "in": "path",
        "name": "comment_id",
        "required": true,
        "schema": {
          "$ref": "#/components/schemas/CommentID"
        }
      },
      "CompanyIDParam": {
        "in": "path",
        "name": "company_id",
        "required": true,
        "schema": {
          "$ref": "#/components/schemas/CompanyID"
        }
      },
      "Cursor": {
        "description": "The previous page's `next_cursor`, to get the next page.",
        "in": "query",
        "name": "cursor",
        "schema": {
          "maxLength": 1024,
          "type": "string"
        }
      },
      "Deleted": {
        "description": "Return the items in the trash instead of the live ones.",
        "in": "query",
        "name": "deleted",
        "schema": {
          "default": false,
          "type": "boolean"
        }
      },
      "EndUserIDParam": {
        "in": "path",
        "name": "end_user_id",
        "required": true,
        "schema": {
          "$ref": "#/components/schemas/EndUserID"
        }
      },
      "Limit": {
        "description": "How many items to return in the page.",
        "in": "query",
        "name": "limit",
        "schema": {
          "default": 25,
          "format": "int32",
          "maximum": 100,
          "minimum": 1,
          "type": "integer"
        }
      },
      "MergeSuggestionIDParam": {
        "in": "path",
        "name": "merge_suggestion_id",
        "required": true,
        "schema": {
          "$ref": "#/components/schemas/MergeSuggestionID"
        }
      },
      "Pinned": {
        "description": "Only the pinned comment.",
        "in": "query",
        "name": "pinned",
        "schema": {
          "default": false,
          "type": "boolean"
        }
      },
      "PostIDParam": {
        "in": "path",
        "name": "post_id",
        "required": true,
        "schema": {
          "$ref": "#/components/schemas/PostID"
        }
      },
      "TagIDParam": {
        "in": "path",
        "name": "tag_id",
        "required": true,
        "schema": {
          "$ref": "#/components/schemas/TagID"
        }
      },
      "TraitIDParam": {
        "in": "path",
        "name": "trait_id",
        "required": true,
        "schema": {
          "$ref": "#/components/schemas/TraitID"
        }
      },
      "TranslationLanguage": {
        "description": "The reader's language. When the workspace translates what people write (`ai_translation`), each\npost or public comment written in another language then has its text in this language in\n`translation`, and its own fields keep the original. Without this parameter, `translation` is\nnull.\n",
        "in": "query",
        "name": "language",
        "schema": {
          "$ref": "#/components/schemas/Locale"
        }
      },
      "VoteIDParam": {
        "in": "path",
        "name": "vote_id",
        "required": true,
        "schema": {
          "$ref": "#/components/schemas/VoteID"
        }
      },
      "WorkspaceIDParam": {
        "in": "path",
        "name": "workspace_id",
        "required": true,
        "schema": {
          "$ref": "#/components/schemas/WorkspaceID"
        }
      }
    },
    "responses": {
      "Problem": {
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/Problem"
            }
          }
        },
        "description": "The request failed. The problem details say why."
      }
    },
    "schemas": {
      "AccountID": {
        "examples": [
          "acct_01h455vb4pex5vsknk084sn02q"
        ],
        "pattern": "^acct_[0-7][0-9a-hjkmnp-tv-z]{25}$",
        "type": "string"
      },
      "Activity": {
        "additionalProperties": false,
        "description": "One entry in a post's timeline, a `comment` or a `status_change`, as its `type` says.",
        "properties": {
          "comment": {
            "$ref": "#/components/schemas/Comment"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "status_change": {
            "$ref": "#/components/schemas/StatusChange"
          },
          "type": {
            "$ref": "#/components/schemas/ActivityType"
          }
        },
        "required": [
          "type",
          "created_at"
        ],
        "type": "object"
      },
      "ActivityList": {
        "additionalProperties": false,
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/Activity"
            },
            "type": "array"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "data",
          "next_cursor",
          "has_more"
        ],
        "type": "object"
      },
      "ActivityType": {
        "enum": [
          "comment",
          "status_change"
        ],
        "type": "string"
      },
      "Approval": {
        "description": "Whose posts (or comments) written in the portal wait for your team's approval: nobody's\n(`off`), guests' (`guests`) or everyone's (`everyone`). Whatever this says, a text with\nsensitive data or many links, or one that repeats its author's recent text, is held.\n",
        "enum": [
          "off",
          "guests",
          "everyone"
        ],
        "type": "string"
      },
      "Asset": {
        "additionalProperties": false,
        "properties": {
          "byte_size": {
            "format": "int32",
            "type": "integer"
          },
          "content_type": {
            "enum": [
              "image/png",
              "image/jpeg",
              "image/gif"
            ],
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "height": {
            "format": "int32",
            "type": "integer"
          },
          "id": {
            "$ref": "#/components/schemas/AssetID"
          },
          "url": {
            "description": "Where to fetch the image. When the image isn't public, the URL is signed and works for one to\ntwo hours: request the object again for a fresh URL.\n",
            "format": "uri",
            "type": "string"
          },
          "width": {
            "format": "int32",
            "type": "integer"
          }
        },
        "required": [
          "id",
          "content_type",
          "width",
          "height",
          "byte_size",
          "url",
          "created_at"
        ],
        "type": "object"
      },
      "AssetID": {
        "examples": [
          "asset_01h455vb4pex5vsknk084sn02q"
        ],
        "pattern": "^asset_[0-7][0-9a-hjkmnp-tv-z]{25}$",
        "type": "string"
      },
      "AssetIDs": {
        "description": "Uploaded images to attach, in order, from your own uploads that aren't attached to anything yet.",
        "items": {
          "$ref": "#/components/schemas/AssetID"
        },
        "maxItems": 4,
        "type": "array"
      },
      "Board": {
        "additionalProperties": false,
        "properties": {
          "color": {
            "description": "The board's color, a hex color such as `#3b82f6`, or null.",
            "pattern": "^#[0-9a-f]{6}$",
            "type": [
              "string",
              "null"
            ]
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "deleted_at": {
            "description": "Set while the board is in the trash.",
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "description_html": {
            "description": "`description_md`, rendered as sanitized HTML.",
            "type": "string"
          },
          "description_md": {
            "maxLength": 2000,
            "type": "string"
          },
          "id": {
            "$ref": "#/components/schemas/BoardID"
          },
          "name": {
            "maxLength": 80,
            "minLength": 1,
            "type": "string"
          },
          "position": {
            "description": "Boards are listed by position, then by id.",
            "format": "int32",
            "type": "integer"
          },
          "roadmap": {
            "description": "Whether the board's posts appear on the portal's roadmap.",
            "type": "boolean"
          },
          "slug": {
            "$ref": "#/components/schemas/BoardSlug"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          },
          "visibility": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Visibility"
              }
            ],
            "description": "`public` for everyone, or `private` for your team only: customers see neither the board nor its posts."
          }
        },
        "required": [
          "id",
          "name",
          "slug",
          "description_md",
          "description_html",
          "color",
          "visibility",
          "position",
          "roadmap",
          "created_at",
          "updated_at",
          "deleted_at"
        ],
        "type": "object"
      },
      "BoardCreate": {
        "additionalProperties": false,
        "properties": {
          "color": {
            "$ref": "#/components/schemas/Color"
          },
          "description_md": {
            "description": "The board's description, in Markdown, which the portal shows with the board's posts.",
            "maxLength": 2000,
            "type": "string"
          },
          "name": {
            "description": "The board's name.",
            "maxLength": 80,
            "minLength": 1,
            "type": "string"
          },
          "position": {
            "description": "Defaults to after the other boards.",
            "format": "int32",
            "maximum": 1000000,
            "minimum": 0,
            "type": "integer"
          },
          "roadmap": {
            "default": true,
            "description": "Whether the board's posts appear on the portal's roadmap.",
            "type": "boolean"
          },
          "slug": {
            "$ref": "#/components/schemas/BoardSlug"
          },
          "visibility": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Visibility"
              }
            ],
            "description": "`public` for everyone, or `private` for your team only: customers see neither the board nor its posts. Defaults to `public`."
          }
        },
        "required": [
          "name"
        ],
        "type": "object"
      },
      "BoardID": {
        "examples": [
          "board_01h455vb4pex5vsknk084sn02q"
        ],
        "pattern": "^board_[0-7][0-9a-hjkmnp-tv-z]{25}$",
        "type": "string"
      },
      "BoardList": {
        "additionalProperties": false,
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/Board"
            },
            "type": "array"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "data",
          "next_cursor",
          "has_more"
        ],
        "type": "object"
      },
      "BoardSlug": {
        "description": "Lowercase letters, digits and hyphens, unique among the workspace's live boards.",
        "maxLength": 60,
        "minLength": 1,
        "pattern": "^[a-z0-9]([a-z0-9-]*[a-z0-9])?$",
        "type": "string"
      },
      "BoardUpdate": {
        "additionalProperties": false,
        "properties": {
          "color": {
            "description": "A hex color, such as `#3b82f6`. Null removes the color.",
            "pattern": "^#[0-9a-fA-F]{6}$",
            "type": [
              "string",
              "null"
            ]
          },
          "description_md": {
            "description": "The board's description, in Markdown.",
            "maxLength": 2000,
            "type": "string"
          },
          "name": {
            "description": "The board's new name.",
            "maxLength": 80,
            "minLength": 1,
            "type": "string"
          },
          "position": {
            "description": "Boards are listed by position, then by id.",
            "format": "int32",
            "maximum": 1000000,
            "minimum": 0,
            "type": "integer"
          },
          "roadmap": {
            "description": "Whether the board's posts appear on the portal's roadmap.",
            "type": "boolean"
          },
          "slug": {
            "$ref": "#/components/schemas/BoardSlug"
          },
          "visibility": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Visibility"
              }
            ],
            "description": "`public` for everyone, or `private` for your team only: customers see neither the board nor its posts."
          }
        },
        "type": "object"
      },
      "ChangelogAuthor": {
        "additionalProperties": false,
        "description": "A team member who wrote the entry. They may have left the team since.",
        "properties": {
          "account_id": {
            "$ref": "#/components/schemas/AccountID"
          },
          "avatar_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "account_id",
          "name",
          "avatar_url"
        ],
        "type": "object"
      },
      "ChangelogDraft": {
        "additionalProperties": false,
        "properties": {
          "body_md": {
            "maxLength": 100000,
            "type": [
              "string",
              "null"
            ]
          },
          "completed_at": {
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "error": {
            "description": "Why the draft failed: `quota` (the plan's AI drafts are used up for the month), `budget` (the\nAI is paused until the next day), `refused` (the model declined), or another reason.\n",
            "type": [
              "string",
              "null"
            ]
          },
          "id": {
            "$ref": "#/components/schemas/ChangelogDraftID"
          },
          "notes": {
            "type": "string"
          },
          "post_ids": {
            "items": {
              "$ref": "#/components/schemas/PostID"
            },
            "type": "array"
          },
          "status": {
            "description": "`pending` while the model writes, then `ready` with the text, or `failed` with an `error`.",
            "enum": [
              "pending",
              "ready",
              "failed"
            ],
            "type": "string"
          },
          "summary": {
            "maxLength": 500,
            "type": [
              "string",
              "null"
            ]
          },
          "title": {
            "maxLength": 200,
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "id",
          "status",
          "post_ids",
          "notes",
          "title",
          "summary",
          "body_md",
          "error",
          "created_at",
          "completed_at"
        ],
        "type": "object"
      },
      "ChangelogDraftCreate": {
        "additionalProperties": false,
        "properties": {
          "notes": {
            "description": "What you want the entry to say, as instructions for the model.",
            "maxLength": 1000,
            "type": "string"
          },
          "post_ids": {
            "description": "The live posts the entry announces.",
            "items": {
              "$ref": "#/components/schemas/PostID"
            },
            "maxItems": 20,
            "minItems": 1,
            "type": "array"
          }
        },
        "required": [
          "post_ids"
        ],
        "type": "object"
      },
      "ChangelogDraftID": {
        "examples": [
          "draft_01h455vb4pex5vsknk084sn02q"
        ],
        "pattern": "^draft_[0-7][0-9a-hjkmnp-tv-z]{25}$",
        "type": "string"
      },
      "ChangelogEntry": {
        "additionalProperties": false,
        "properties": {
          "authors": {
            "description": "The team members named as the entry's authors (`author_ids`).",
            "items": {
              "$ref": "#/components/schemas/ChangelogAuthor"
            },
            "type": "array"
          },
          "body_html": {
            "description": "`body_md`, rendered as sanitized HTML.",
            "type": "string"
          },
          "body_md": {
            "maxLength": 100000,
            "type": "string"
          },
          "cover": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Asset"
              },
              {
                "type": "null"
              }
            ],
            "description": "The cover image."
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "deleted_at": {
            "description": "Set while the entry is in the trash.",
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "first_published_at": {
            "description": "When the entry was first published.",
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "id": {
            "$ref": "#/components/schemas/ChangelogEntryID"
          },
          "posts": {
            "description": "The linked posts, in their order, as they are now.",
            "items": {
              "$ref": "#/components/schemas/LinkedPost"
            },
            "type": "array"
          },
          "publish_at": {
            "description": "When a scheduled entry will be published.",
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "published_at": {
            "description": "When a published entry was last made public.",
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "slug": {
            "allOf": [
              {
                "$ref": "#/components/schemas/ChangelogSlug"
              }
            ],
            "description": "Made from the title until the entry is first published. After that, it changes only if the entry comes back from the trash after another entry took its slug."
          },
          "status": {
            "$ref": "#/components/schemas/ChangelogStatus"
          },
          "summary": {
            "description": "Plain text, for lists, feeds and emails.",
            "maxLength": 500,
            "type": "string"
          },
          "tags": {
            "description": "The entry's tags, sorted by name.",
            "items": {
              "$ref": "#/components/schemas/Tag"
            },
            "type": "array"
          },
          "title": {
            "maxLength": 200,
            "minLength": 1,
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          },
          "whisper": {
            "description": "Whether the entry is published quietly: it's never announced or marked unread.",
            "type": "boolean"
          }
        },
        "required": [
          "id",
          "title",
          "slug",
          "summary",
          "body_md",
          "body_html",
          "status",
          "publish_at",
          "published_at",
          "first_published_at",
          "whisper",
          "cover",
          "tags",
          "authors",
          "posts",
          "created_at",
          "updated_at",
          "deleted_at"
        ],
        "type": "object"
      },
      "ChangelogEntryCreate": {
        "additionalProperties": false,
        "properties": {
          "author_ids": {
            "description": "The authors, in order, as team members' account ids.",
            "items": {
              "$ref": "#/components/schemas/AccountID"
            },
            "maxItems": 10,
            "type": "array"
          },
          "body_md": {
            "description": "The entry's text, in Markdown.",
            "maxLength": 100000,
            "type": "string"
          },
          "cover_asset_id": {
            "allOf": [
              {
                "$ref": "#/components/schemas/AssetID"
              }
            ],
            "description": "An image to use as the cover, from your own uploads that aren't attached to anything yet."
          },
          "post_ids": {
            "description": "The posts the entry announces, in order.",
            "items": {
              "$ref": "#/components/schemas/PostID"
            },
            "maxItems": 20,
            "type": "array"
          },
          "summary": {
            "description": "Plain text, for lists, feeds and emails.",
            "maxLength": 500,
            "type": "string"
          },
          "tag_ids": {
            "description": "Tags with the `changelog` scope.",
            "items": {
              "$ref": "#/components/schemas/TagID"
            },
            "maxItems": 10,
            "type": "array"
          },
          "title": {
            "description": "The entry's title.",
            "maxLength": 200,
            "minLength": 1,
            "type": "string"
          },
          "whisper": {
            "default": false,
            "description": "Whether to publish the entry quietly: it's never announced or marked unread.",
            "type": "boolean"
          }
        },
        "required": [
          "title"
        ],
        "type": "object"
      },
      "ChangelogEntryID": {
        "examples": [
          "entry_01h455vb4pex5vsknk084sn02q"
        ],
        "pattern": "^entry_[0-7][0-9a-hjkmnp-tv-z]{25}$",
        "type": "string"
      },
      "ChangelogEntryList": {
        "additionalProperties": false,
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/ChangelogEntry"
            },
            "type": "array"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "data",
          "next_cursor",
          "has_more"
        ],
        "type": "object"
      },
      "ChangelogEntryUpdate": {
        "additionalProperties": false,
        "properties": {
          "author_ids": {
            "description": "The authors, in order, as team members' account ids. An author who has left the team can stay.",
            "items": {
              "$ref": "#/components/schemas/AccountID"
            },
            "maxItems": 10,
            "type": "array"
          },
          "body_md": {
            "description": "The entry's text, in Markdown.",
            "maxLength": 100000,
            "type": "string"
          },
          "cover_asset_id": {
            "description": "An uploaded image to use as the cover. Null removes the cover.",
            "pattern": "^asset_[0-7][0-9a-hjkmnp-tv-z]{25}$",
            "type": [
              "string",
              "null"
            ]
          },
          "post_ids": {
            "description": "The posts the entry announces, in order. A new post must be live and not merged; a post that's\nalready linked can stay, whatever happened to it since.\n",
            "items": {
              "$ref": "#/components/schemas/PostID"
            },
            "maxItems": 20,
            "type": "array"
          },
          "summary": {
            "description": "Plain text, for lists, feeds and emails.",
            "maxLength": 500,
            "type": "string"
          },
          "tag_ids": {
            "description": "The entry's tags, all with the `changelog` scope, in place of the current ones. An empty list\nremoves every tag.\n",
            "items": {
              "$ref": "#/components/schemas/TagID"
            },
            "maxItems": 10,
            "type": "array"
          },
          "title": {
            "description": "The entry's new title.",
            "maxLength": 200,
            "minLength": 1,
            "type": "string"
          },
          "whisper": {
            "description": "Whether the entry is published quietly: it's never announced or marked unread.",
            "type": "boolean"
          }
        },
        "type": "object"
      },
      "ChangelogPublication": {
        "additionalProperties": false,
        "properties": {
          "publish_at": {
            "description": "When to publish the entry. Without it, the entry is published now.",
            "format": "date-time",
            "type": "string"
          }
        },
        "type": "object"
      },
      "ChangelogSlug": {
        "maxLength": 90,
        "minLength": 1,
        "pattern": "^[a-z0-9]([a-z0-9-]*[a-z0-9])?$",
        "type": "string"
      },
      "ChangelogStatus": {
        "description": "`draft`, `scheduled` (to be published at `publish_at`) or `published`.",
        "enum": [
          "draft",
          "scheduled",
          "published"
        ],
        "type": "string"
      },
      "Color": {
        "description": "A hex color, such as `#3b82f6`, stored in lowercase.",
        "examples": [
          "#3b82f6"
        ],
        "pattern": "^#[0-9a-fA-F]{6}$",
        "type": "string"
      },
      "Comment": {
        "additionalProperties": false,
        "properties": {
          "attachments": {
            "items": {
              "$ref": "#/components/schemas/Asset"
            },
            "type": "array"
          },
          "author": {
            "allOf": [
              {
                "$ref": "#/components/schemas/PostAuthor"
              }
            ],
            "description": "Who wrote the comment."
          },
          "body_html": {
            "description": "`body_md`, rendered as sanitized HTML. A mention becomes `<span class=\"mention\">@Name</span>`,\nwritten for the reader: the person's name, else their email, or \"Someone\" if they were erased\nsince. A token that names nobody (one that isn't in `mentions`) shows as written.\n",
            "type": "string"
          },
          "body_md": {
            "description": "The comment's Markdown. A mention is the person's token, such as `<@user_…>` (see `mentions`).",
            "maxLength": 10000,
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "deleted_at": {
            "description": "Set while the comment is in the trash.",
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "edited_at": {
            "description": "When the comment's text was last edited.",
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "heart_count": {
            "description": "How many people liked the comment.",
            "format": "int32",
            "type": "integer"
          },
          "hearted": {
            "description": "Whether the signed-in member liked the comment. Always false with an API key.",
            "type": "boolean"
          },
          "id": {
            "$ref": "#/components/schemas/CommentID"
          },
          "language": {
            "description": "The language the comment is written in, as the AI detected it: an ISO 639-1 code, such as\n`ja`. Null until the workspace's translation has read the comment, when the AI can't name\nthe language, and always for an internal note, which is never sent to the AI.\n",
            "pattern": "^[a-z]{2}$",
            "type": [
              "string",
              "null"
            ]
          },
          "mentions": {
            "description": "The people the comment mentions. Your team can mention teammates in a note or a comment, and\nthe post's customers in a public comment. Each person mentioned is notified once, in the app\nand by email.\n",
            "items": {
              "$ref": "#/components/schemas/CommentMention"
            },
            "type": "array"
          },
          "moderation_flags": {
            "description": "Why the comment is held. Empty once your team has decided.",
            "items": {
              "$ref": "#/components/schemas/ModerationFlag"
            },
            "type": "array"
          },
          "moderation_state": {
            "$ref": "#/components/schemas/ModerationState"
          },
          "parent_id": {
            "description": "The top-level comment this one replies to.",
            "pattern": "^comment_[0-7][0-9a-hjkmnp-tv-z]{25}$",
            "type": [
              "string",
              "null"
            ]
          },
          "pinned_at": {
            "description": "When the comment was pinned on its post. Null when it isn't pinned.",
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "post_id": {
            "$ref": "#/components/schemas/PostID"
          },
          "source": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Source"
              }
            ],
            "description": "Where the comment came from: `dashboard` (your team, in the dashboard), `api` (an API key or\nthe MCP server), `portal` (someone on the portal or in the widget) or `import`. `github` and\n`linear` mark a comment someone wrote on a linked issue in that tracker.\n\nSuch a synced comment is an internal note, or a public comment where the connection's\nsettings publish it, as its `visibility` says. It follows its original: it changes and is\ndeleted with it. Nobody can edit it, delete it or reply to it here (409 `synced_comment`). A\npublic one is moderated like any comment.\n",
            "enum": [
              "dashboard",
              "api",
              "portal",
              "import",
              "github",
              "linear"
            ],
            "type": "string"
          },
          "translation": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CommentTranslation"
              },
              {
                "type": "null"
              }
            ],
            "description": "The comment in the language the request asked for with `language`. Null without that\nparameter, for a comment written in that language, for one the AI hasn't translated, and for\nan internal note.\n"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          },
          "visibility": {
            "$ref": "#/components/schemas/CommentVisibility"
          }
        },
        "required": [
          "id",
          "post_id",
          "parent_id",
          "author",
          "body_md",
          "body_html",
          "mentions",
          "visibility",
          "moderation_state",
          "moderation_flags",
          "source",
          "pinned_at",
          "heart_count",
          "hearted",
          "attachments",
          "edited_at",
          "language",
          "translation",
          "created_at",
          "updated_at",
          "deleted_at"
        ],
        "type": "object"
      },
      "CommentCreate": {
        "additionalProperties": false,
        "properties": {
          "asset_ids": {
            "$ref": "#/components/schemas/AssetIDs"
          },
          "author": {
            "allOf": [
              {
                "$ref": "#/components/schemas/EndUserRef"
              }
            ],
            "description": "Who writes the comment: an existing end user by `id`, or a customer by `external_id` or\n`email`, who's created if new. The author of a public comment follows the post.\n\nAn internal note's author is a team member's end user, by `id`. List end users finds it: its\n`kind` is `team`, and `q` finds it by the member's email. A teammate has an end user once\nthey've posted, commented, voted, followed a post or liked a comment, signed in to the portal,\nbeen mentioned, or been named as a changelog entry's author or in an import.\n"
          },
          "body_md": {
            "description": "The comment's Markdown. A team author mentions someone with their token: `<@user_…>` with an\nend user's id, or `<@mem_…>` with a member's id, which is stored as the member's end-user\ntoken. A note can mention members. A public comment can mention members and the post's\ncustomers: its author, commenters, voters and followers. A comment mentions at most 10\npeople. Mentioning anyone else fails validation with `mention_not_allowed` on `body_md`, and\nmentioning more people with `too_many_mentions`. In a customer's comment, tokens are plain\ntext and mention nobody.\n",
            "maxLength": 10000,
            "minLength": 1,
            "type": "string"
          },
          "parent_id": {
            "allOf": [
              {
                "$ref": "#/components/schemas/CommentID"
              }
            ],
            "description": "The top-level comment this one replies to."
          },
          "visibility": {
            "$ref": "#/components/schemas/CommentVisibility"
          }
        },
        "required": [
          "body_md",
          "author"
        ],
        "type": "object"
      },
      "CommentID": {
        "examples": [
          "comment_01h455vb4pex5vsknk084sn02q"
        ],
        "pattern": "^comment_[0-7][0-9a-hjkmnp-tv-z]{25}$",
        "type": "string"
      },
      "CommentList": {
        "additionalProperties": false,
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/Comment"
            },
            "type": "array"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "data",
          "next_cursor",
          "has_more"
        ],
        "type": "object"
      },
      "CommentMention": {
        "additionalProperties": false,
        "description": "Someone the comment mentions, as they are now. Only the id remains once they're erased.",
        "properties": {
          "email": {
            "format": "email",
            "type": [
              "string",
              "null"
            ]
          },
          "id": {
            "$ref": "#/components/schemas/EndUserID"
          },
          "kind": {
            "description": "`team` for a teammate, `user` for a customer.",
            "enum": [
              "team",
              "user"
            ],
            "type": "string"
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "id",
          "kind",
          "name",
          "email"
        ],
        "type": "object"
      },
      "CommentTranslation": {
        "additionalProperties": false,
        "description": "A public comment's text in the language the request asked for, as the AI translated it. Show it\nbeside the original, never in its place: say that it's an automatic translation, and keep the\noriginal one click away. Editing the comment removes the translation until the AI has read the\nnew text.\n",
        "properties": {
          "body_html": {
            "description": "The translated text, rendered as sanitized HTML like the original.",
            "type": "string"
          },
          "language": {
            "$ref": "#/components/schemas/Locale"
          }
        },
        "required": [
          "language",
          "body_html"
        ],
        "type": "object"
      },
      "CommentUpdate": {
        "additionalProperties": false,
        "properties": {
          "asset_ids": {
            "allOf": [
              {
                "$ref": "#/components/schemas/AssetIDs"
              }
            ],
            "description": "The images to attach, in order, in place of the current ones. Images already attached can\nstay; any others must be your own uploads that aren't attached to anything yet.\n"
          },
          "body_md": {
            "description": "The comment's Markdown, with mentions written as when you create a comment. People the new\ntext adds are notified, and people it drops are no longer mentioned. Someone who's already\nmentioned can stay, even if they couldn't be mentioned now.\n",
            "maxLength": 10000,
            "minLength": 1,
            "type": "string"
          }
        },
        "type": "object"
      },
      "CommentVisibility": {
        "description": "`public`, or `internal` for a note for your team, which the portal never shows.",
        "enum": [
          "public",
          "internal"
        ],
        "type": "string"
      },
      "Company": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "domain": {
            "maxLength": 253,
            "type": [
              "string",
              "null"
            ]
          },
          "external_id": {
            "description": "The company's id in your system.",
            "maxLength": 255,
            "type": "string"
          },
          "id": {
            "$ref": "#/components/schemas/CompanyID"
          },
          "member_count": {
            "description": "How many end users belong to the company.",
            "format": "int32",
            "type": "integer"
          },
          "name": {
            "maxLength": 200,
            "type": [
              "string",
              "null"
            ]
          },
          "traits": {
            "$ref": "#/components/schemas/Traits"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          },
          "value": {
            "description": "What the company is worth to you, such as its monthly revenue in cents.",
            "format": "int64",
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "id",
          "external_id",
          "name",
          "domain",
          "value",
          "traits",
          "member_count",
          "created_at",
          "updated_at"
        ],
        "type": "object"
      },
      "CompanyID": {
        "examples": [
          "company_01h455vb4pex5vsknk084sn02q"
        ],
        "pattern": "^company_[0-7][0-9a-hjkmnp-tv-z]{25}$",
        "type": "string"
      },
      "CompanyList": {
        "additionalProperties": false,
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/Company"
            },
            "type": "array"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "data",
          "next_cursor",
          "has_more"
        ],
        "type": "object"
      },
      "CompanySummary": {
        "additionalProperties": false,
        "properties": {
          "external_id": {
            "maxLength": 255,
            "type": "string"
          },
          "id": {
            "$ref": "#/components/schemas/CompanyID"
          },
          "name": {
            "maxLength": 200,
            "type": [
              "string",
              "null"
            ]
          },
          "value": {
            "format": "int64",
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "id",
          "external_id",
          "name",
          "value"
        ],
        "type": "object"
      },
      "CompanyUpsert": {
        "additionalProperties": false,
        "description": "A company, found by its `external_id`. Fields you don't send stay as they are.",
        "properties": {
          "domain": {
            "description": "The company's domain, such as `acme.com`, stored in lowercase.",
            "maxLength": 253,
            "minLength": 1,
            "type": "string"
          },
          "external_id": {
            "description": "The company's id in your system, which finds it.",
            "maxLength": 255,
            "minLength": 1,
            "type": "string"
          },
          "name": {
            "description": "The company's name.",
            "maxLength": 200,
            "minLength": 1,
            "type": "string"
          },
          "traits": {
            "$ref": "#/components/schemas/TraitChanges"
          },
          "value": {
            "description": "What the company is worth to you, such as its monthly revenue in cents. A post's\n`customer_value` adds up the values of its voters' companies.\n",
            "format": "int64",
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "external_id"
        ],
        "type": "object"
      },
      "DigestSetting": {
        "description": "Whether the workspace's end users get the weekly digest, on Monday mornings in the workspace's\ntime zone: the week's top new posts, shipped posts and changelog entries.\n",
        "enum": [
          "on",
          "off"
        ],
        "type": "string"
      },
      "EndUser": {
        "additionalProperties": false,
        "properties": {
          "avatar_url": {
            "maxLength": 2048,
            "type": [
              "string",
              "null"
            ]
          },
          "banned_at": {
            "description": "Set while the end user is banned.",
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "companies": {
            "description": "The companies the end user belongs to, the most valuable first.",
            "items": {
              "$ref": "#/components/schemas/CompanySummary"
            },
            "maxItems": 20,
            "type": "array"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "email": {
            "format": "email",
            "type": [
              "string",
              "null"
            ]
          },
          "email_verified_at": {
            "description": "When the end user proved they own the email by signing in with it. Null for an email set through the API.",
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "erased_at": {
            "description": "Set once the end user's personal data has been erased.",
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "external_id": {
            "description": "The customer's id in your system.",
            "maxLength": 255,
            "type": [
              "string",
              "null"
            ]
          },
          "id": {
            "$ref": "#/components/schemas/EndUserID"
          },
          "kind": {
            "$ref": "#/components/schemas/EndUserKind"
          },
          "name": {
            "maxLength": 100,
            "type": [
              "string",
              "null"
            ]
          },
          "traits": {
            "$ref": "#/components/schemas/Traits"
          },
          "unsigned": {
            "description": "Whether this is a guest your app named without a signed token. Its `external_id` and `email`\nare whatever anyone who signed in as it claimed: never trust them as a customer's.\n",
            "type": "boolean"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "id",
          "kind",
          "unsigned",
          "external_id",
          "email",
          "email_verified_at",
          "name",
          "avatar_url",
          "traits",
          "companies",
          "banned_at",
          "erased_at",
          "created_at",
          "updated_at"
        ],
        "type": "object"
      },
      "EndUserExport": {
        "additionalProperties": false,
        "description": "Everything Swingback keeps about an end user, for a data subject access request.",
        "properties": {
          "comments": {
            "items": {
              "$ref": "#/components/schemas/EndUserExportComment"
            },
            "type": "array"
          },
          "companies": {
            "items": {
              "$ref": "#/components/schemas/EndUserExportCompany"
            },
            "type": "array"
          },
          "email_preferences": {
            "description": "Their email choices, by category.",
            "items": {
              "$ref": "#/components/schemas/EndUserExportEmailPreference"
            },
            "type": "array"
          },
          "exported_at": {
            "format": "date-time",
            "type": "string"
          },
          "hearts": {
            "description": "The comments they liked.",
            "items": {
              "$ref": "#/components/schemas/EndUserExportHeart"
            },
            "type": "array"
          },
          "identities": {
            "description": "The Google or GitHub accounts they sign in with.",
            "items": {
              "$ref": "#/components/schemas/EndUserExportIdentity"
            },
            "type": "array"
          },
          "notifications": {
            "items": {
              "$ref": "#/components/schemas/EndUserExportNotification"
            },
            "type": "array"
          },
          "posts": {
            "items": {
              "$ref": "#/components/schemas/EndUserExportPost"
            },
            "type": "array"
          },
          "profile": {
            "$ref": "#/components/schemas/EndUserExportProfile"
          },
          "sessions": {
            "description": "Their portal and widget sessions.",
            "items": {
              "$ref": "#/components/schemas/EndUserExportSession"
            },
            "type": "array"
          },
          "subscriptions": {
            "description": "The posts they follow, or unfollowed.",
            "items": {
              "$ref": "#/components/schemas/EndUserExportSubscription"
            },
            "type": "array"
          },
          "votes": {
            "items": {
              "$ref": "#/components/schemas/EndUserExportVote"
            },
            "type": "array"
          }
        },
        "required": [
          "exported_at",
          "profile",
          "companies",
          "posts",
          "comments",
          "votes",
          "hearts",
          "subscriptions",
          "notifications",
          "email_preferences",
          "sessions",
          "identities"
        ],
        "type": "object"
      },
      "EndUserExportComment": {
        "additionalProperties": false,
        "properties": {
          "body_md": {
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "deleted_at": {
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "id": {
            "$ref": "#/components/schemas/CommentID"
          },
          "moderation_state": {
            "$ref": "#/components/schemas/ModerationState"
          },
          "parent_id": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CommentID"
              },
              {
                "type": "null"
              }
            ]
          },
          "post_id": {
            "$ref": "#/components/schemas/PostID"
          },
          "visibility": {
            "$ref": "#/components/schemas/CommentVisibility"
          }
        },
        "required": [
          "id",
          "post_id",
          "parent_id",
          "body_md",
          "visibility",
          "moderation_state",
          "created_at",
          "deleted_at"
        ],
        "type": "object"
      },
      "EndUserExportCompany": {
        "additionalProperties": false,
        "properties": {
          "external_id": {
            "maxLength": 255,
            "type": "string"
          },
          "id": {
            "$ref": "#/components/schemas/CompanyID"
          },
          "joined_at": {
            "format": "date-time",
            "type": "string"
          },
          "name": {
            "maxLength": 200,
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "id",
          "external_id",
          "name",
          "joined_at"
        ],
        "type": "object"
      },
      "EndUserExportEmailPreference": {
        "additionalProperties": false,
        "properties": {
          "category": {
            "$ref": "#/components/schemas/NotificationCategory"
          },
          "email": {
            "type": "boolean"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "category",
          "email",
          "updated_at"
        ],
        "type": "object"
      },
      "EndUserExportHeart": {
        "additionalProperties": false,
        "properties": {
          "comment_id": {
            "$ref": "#/components/schemas/CommentID"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "comment_id",
          "created_at"
        ],
        "type": "object"
      },
      "EndUserExportIdentity": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "email": {
            "maxLength": 254,
            "type": [
              "string",
              "null"
            ]
          },
          "last_used_at": {
            "format": "date-time",
            "type": "string"
          },
          "provider": {
            "enum": [
              "google",
              "github"
            ],
            "type": "string"
          }
        },
        "required": [
          "provider",
          "email",
          "created_at",
          "last_used_at"
        ],
        "type": "object"
      },
      "EndUserExportNotification": {
        "additionalProperties": false,
        "properties": {
          "changelog_entry_id": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ChangelogEntryID"
              },
              {
                "type": "null"
              }
            ]
          },
          "comment_id": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CommentID"
              },
              {
                "type": "null"
              }
            ]
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "kind": {
            "$ref": "#/components/schemas/NotificationKind"
          },
          "post_id": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PostID"
              },
              {
                "type": "null"
              }
            ]
          },
          "read_at": {
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "kind",
          "post_id",
          "comment_id",
          "changelog_entry_id",
          "created_at",
          "read_at"
        ],
        "type": "object"
      },
      "EndUserExportPost": {
        "additionalProperties": false,
        "properties": {
          "board": {
            "description": "The board's name.",
            "type": "string"
          },
          "body_md": {
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "deleted_at": {
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "id": {
            "$ref": "#/components/schemas/PostID"
          },
          "moderation_state": {
            "$ref": "#/components/schemas/ModerationState"
          },
          "number": {
            "format": "int64",
            "type": "integer"
          },
          "status": {
            "$ref": "#/components/schemas/PostStatus"
          },
          "title": {
            "type": "string"
          },
          "visibility": {
            "description": "`public`, or `private`: only your team and the post's author see it.",
            "enum": [
              "public",
              "private"
            ],
            "type": "string"
          }
        },
        "required": [
          "id",
          "number",
          "title",
          "body_md",
          "status",
          "visibility",
          "moderation_state",
          "board",
          "created_at",
          "deleted_at"
        ],
        "type": "object"
      },
      "EndUserExportProfile": {
        "additionalProperties": false,
        "properties": {
          "avatar_url": {
            "maxLength": 2048,
            "type": [
              "string",
              "null"
            ]
          },
          "banned_at": {
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "email": {
            "maxLength": 254,
            "type": [
              "string",
              "null"
            ]
          },
          "email_verified_at": {
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "erased_at": {
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "external_id": {
            "maxLength": 255,
            "type": [
              "string",
              "null"
            ]
          },
          "id": {
            "$ref": "#/components/schemas/EndUserID"
          },
          "kind": {
            "$ref": "#/components/schemas/EndUserKind"
          },
          "locale": {
            "description": "The language of their emails, one of `en`, `fr`, `de`, `es`, `it`, `pt` and `nl`: the portal's language at their last sign-in,\nor the one they chose there. Null if neither is known.\n",
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "maxLength": 100,
            "type": [
              "string",
              "null"
            ]
          },
          "read_translations": {
            "$ref": "#/components/schemas/ReadTranslations"
          },
          "traits": {
            "$ref": "#/components/schemas/Traits"
          },
          "unsigned": {
            "description": "Whether this is a guest your app named without a signed token (see the end user's `unsigned`).",
            "type": "boolean"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "id",
          "kind",
          "unsigned",
          "external_id",
          "email",
          "email_verified_at",
          "name",
          "avatar_url",
          "locale",
          "read_translations",
          "traits",
          "banned_at",
          "erased_at",
          "created_at",
          "updated_at"
        ],
        "type": "object"
      },
      "EndUserExportSession": {
        "additionalProperties": false,
        "properties": {
          "audience": {
            "description": "Where the session works: `portal` or `widget`.",
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "expires_at": {
            "format": "date-time",
            "type": "string"
          },
          "ip": {
            "maxLength": 64,
            "type": [
              "string",
              "null"
            ]
          },
          "last_seen_at": {
            "format": "date-time",
            "type": "string"
          },
          "revoked_at": {
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "user_agent": {
            "maxLength": 512,
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "audience",
          "user_agent",
          "ip",
          "created_at",
          "last_seen_at",
          "expires_at",
          "revoked_at"
        ],
        "type": "object"
      },
      "EndUserExportSubscription": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "post_id": {
            "$ref": "#/components/schemas/PostID"
          },
          "reason": {
            "enum": [
              "author",
              "voter",
              "commenter",
              "manual"
            ],
            "type": "string"
          },
          "unsubscribed_at": {
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "post_id",
          "reason",
          "created_at",
          "unsubscribed_at"
        ],
        "type": "object"
      },
      "EndUserExportVote": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "post_id": {
            "$ref": "#/components/schemas/PostID"
          },
          "post_title": {
            "type": "string"
          },
          "source": {
            "description": "Where the vote came from: `dashboard`, `api`, `portal` or `import`, as on the vote object.",
            "type": "string"
          }
        },
        "required": [
          "post_id",
          "post_title",
          "source",
          "created_at"
        ],
        "type": "object"
      },
      "EndUserID": {
        "examples": [
          "user_01h455vb4pex5vsknk084sn02q"
        ],
        "pattern": "^user_[0-7][0-9a-hjkmnp-tv-z]{25}$",
        "type": "string"
      },
      "EndUserKind": {
        "description": "`user` for a customer, `team` for the team's own rows (a team member acting as themselves, an\nissue tracker's connection, or an imported team author), and `guest` for someone who wrote in\nthe portal without signing in.\n",
        "enum": [
          "user",
          "team",
          "guest"
        ],
        "type": "string"
      },
      "EndUserList": {
        "additionalProperties": false,
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/EndUser"
            },
            "type": "array"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "data",
          "next_cursor",
          "has_more"
        ],
        "type": "object"
      },
      "EndUserRef": {
        "additionalProperties": false,
        "description": "Names an end user: an existing one by `id` alone, or a customer by `external_id`, else by\n`email`, who is created if new. `name` and `avatar_url` set the customer's name and avatar.\n",
        "properties": {
          "avatar_url": {
            "description": "The address of the customer's avatar, `http` or `https`, which replaces the one Swingback has.",
            "format": "uri",
            "maxLength": 2048,
            "type": "string"
          },
          "email": {
            "description": "The customer's email. Without a match on `external_id`, Swingback looks for the customer by email.",
            "format": "email",
            "maxLength": 254,
            "type": "string"
          },
          "external_id": {
            "description": "The customer's id in your system. Swingback looks for the customer by it first.",
            "maxLength": 255,
            "minLength": 1,
            "type": "string"
          },
          "id": {
            "allOf": [
              {
                "$ref": "#/components/schemas/EndUserID"
              }
            ],
            "description": "An existing end user's id. Send it alone, without the other fields."
          },
          "name": {
            "description": "The customer's name, which replaces the one Swingback has.",
            "maxLength": 100,
            "minLength": 1,
            "type": "string"
          }
        },
        "type": "object"
      },
      "EndUserUpsert": {
        "additionalProperties": false,
        "description": "A customer, found by `external_id`, else by `email`. One of the two is required.",
        "properties": {
          "avatar_url": {
            "description": "The address of the customer's avatar, `http` or `https`, which replaces the one Swingback has.",
            "format": "uri",
            "maxLength": 2048,
            "type": "string"
          },
          "companies": {
            "description": "All of the customer's companies, each created or updated by its `external_id`. The customer\nleaves any company that isn't in the list. Omit the field to keep their current companies.\n",
            "items": {
              "$ref": "#/components/schemas/CompanyUpsert"
            },
            "maxItems": 20,
            "type": "array"
          },
          "email": {
            "description": "The customer's email. Without a match on `external_id`, Swingback looks for the customer by email.",
            "format": "email",
            "maxLength": 254,
            "type": "string"
          },
          "external_id": {
            "description": "The customer's id in your system. Swingback looks for the customer by it first.",
            "maxLength": 255,
            "minLength": 1,
            "type": "string"
          },
          "name": {
            "description": "The customer's name, which replaces the one Swingback has.",
            "maxLength": 100,
            "minLength": 1,
            "type": "string"
          },
          "traits": {
            "$ref": "#/components/schemas/TraitChanges"
          }
        },
        "type": "object"
      },
      "FieldError": {
        "properties": {
          "code": {
            "description": "What's wrong, such as `required`, `too_long` or `invalid_format`.",
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "parameter": {
            "description": "The name of the invalid query, path or header parameter.",
            "type": "string"
          },
          "pointer": {
            "description": "A JSON Pointer (RFC 6901) to the invalid field in the request body, such as `/title`.",
            "type": "string"
          }
        },
        "required": [
          "code",
          "message"
        ],
        "type": "object"
      },
      "IntegrationID": {
        "examples": [
          "integration_01h455vb4pex5vsknk084sn02q"
        ],
        "pattern": "^integration_[0-7][0-9a-hjkmnp-tv-z]{25}$",
        "type": "string"
      },
      "IssueDestination": {
        "additionalProperties": false,
        "properties": {
          "archived": {
            "description": "Whether it's an archived repository, or an archived or retired team. It then takes no issues.",
            "type": "boolean"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "description": {
            "description": "What it holds, for people and for routing.",
            "maxLength": 500,
            "type": "string"
          },
          "enabled": {
            "description": "Whether it takes issues.",
            "type": "boolean"
          },
          "gone": {
            "description": "Whether its connection has lost access to it.",
            "type": "boolean"
          },
          "id": {
            "$ref": "#/components/schemas/IssueDestinationID"
          },
          "integration_id": {
            "$ref": "#/components/schemas/IntegrationID"
          },
          "kind": {
            "enum": [
              "github_repository",
              "linear_team"
            ],
            "type": "string"
          },
          "name": {
            "description": "A repository's full name, such as `acme/web`, or a team's name.",
            "type": "string"
          },
          "public": {
            "description": "Whether anyone can read it, as in a public repository. A Linear team is never public.",
            "type": "boolean"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          },
          "url": {
            "description": "The destination's page on its tracker.",
            "type": "string"
          }
        },
        "required": [
          "id",
          "integration_id",
          "kind",
          "name",
          "url",
          "public",
          "archived",
          "gone",
          "description",
          "enabled",
          "created_at",
          "updated_at"
        ],
        "type": "object"
      },
      "IssueDestinationID": {
        "examples": [
          "destination_01h455vb4pex5vsknk084sn02q"
        ],
        "pattern": "^destination_[0-7][0-9a-hjkmnp-tv-z]{25}$",
        "type": "string"
      },
      "IssueLink": {
        "additionalProperties": false,
        "properties": {
          "body_md": {
            "description": "The requested text, until the issue exists.",
            "type": "string"
          },
          "copies_comments": {
            "description": "Whether a comment that anyone can see, written on the post now, would be copied to the issue.\nThat's when the connection sends comments there, and the post is public if the destination\nis.\n",
            "type": "boolean"
          },
          "copies_notes": {
            "description": "Whether an internal note written on the post now would be copied to the issue.",
            "type": "boolean"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "destination": {
            "$ref": "#/components/schemas/IssueDestination"
          },
          "error_code": {
            "description": "Why the issue couldn't be created: `issues_disabled`, `forbidden`, `repository_not_found`,\n`team_not_found`, `rejected`, `destination_unavailable`, `connection_stopped`, or\n`public_destination` (the post stopped being public before its issue was created in a public\ndestination, and no member confirmed it could go there).\n",
            "type": [
              "string",
              "null"
            ]
          },
          "id": {
            "$ref": "#/components/schemas/IssueLinkID"
          },
          "issue": {
            "description": "Null until the issue exists.",
            "oneOf": [
              {
                "$ref": "#/components/schemas/TrackerIssue"
              },
              {
                "type": "null"
              }
            ]
          },
          "labels": {
            "description": "The requested labels.",
            "items": {
              "type": "string"
            },
            "maxItems": 10,
            "type": "array"
          },
          "origin": {
            "description": "`created` from the post by a member, `linked` to an existing issue, or created by the routing\nrules (`rule`) when the post reached a status.\n",
            "enum": [
              "created",
              "linked",
              "rule"
            ],
            "type": "string"
          },
          "post_id": {
            "allOf": [
              {
                "$ref": "#/components/schemas/PostID"
              }
            ],
            "description": "The post the link was made on: this one, or one merged into it."
          },
          "public_confirmed": {
            "description": "Whether a member confirmed that the post can go to a public destination.",
            "type": "boolean"
          },
          "state": {
            "description": "`creating` until the requested issue exists, then `linked`, or `failed` if it couldn't be created.",
            "enum": [
              "creating",
              "linked",
              "failed"
            ],
            "type": "string"
          },
          "title": {
            "description": "The requested title, then the issue's own once it exists.",
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "id",
          "post_id",
          "state",
          "origin",
          "destination",
          "issue",
          "title",
          "body_md",
          "labels",
          "error_code",
          "public_confirmed",
          "copies_comments",
          "copies_notes",
          "created_at",
          "updated_at"
        ],
        "type": "object"
      },
      "IssueLinkID": {
        "examples": [
          "link_01h455vb4pex5vsknk084sn02q"
        ],
        "pattern": "^link_[0-7][0-9a-hjkmnp-tv-z]{25}$",
        "type": "string"
      },
      "IssueLinkList": {
        "additionalProperties": false,
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/IssueLink"
            },
            "maxItems": 1000,
            "type": "array"
          }
        },
        "required": [
          "data"
        ],
        "type": "object"
      },
      "LinkedPost": {
        "additionalProperties": false,
        "properties": {
          "deleted_at": {
            "description": "Set while the post is in the trash.",
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "id": {
            "$ref": "#/components/schemas/PostID"
          },
          "merged_into_id": {
            "description": "The post this one was merged into, which the portal shows instead.",
            "pattern": "^post_[0-7][0-9a-hjkmnp-tv-z]{25}$",
            "type": [
              "string",
              "null"
            ]
          },
          "number": {
            "format": "int64",
            "type": "integer"
          },
          "slug": {
            "$ref": "#/components/schemas/PostSlug"
          },
          "status": {
            "$ref": "#/components/schemas/PostStatus"
          },
          "title": {
            "type": "string"
          },
          "visibility": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Visibility"
              }
            ],
            "description": "`public`, or `private`: only your team and the post's author see it."
          },
          "vote_count": {
            "format": "int32",
            "type": "integer"
          }
        },
        "required": [
          "id",
          "number",
          "title",
          "slug",
          "status",
          "visibility",
          "vote_count",
          "merged_into_id",
          "deleted_at"
        ],
        "type": "object"
      },
      "Locale": {
        "description": "One of the seven languages the portal and Swingback's emails come in.",
        "enum": [
          "en",
          "fr",
          "de",
          "es",
          "it",
          "pt",
          "nl"
        ],
        "type": "string"
      },
      "Member": {
        "additionalProperties": false,
        "properties": {
          "account": {
            "$ref": "#/components/schemas/MemberAccount"
          },
          "created_at": {
            "description": "When the member joined the workspace.",
            "format": "date-time",
            "type": "string"
          },
          "id": {
            "$ref": "#/components/schemas/MemberID"
          },
          "role": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Role"
              }
            ],
            "description": "`owner` or `admin`. Only owners manage owners and roles, the slug, the custom domain, billing and exports, and delete the workspace."
          }
        },
        "required": [
          "id",
          "role",
          "created_at",
          "account"
        ],
        "type": "object"
      },
      "MemberAccount": {
        "additionalProperties": false,
        "description": "A team member's account. Its `id` is what a changelog entry's `author_ids` take.",
        "properties": {
          "avatar_url": {
            "maxLength": 2048,
            "type": [
              "string",
              "null"
            ]
          },
          "email": {
            "format": "email",
            "type": "string"
          },
          "id": {
            "$ref": "#/components/schemas/AccountID"
          },
          "name": {
            "maxLength": 100,
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "id",
          "email",
          "name",
          "avatar_url"
        ],
        "type": "object"
      },
      "MemberID": {
        "examples": [
          "mem_01h455vb4pex5vsknk084sn02q"
        ],
        "pattern": "^mem_[0-7][0-9a-hjkmnp-tv-z]{25}$",
        "type": "string"
      },
      "MemberList": {
        "additionalProperties": false,
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/Member"
            },
            "type": "array"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "data",
          "next_cursor",
          "has_more"
        ],
        "type": "object"
      },
      "MergeSuggestion": {
        "additionalProperties": false,
        "description": "Two posts that the model took for duplicates. `post` is the newer one, and accepting the suggestion merges it into `similar_post`.",
        "properties": {
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "decided_at": {
            "description": "When the suggestion was accepted or dismissed.",
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "distance": {
            "description": "How far apart the posts' meanings are, as a cosine distance: 0 means identical.",
            "type": "number"
          },
          "id": {
            "$ref": "#/components/schemas/MergeSuggestionID"
          },
          "post": {
            "$ref": "#/components/schemas/LinkedPost"
          },
          "similar_post": {
            "$ref": "#/components/schemas/LinkedPost"
          },
          "status": {
            "description": "`pending` until someone accepts or dismisses the suggestion.",
            "enum": [
              "pending",
              "accepted",
              "dismissed"
            ],
            "type": "string"
          }
        },
        "required": [
          "id",
          "post",
          "similar_post",
          "distance",
          "status",
          "created_at",
          "decided_at"
        ],
        "type": "object"
      },
      "MergeSuggestionID": {
        "examples": [
          "msug_01h455vb4pex5vsknk084sn02q"
        ],
        "pattern": "^msug_[0-7][0-9a-hjkmnp-tv-z]{25}$",
        "type": "string"
      },
      "MergeSuggestionList": {
        "additionalProperties": false,
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/MergeSuggestion"
            },
            "type": "array"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "data",
          "next_cursor",
          "has_more"
        ],
        "type": "object"
      },
      "ModerationDecision": {
        "additionalProperties": false,
        "properties": {
          "state": {
            "description": "`approved` shows the content in the portal. `rejected` shows it only to its author and your\nteam.\n",
            "enum": [
              "approved",
              "rejected"
            ],
            "type": "string"
          }
        },
        "required": [
          "state"
        ],
        "type": "object"
      },
      "ModerationFlag": {
        "additionalProperties": false,
        "description": "A reason the content is held, until your team decides.",
        "properties": {
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "detail": {
            "description": "What the reason found: the kinds of data for `sensitive_data`, separated by commas; the category for `ai`; why for `ai_unavailable`. Empty for the other reasons.",
            "maxLength": 200,
            "type": "string"
          },
          "reason": {
            "description": "`approval`: the workspace reviews this kind of content first. `sensitive_data`: a card\nnumber, an IBAN, a key or a token (`detail` lists the kinds). `links`: more than 3 links.\n`duplicate`: the author wrote the same text in the last 24 hours. `ai`: the AI moderation\nfound what `detail` names (`spam`, `abuse`, `sexual`, `violence` or `personal_data`).\n`ai_unavailable`: a guest's text that the AI moderation couldn't judge (`detail` says why).\n",
            "enum": [
              "approval",
              "sensitive_data",
              "links",
              "duplicate",
              "ai",
              "ai_unavailable"
            ],
            "type": "string"
          }
        },
        "required": [
          "reason",
          "detail",
          "created_at"
        ],
        "type": "object"
      },
      "ModerationState": {
        "description": "`approved` content shows in the portal. `held` content waits for your team's review, and\n`rejected` content shows only to its author and your team. What your team and API keys create\nis always approved.\n",
        "enum": [
          "approved",
          "held",
          "rejected"
        ],
        "type": "string"
      },
      "NotificationCategory": {
        "enum": [
          "post_updates",
          "changelog",
          "digest",
          "new_posts",
          "moderation",
          "new_comments",
          "mentions"
        ],
        "type": "string"
      },
      "NotificationKind": {
        "description": "End users are notified about the posts they follow or wrote (`post_*`) and about the changelog.\nMembers are notified about new posts and comments (`post_created`, `comment_created`), what\nwaits for review (`post_held`, `comment_held`) and other members' internal notes. Both are\nnotified once when a comment mentions them (`mentioned`).\n",
        "enum": [
          "post_status_changed",
          "post_commented",
          "post_voted",
          "post_merged",
          "post_approved",
          "changelog_published",
          "post_created",
          "post_held",
          "comment_created",
          "comment_held",
          "internal_note_created",
          "mentioned"
        ],
        "type": "string"
      },
      "PortalDoneDays": {
        "description": "How many days a completed or closed post keeps its place in the portal's list first.",
        "maximum": 365,
        "minimum": 0,
        "type": "integer"
      },
      "PortalDonePosts": {
        "description": "Where the portal's list puts a post completed or closed for `portal_done_days`: where the list's\norder puts it (`in_place`), after every other post (`last`), or nowhere (`hidden`). Only while the\nlist has no status chosen and no search: then every post is listed as usual.\n",
        "enum": [
          "in_place",
          "last",
          "hidden"
        ],
        "type": "string"
      },
      "PortalGuests": {
        "description": "Whether people who don't sign in can write in the portal, as guests.",
        "enum": [
          "off",
          "on"
        ],
        "type": "string"
      },
      "PortalIdentities": {
        "description": "Whether the portal shows who wrote what (names and avatars), or only whether it came from a\ncustomer or your team. The portal never shows emails or ids.\n",
        "enum": [
          "shown",
          "hidden"
        ],
        "type": "string"
      },
      "Post": {
        "additionalProperties": false,
        "properties": {
          "attachments": {
            "items": {
              "$ref": "#/components/schemas/Asset"
            },
            "type": "array"
          },
          "author": {
            "$ref": "#/components/schemas/PostAuthor"
          },
          "board_id": {
            "$ref": "#/components/schemas/BoardID"
          },
          "body_html": {
            "description": "`body_md`, rendered as sanitized HTML.",
            "type": "string"
          },
          "body_md": {
            "maxLength": 20000,
            "type": "string"
          },
          "comment_count": {
            "description": "How many live, public, approved comments the post has.",
            "format": "int32",
            "type": "integer"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "customer_value": {
            "description": "The sum of the values of the distinct companies whose members vote for the post.",
            "format": "int64",
            "minimum": 0,
            "type": "integer"
          },
          "deleted_at": {
            "description": "Set while the post is in the trash.",
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "edited_at": {
            "description": "When the post's title or text last changed, whoever changed them. Null for a post nobody\nedited. `updated_at` also changes with every vote, status change and comment that counts in\n`comment_count`.\n",
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "id": {
            "$ref": "#/components/schemas/PostID"
          },
          "language": {
            "description": "The language the post is written in, as the AI detected it: an ISO 639-1 code, such as `ja`.\nNull until the workspace's translation has read the post, and when the AI can't name the\nlanguage.\n",
            "pattern": "^[a-z]{2}$",
            "type": [
              "string",
              "null"
            ]
          },
          "merged_into_id": {
            "description": "The post this one was merged into.",
            "pattern": "^post_[0-7][0-9a-hjkmnp-tv-z]{25}$",
            "type": [
              "string",
              "null"
            ]
          },
          "moderation_flags": {
            "description": "Why the post is held. Empty once your team has decided.",
            "items": {
              "$ref": "#/components/schemas/ModerationFlag"
            },
            "type": "array"
          },
          "moderation_state": {
            "$ref": "#/components/schemas/ModerationState"
          },
          "number": {
            "description": "The post's number in the workspace: 1, 2, 3...",
            "format": "int64",
            "type": "integer"
          },
          "slug": {
            "description": "Made from the title, and unique among the workspace's posts outside the trash. Former slugs still lead to the post.",
            "maxLength": 90,
            "pattern": "^[a-z0-9]([a-z0-9-]*[a-z0-9])?$",
            "type": "string"
          },
          "source": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Source"
              }
            ],
            "description": "Where the post came from: `dashboard` (your team, in the dashboard), `api` (an API key or\nthe MCP server), `portal` (someone on the portal or in the widget), `import` (an import) or\n`slack` (made from Slack, with the command or the shortcut).\n",
            "enum": [
              "dashboard",
              "api",
              "portal",
              "import",
              "slack"
            ],
            "type": "string"
          },
          "status": {
            "$ref": "#/components/schemas/PostStatus"
          },
          "status_changed_at": {
            "description": "When the post took its status: when it was created, or when its status last changed.",
            "format": "date-time",
            "type": "string"
          },
          "tags": {
            "description": "The post's tags, sorted by name.",
            "items": {
              "$ref": "#/components/schemas/PostTag"
            },
            "type": "array"
          },
          "title": {
            "maxLength": 200,
            "minLength": 1,
            "type": "string"
          },
          "translation": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PostTranslation"
              },
              {
                "type": "null"
              }
            ],
            "description": "The post in the language the request asked for with `language`. Null without that parameter,\nfor a post written in that language, and for one the AI hasn't translated.\n"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          },
          "visibility": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Visibility"
              }
            ],
            "description": "`public` for everyone. `private` hides the post from other customers: only your team and the\npost's author see it, and the author still gets notifications about it. A post on a private\nboard is hidden from customers whatever its visibility.\n"
          },
          "vote_count": {
            "description": "How many votes the post has, those of the posts merged into it included. A customer who voted for both counts once.",
            "format": "int32",
            "type": "integer"
          }
        },
        "required": [
          "id",
          "number",
          "board_id",
          "title",
          "slug",
          "body_md",
          "body_html",
          "status",
          "status_changed_at",
          "visibility",
          "moderation_state",
          "moderation_flags",
          "source",
          "author",
          "vote_count",
          "comment_count",
          "customer_value",
          "tags",
          "attachments",
          "merged_into_id",
          "edited_at",
          "language",
          "translation",
          "created_at",
          "updated_at",
          "deleted_at"
        ],
        "type": "object"
      },
      "PostAuthor": {
        "additionalProperties": false,
        "properties": {
          "avatar_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "email": {
            "format": "email",
            "type": [
              "string",
              "null"
            ]
          },
          "external_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "id": {
            "$ref": "#/components/schemas/EndUserID"
          },
          "kind": {
            "$ref": "#/components/schemas/EndUserKind"
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "unsigned": {
            "description": "Whether this is a guest your app named without a signed token (see the end user's `unsigned`).",
            "type": "boolean"
          }
        },
        "required": [
          "id",
          "kind",
          "unsigned",
          "external_id",
          "email",
          "name",
          "avatar_url"
        ],
        "type": "object"
      },
      "PostCounts": {
        "additionalProperties": false,
        "properties": {
          "closed": {
            "format": "int64",
            "type": "integer"
          },
          "completed": {
            "format": "int64",
            "type": "integer"
          },
          "in_progress": {
            "format": "int64",
            "type": "integer"
          },
          "pending": {
            "format": "int64",
            "type": "integer"
          },
          "planned": {
            "format": "int64",
            "type": "integer"
          },
          "review": {
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "pending",
          "review",
          "planned",
          "in_progress",
          "completed",
          "closed"
        ],
        "type": "object"
      },
      "PostCreate": {
        "additionalProperties": false,
        "description": "A new post. `status` defaults to `pending`, and `visibility` to `public`.",
        "properties": {
          "asset_ids": {
            "$ref": "#/components/schemas/AssetIDs"
          },
          "author": {
            "allOf": [
              {
                "$ref": "#/components/schemas/EndUserRef"
              }
            ],
            "description": "Who the post is from: an existing end user by `id`, or a customer by `external_id` or\n`email`, who's created if new. The author follows the post.\n"
          },
          "board_id": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BoardID"
              }
            ],
            "description": "The board to post on. It can't be in the trash."
          },
          "body_md": {
            "description": "The post's text, in Markdown.",
            "maxLength": 20000,
            "type": "string"
          },
          "status": {
            "allOf": [
              {
                "$ref": "#/components/schemas/PostStatus"
              }
            ],
            "description": "The post's status. Defaults to `pending`."
          },
          "tag_ids": {
            "description": "Tags with the `post` scope.",
            "items": {
              "$ref": "#/components/schemas/TagID"
            },
            "maxItems": 10,
            "type": "array"
          },
          "title": {
            "description": "The post's title.",
            "maxLength": 200,
            "minLength": 1,
            "type": "string"
          },
          "visibility": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Visibility"
              }
            ],
            "description": "`public` for everyone, the default. `private` hides the post from other customers: only your\nteam and the post's author see it, and the author still gets notifications about it. A post\non a private board is hidden from customers whatever its visibility.\n"
          }
        },
        "required": [
          "board_id",
          "title",
          "author"
        ],
        "type": "object"
      },
      "PostID": {
        "examples": [
          "post_01h455vb4pex5vsknk084sn02q"
        ],
        "pattern": "^post_[0-7][0-9a-hjkmnp-tv-z]{25}$",
        "type": "string"
      },
      "PostList": {
        "additionalProperties": false,
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/Post"
            },
            "type": "array"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "data",
          "next_cursor",
          "has_more"
        ],
        "type": "object"
      },
      "PostMerge": {
        "additionalProperties": false,
        "properties": {
          "into_post_id": {
            "allOf": [
              {
                "$ref": "#/components/schemas/PostID"
              }
            ],
            "description": "The post to merge this one into."
          }
        },
        "required": [
          "into_post_id"
        ],
        "type": "object"
      },
      "PostSlug": {
        "description": "The post's address on the portal, made from its title. A new title gives it a new one, and the old addresses lead to it.",
        "maxLength": 90,
        "minLength": 1,
        "pattern": "^[a-z0-9]([a-z0-9-]*[a-z0-9])?$",
        "type": "string"
      },
      "PostSort": {
        "description": "`newest` and `oldest` sort by creation date. `top` sorts by votes, and `trending` by recent\nactivity: the post's creation, its votes and its public comments, each counting half as much\nfor every 72 hours of age. `relevance` sorts by\nhow well the post matches `q`, and `customer_value` by the value of the companies whose members\nvote for the post.\n",
        "enum": [
          "newest",
          "oldest",
          "top",
          "trending",
          "relevance",
          "customer_value"
        ],
        "type": "string"
      },
      "PostStatus": {
        "enum": [
          "pending",
          "review",
          "planned",
          "in_progress",
          "completed",
          "closed"
        ],
        "type": "string"
      },
      "PostStatusUpdate": {
        "additionalProperties": false,
        "properties": {
          "note_md": {
            "description": "Your team's note about the change, in Markdown.",
            "maxLength": 5000,
            "type": "string"
          },
          "status": {
            "allOf": [
              {
                "$ref": "#/components/schemas/PostStatus"
              }
            ],
            "description": "The post's new status."
          },
          "sync_issues": {
            "default": true,
            "description": "Whether the post's linked issues follow the change. False leaves them as they are.",
            "type": "boolean"
          }
        },
        "required": [
          "status"
        ],
        "type": "object"
      },
      "PostTag": {
        "additionalProperties": false,
        "description": "A tag on a post, and who added it.",
        "properties": {
          "color": {
            "description": "The tag's color, a hex color such as `#3b82f6`, or null.",
            "pattern": "^#[0-9a-f]{6}$",
            "type": [
              "string",
              "null"
            ]
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "id": {
            "$ref": "#/components/schemas/TagID"
          },
          "name": {
            "maxLength": 40,
            "minLength": 1,
            "type": "string"
          },
          "scope": {
            "$ref": "#/components/schemas/TagScope"
          },
          "source": {
            "description": "`ai` if the AI chose the tag (`ai_tagging`), else `manual`.",
            "enum": [
              "manual",
              "ai"
            ],
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "id",
          "scope",
          "name",
          "color",
          "created_at",
          "updated_at",
          "source"
        ],
        "type": "object"
      },
      "PostTagsUpdate": {
        "additionalProperties": false,
        "properties": {
          "tag_ids": {
            "description": "The post's new tags, all with the `post` scope. An empty list removes every tag.",
            "items": {
              "$ref": "#/components/schemas/TagID"
            },
            "maxItems": 10,
            "type": "array"
          }
        },
        "required": [
          "tag_ids"
        ],
        "type": "object"
      },
      "PostTranslation": {
        "additionalProperties": false,
        "description": "A post's title and text in the language the request asked for, as the AI translated them. Show\nthe translation beside the original, never in its place: say that it's an automatic\ntranslation, and keep the original one click away. Editing the post removes the translation\nuntil the AI has read the new text.\n",
        "properties": {
          "body_html": {
            "description": "The translated text, rendered as sanitized HTML like the original.",
            "type": "string"
          },
          "language": {
            "$ref": "#/components/schemas/Locale"
          },
          "title": {
            "type": "string"
          }
        },
        "required": [
          "language",
          "title",
          "body_html"
        ],
        "type": "object"
      },
      "PostUpdate": {
        "additionalProperties": false,
        "properties": {
          "asset_ids": {
            "allOf": [
              {
                "$ref": "#/components/schemas/AssetIDs"
              }
            ],
            "description": "The images to attach, in order, in place of the current ones. Images already attached can\nstay; any others must be your own uploads that aren't attached to anything yet.\n"
          },
          "board_id": {
            "allOf": [
              {
                "$ref": "#/components/schemas/BoardID"
              }
            ],
            "description": "The board to move the post to. It can't be in the trash."
          },
          "body_md": {
            "description": "The post's new text, in Markdown.",
            "maxLength": 20000,
            "type": "string"
          },
          "title": {
            "description": "The post's new title. The slug follows it, and former slugs still lead to the post.",
            "maxLength": 200,
            "minLength": 1,
            "type": "string"
          },
          "visibility": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Visibility"
              }
            ],
            "description": "`public` for everyone. `private` hides the post from other customers: only your team and the\npost's author see it, and the author still gets notifications about it. A post on a private\nboard is hidden from customers whatever its visibility.\n"
          }
        },
        "type": "object"
      },
      "Problem": {
        "description": "An error, as RFC 9457 problem details. Branch on `code`, a stable identifier; `type` is\n`about:blank`. New codes can be added over time.\n",
        "properties": {
          "code": {
            "description": "A stable error code in snake_case, such as `not_found` or `rate_limited`.",
            "examples": [
              "validation_failed"
            ],
            "type": "string"
          },
          "detail": {
            "description": "A message for people. Don't parse it.",
            "type": "string"
          },
          "errors": {
            "description": "For `validation_failed`, the invalid parts of the request.",
            "items": {
              "$ref": "#/components/schemas/FieldError"
            },
            "type": "array"
          },
          "request_id": {
            "description": "The request's id, also in the `X-Request-Id` header. Quote it to support.",
            "type": "string"
          },
          "retry_after_seconds": {
            "description": "For `rate_limited` and `idempotency_request_in_progress`, how many seconds to wait before retrying.",
            "format": "int32",
            "type": "integer"
          },
          "status": {
            "format": "int32",
            "type": "integer"
          },
          "title": {
            "description": "The HTTP status phrase.",
            "type": "string"
          },
          "type": {
            "examples": [
              "about:blank"
            ],
            "format": "uri-reference",
            "type": "string"
          }
        },
        "required": [
          "type",
          "title",
          "status",
          "code",
          "request_id"
        ],
        "type": "object"
      },
      "ReadTranslations": {
        "description": "Whether this person wants to read posts and comments in their own language when a workspace\ntranslates them (`ai_translation`). True unless they turned it off, and only they can change\nit. It's a preference for the reader's client: a read that names a `language` gets translations\nwhatever this says. A workspace that doesn't translate has no translations for anyone.\n",
        "type": "boolean"
      },
      "Roadmap": {
        "additionalProperties": false,
        "properties": {
          "columns": {
            "items": {
              "$ref": "#/components/schemas/RoadmapColumn"
            },
            "type": "array"
          }
        },
        "required": [
          "columns"
        ],
        "type": "object"
      },
      "RoadmapColumn": {
        "additionalProperties": false,
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/Post"
            },
            "type": "array"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "description": "Pass it to `listRoadmapColumn` to get the column's next page.",
            "type": [
              "string",
              "null"
            ]
          },
          "status": {
            "$ref": "#/components/schemas/PostStatus"
          }
        },
        "required": [
          "status",
          "data",
          "next_cursor",
          "has_more"
        ],
        "type": "object"
      },
      "RoadmapVisibility": {
        "description": "Whether the portal shows the roadmap. Your team sees it either way.",
        "enum": [
          "shown",
          "hidden"
        ],
        "type": "string"
      },
      "Role": {
        "enum": [
          "owner",
          "admin"
        ],
        "type": "string"
      },
      "SSOLoginURL": {
        "description": "The page on your site where the portal sends visitors to sign in. Your page signs them in and\nsends them back to the portal with an identity token. Null when the portal signs people in\nitself.\n",
        "maxLength": 2048,
        "type": [
          "string",
          "null"
        ]
      },
      "Slug": {
        "description": "The name in the workspace's portal address: lowercase letters, digits and single hyphens,\nstarting with a letter. Some names are reserved.\n",
        "maxLength": 40,
        "minLength": 3,
        "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$",
        "type": "string"
      },
      "Source": {
        "description": "Where the content came from. `dashboard`: your team, in the dashboard. `api`: an API key, or an\nAI agent through the MCP server. `portal`: someone on the portal or in the widget (`widget` is\nreserved: content written in the widget has the source `portal`). `import`: an import.\n`slack`: a post made from Slack, with the command or the shortcut. `github` and `linear`: a\ncomment someone wrote on a linked issue in that tracker.\n",
        "enum": [
          "dashboard",
          "api",
          "portal",
          "widget",
          "import",
          "slack",
          "github",
          "linear"
        ],
        "type": "string"
      },
      "Stats": {
        "additionalProperties": false,
        "properties": {
          "boards": {
            "description": "The boards not in the trash.",
            "format": "int64",
            "type": "integer"
          },
          "end_users": {
            "description": "Every end user: customers, guests and your team members' own, erased ones included.",
            "format": "int64",
            "type": "integer"
          },
          "posts": {
            "description": "The posts, without those in the trash, on a board in the trash, or merged into another.",
            "format": "int64",
            "type": "integer"
          },
          "posts_by_status": {
            "allOf": [
              {
                "$ref": "#/components/schemas/PostCounts"
              }
            ],
            "description": "The same posts, counted by status."
          },
          "votes": {
            "description": "The votes on posts not in the trash, those on a board in the trash included. A merged post's votes count on the post it went into, once per customer.",
            "format": "int64",
            "type": "integer"
          }
        },
        "required": [
          "posts",
          "posts_by_status",
          "votes",
          "boards",
          "end_users"
        ],
        "type": "object"
      },
      "StatusChange": {
        "additionalProperties": false,
        "properties": {
          "actor": {
            "$ref": "#/components/schemas/StatusChangeActor"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "from_status": {
            "$ref": "#/components/schemas/PostStatus"
          },
          "id": {
            "$ref": "#/components/schemas/StatusChangeID"
          },
          "note_html": {
            "description": "The note, as HTML.",
            "type": "string"
          },
          "note_md": {
            "description": "The note written with the change, in Markdown. Empty without one.",
            "maxLength": 5000,
            "type": "string"
          },
          "post_id": {
            "$ref": "#/components/schemas/PostID"
          },
          "to_status": {
            "$ref": "#/components/schemas/PostStatus"
          }
        },
        "required": [
          "id",
          "post_id",
          "from_status",
          "to_status",
          "note_md",
          "note_html",
          "actor",
          "created_at"
        ],
        "type": "object"
      },
      "StatusChangeActor": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "description": "The id of the account, API key, import or integration. Null for the system.",
            "pattern": "^(acct|key|import|integration)_[0-7][0-9a-hjkmnp-tv-z]{25}$",
            "type": [
              "string",
              "null"
            ]
          },
          "type": {
            "description": "Who changed the status: a team member's `account`, an `api_key`, the `system`, an `import`\nfor history that an import brought in, or an `integration` when the post's GitHub or Linear\nissues moved it.\n",
            "enum": [
              "account",
              "api_key",
              "system",
              "import",
              "integration"
            ],
            "type": "string"
          }
        },
        "required": [
          "type",
          "id"
        ],
        "type": "object"
      },
      "StatusChangeID": {
        "examples": [
          "change_01h455vb4pex5vsknk084sn02q"
        ],
        "pattern": "^change_[0-7][0-9a-hjkmnp-tv-z]{25}$",
        "type": "string"
      },
      "StatusChangeList": {
        "additionalProperties": false,
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/StatusChange"
            },
            "type": "array"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "data",
          "next_cursor",
          "has_more"
        ],
        "type": "object"
      },
      "Subscriber": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "end_user": {
            "$ref": "#/components/schemas/EndUser"
          },
          "reason": {
            "$ref": "#/components/schemas/SubscriptionReason"
          }
        },
        "required": [
          "end_user",
          "reason",
          "created_at"
        ],
        "type": "object"
      },
      "SubscriberCreate": {
        "additionalProperties": false,
        "properties": {
          "end_user": {
            "allOf": [
              {
                "$ref": "#/components/schemas/EndUserRef"
              }
            ],
            "description": "Who follows the post: an existing end user by `id`, or a customer by `external_id` or\n`email`, who's created if new.\n"
          }
        },
        "required": [
          "end_user"
        ],
        "type": "object"
      },
      "SubscriberList": {
        "additionalProperties": false,
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/Subscriber"
            },
            "type": "array"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "data",
          "next_cursor",
          "has_more"
        ],
        "type": "object"
      },
      "SubscriptionReason": {
        "description": "Why the end user follows the post. `manual` means they chose to follow it.",
        "enum": [
          "author",
          "voter",
          "commenter",
          "manual"
        ],
        "type": "string"
      },
      "Tag": {
        "additionalProperties": false,
        "properties": {
          "color": {
            "description": "The tag's color, a hex color such as `#3b82f6`, or null.",
            "pattern": "^#[0-9a-f]{6}$",
            "type": [
              "string",
              "null"
            ]
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "id": {
            "$ref": "#/components/schemas/TagID"
          },
          "name": {
            "maxLength": 40,
            "minLength": 1,
            "type": "string"
          },
          "scope": {
            "$ref": "#/components/schemas/TagScope"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "id",
          "scope",
          "name",
          "color",
          "created_at",
          "updated_at"
        ],
        "type": "object"
      },
      "TagCreate": {
        "additionalProperties": false,
        "properties": {
          "color": {
            "$ref": "#/components/schemas/Color"
          },
          "name": {
            "description": "The tag's name, unique in its scope, ignoring case.",
            "maxLength": 40,
            "minLength": 1,
            "type": "string"
          },
          "scope": {
            "$ref": "#/components/schemas/TagScope"
          }
        },
        "required": [
          "scope",
          "name"
        ],
        "type": "object"
      },
      "TagID": {
        "examples": [
          "tag_01h455vb4pex5vsknk084sn02q"
        ],
        "pattern": "^tag_[0-7][0-9a-hjkmnp-tv-z]{25}$",
        "type": "string"
      },
      "TagList": {
        "additionalProperties": false,
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/Tag"
            },
            "type": "array"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "data",
          "next_cursor",
          "has_more"
        ],
        "type": "object"
      },
      "TagScope": {
        "description": "What the tag labels: `post` for posts, `changelog` for changelog entries.",
        "enum": [
          "post",
          "changelog"
        ],
        "type": "string"
      },
      "TagUpdate": {
        "additionalProperties": false,
        "properties": {
          "color": {
            "description": "A hex color, such as `#3b82f6`. Null removes the color.",
            "pattern": "^#[0-9a-fA-F]{6}$",
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "description": "The tag's new name, unique in its scope, ignoring case.",
            "maxLength": 40,
            "minLength": 1,
            "type": "string"
          }
        },
        "type": "object"
      },
      "Theme": {
        "description": "The portal's color scheme. `system` follows the visitor's device.",
        "enum": [
          "system",
          "light",
          "dark"
        ],
        "type": "string"
      },
      "TimeZone": {
        "description": "An IANA time zone, such as `Europe/Paris`.",
        "examples": [
          "Europe/Paris"
        ],
        "maxLength": 64,
        "pattern": "^[A-Za-z][A-Za-z0-9_+/-]*$",
        "type": "string"
      },
      "TrackerIssue": {
        "additionalProperties": false,
        "description": "The workspace's copy of a linked issue, as its tracker last described it.",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/TrackerIssueID"
          },
          "key": {
            "description": "The issue's key on its tracker, such as `#123` or `ENG-123`.",
            "type": "string"
          },
          "labels": {
            "items": {
              "type": "string"
            },
            "maxItems": 100,
            "type": "array"
          },
          "left": {
            "description": "Why the issue no longer counts: `deleted` (on Linear, moved to the trash), `transferred` to a\nrepository (or moved to a team) where the workspace takes no issues, or `unreachable` by its\nconnection.\n",
            "enum": [
              "deleted",
              "transferred",
              "unreachable",
              null
            ],
            "type": [
              "string",
              "null"
            ]
          },
          "state": {
            "description": "On GitHub, `open` or `closed`. On Linear, the type of the issue's workflow state: `triage`,\n`backlog`, `unstarted`, `started`, `completed`, `canceled` or `duplicate`.\n",
            "type": "string"
          },
          "state_name": {
            "description": "On Linear, the name of the issue's workflow state, such as `In Review`. Null on GitHub.",
            "type": [
              "string",
              "null"
            ]
          },
          "state_reason": {
            "description": "On GitHub, why the issue was closed or reopened: `completed`, `not_planned`, `duplicate` or `reopened`.",
            "type": [
              "string",
              "null"
            ]
          },
          "status": {
            "description": "The post status that the issue's state maps to, under its connection's settings. Null when it\nmaps to none, and for an issue that `left` or is a duplicate.\n",
            "enum": [
              "review",
              "planned",
              "in_progress",
              "completed",
              "closed",
              null
            ],
            "type": [
              "string",
              "null"
            ]
          },
          "title": {
            "type": "string"
          },
          "updated_at": {
            "description": "When the issue last changed, by its tracker's clock.",
            "format": "date-time",
            "type": "string"
          },
          "url": {
            "description": "The issue's page on its tracker.",
            "type": "string"
          }
        },
        "required": [
          "id",
          "key",
          "url",
          "title",
          "state",
          "state_reason",
          "state_name",
          "labels",
          "status",
          "left",
          "updated_at"
        ],
        "type": "object"
      },
      "TrackerIssueID": {
        "examples": [
          "issue_01h455vb4pex5vsknk084sn02q"
        ],
        "pattern": "^issue_[0-7][0-9a-hjkmnp-tv-z]{25}$",
        "type": "string"
      },
      "TraitChanges": {
        "additionalProperties": {
          "anyOf": [
            {
              "maxLength": 256,
              "type": "string"
            },
            {
              "type": "number"
            },
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ]
        },
        "description": "Traits to set, by key. A key is a letter followed by up to 63 letters, digits or underscores. A\nvalue is a string (up to 256 characters), a number or a boolean, and null removes the trait. The\nfirst value sent for a new key defines its type, and later values must have that type. A `date`\ntrait (see `defineTrait`) takes `2026-09-28` or an RFC 3339 time. Traits you don't send stay as\nthey are.\n",
        "maxProperties": 50,
        "type": "object"
      },
      "TraitDefinition": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "id": {
            "$ref": "#/components/schemas/TraitID"
          },
          "key": {
            "$ref": "#/components/schemas/TraitKey"
          },
          "subject": {
            "$ref": "#/components/schemas/TraitSubject"
          },
          "type": {
            "$ref": "#/components/schemas/TraitType"
          }
        },
        "required": [
          "id",
          "subject",
          "key",
          "type",
          "created_at"
        ],
        "type": "object"
      },
      "TraitDefinitionCreate": {
        "additionalProperties": false,
        "properties": {
          "key": {
            "$ref": "#/components/schemas/TraitKey"
          },
          "subject": {
            "$ref": "#/components/schemas/TraitSubject"
          },
          "type": {
            "$ref": "#/components/schemas/TraitType"
          }
        },
        "required": [
          "subject",
          "key",
          "type"
        ],
        "type": "object"
      },
      "TraitDefinitionList": {
        "additionalProperties": false,
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/TraitDefinition"
            },
            "maxItems": 100,
            "type": "array"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "description": "Always null: the list comes in one page.",
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "data",
          "next_cursor",
          "has_more"
        ],
        "type": "object"
      },
      "TraitID": {
        "examples": [
          "trait_01h455vb4pex5vsknk084sn02q"
        ],
        "pattern": "^trait_[0-7][0-9a-hjkmnp-tv-z]{25}$",
        "type": "string"
      },
      "TraitKey": {
        "description": "The trait's key, a letter followed by up to 63 letters, digits or underscores.",
        "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$",
        "type": "string"
      },
      "TraitSubject": {
        "description": "What the trait describes: `end_user` for end users, `company` for companies.",
        "enum": [
          "end_user",
          "company"
        ],
        "type": "string"
      },
      "TraitType": {
        "description": "The type of the trait's values. A `date` takes `2026-09-28` or an RFC 3339 time.",
        "enum": [
          "string",
          "number",
          "boolean",
          "date"
        ],
        "type": "string"
      },
      "Traits": {
        "additionalProperties": {
          "anyOf": [
            {
              "maxLength": 256,
              "type": "string"
            },
            {
              "type": "number"
            },
            {
              "type": "boolean"
            }
          ]
        },
        "description": "The traits, by key. A `date` trait is a string such as `2026-09-28` or an RFC 3339 time.",
        "type": "object"
      },
      "Visibility": {
        "description": "`public` or `private`. A private board is for your team only. A private post is for your team\nand the post's author.\n",
        "enum": [
          "public",
          "private"
        ],
        "type": "string"
      },
      "Vote": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "end_user": {
            "$ref": "#/components/schemas/EndUser"
          },
          "id": {
            "$ref": "#/components/schemas/VoteID"
          },
          "post_id": {
            "$ref": "#/components/schemas/PostID"
          },
          "source": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Source"
              }
            ],
            "description": "Where the vote came from: `dashboard` (a teammate added it in the dashboard, for themselves\nor a customer), `api` (an API key), `portal` (the end user voted on the portal or in the\nwidget) or `import` (an import).\n",
            "enum": [
              "dashboard",
              "api",
              "portal",
              "import"
            ],
            "type": "string"
          }
        },
        "required": [
          "id",
          "post_id",
          "end_user",
          "source",
          "created_at"
        ],
        "type": "object"
      },
      "VoteCreate": {
        "additionalProperties": false,
        "properties": {
          "end_user": {
            "allOf": [
              {
                "$ref": "#/components/schemas/EndUserRef"
              }
            ],
            "description": "Who votes: an existing end user by `id`, or a customer by `external_id` or `email`, who's\ncreated if new.\n"
          }
        },
        "required": [
          "end_user"
        ],
        "type": "object"
      },
      "VoteID": {
        "examples": [
          "vote_01h455vb4pex5vsknk084sn02q"
        ],
        "pattern": "^vote_[0-7][0-9a-hjkmnp-tv-z]{25}$",
        "type": "string"
      },
      "VoteList": {
        "additionalProperties": false,
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/Vote"
            },
            "type": "array"
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "data",
          "next_cursor",
          "has_more"
        ],
        "type": "object"
      },
      "WebhookChangelogEntry": {
        "description": "A changelog entry in a webhook message, without its text.",
        "properties": {
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "deleted_at": {
            "description": "Set while the entry is in the trash.",
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "id": {
            "$ref": "#/components/schemas/ChangelogEntryID"
          },
          "published_at": {
            "description": "When the entry was last made public.",
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "slug": {
            "description": "The entry's slug, which `url` ends with.",
            "type": "string"
          },
          "status": {
            "enum": [
              "draft",
              "scheduled",
              "published"
            ],
            "type": "string"
          },
          "summary": {
            "description": "Plain text, for lists, feeds and emails.",
            "type": "string"
          },
          "title": {
            "description": "The entry's title.",
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          },
          "url": {
            "description": "The entry's address in the portal.",
            "type": "string"
          },
          "whisper": {
            "description": "Whether the entry is published quietly: it's never announced or marked unread.",
            "type": "boolean"
          }
        },
        "required": [
          "id",
          "title",
          "slug",
          "summary",
          "status",
          "whisper",
          "published_at",
          "url",
          "created_at",
          "updated_at",
          "deleted_at"
        ],
        "type": "object"
      },
      "WebhookChangelogEntryMessage": {
        "allOf": [
          {
            "$ref": "#/components/schemas/WebhookMessage"
          },
          {
            "properties": {
              "data": {
                "description": "The entry's snapshot, under `changelog_entry`. `changelog_entry.published` also has\n`whisper` and `first_publication`, which is true the first time the entry is published.\n`changelog_entry.unpublished` has nothing more.\n",
                "properties": {
                  "changelog_entry": {
                    "anyOf": [
                      {
                        "$ref": "#/components/schemas/WebhookChangelogEntry"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "changelog_entry"
                ],
                "type": "object"
              }
            },
            "type": "object"
          }
        ]
      },
      "WebhookComment": {
        "description": "A public comment in a webhook message, with its Markdown. It names its author by id.",
        "properties": {
          "author_id": {
            "allOf": [
              {
                "$ref": "#/components/schemas/EndUserID"
              }
            ],
            "description": "The end user who wrote the comment."
          },
          "body_md": {
            "description": "The comment's Markdown. A mention is the person's token, such as `<@user_…>`.",
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "deleted_at": {
            "description": "Set while the comment is in the trash.",
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "heart_count": {
            "description": "How many likes the comment has.",
            "format": "int32",
            "type": "integer"
          },
          "id": {
            "$ref": "#/components/schemas/CommentID"
          },
          "moderation_state": {
            "description": "`approved`, `held` for your team's review, or `rejected`.",
            "enum": [
              "approved",
              "held",
              "rejected"
            ],
            "type": "string"
          },
          "parent_id": {
            "description": "The comment this one replies to, or null for a top-level comment.",
            "type": [
              "string",
              "null"
            ]
          },
          "pinned": {
            "description": "Whether your team pinned the comment to the top of its post.",
            "type": "boolean"
          },
          "post_id": {
            "allOf": [
              {
                "$ref": "#/components/schemas/PostID"
              }
            ],
            "description": "The post the comment is on."
          },
          "source": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Source"
              }
            ],
            "description": "Where the comment came from: `dashboard`, `api`, `portal` or `import`, as on the comment\nobject. `github` and `linear` mark a comment someone wrote on a linked issue in that tracker.\n",
            "enum": [
              "dashboard",
              "api",
              "portal",
              "import",
              "github",
              "linear"
            ],
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "id",
          "post_id",
          "parent_id",
          "body_md",
          "moderation_state",
          "source",
          "author_id",
          "pinned",
          "heart_count",
          "created_at",
          "updated_at",
          "deleted_at"
        ],
        "type": "object"
      },
      "WebhookCommentMessage": {
        "allOf": [
          {
            "$ref": "#/components/schemas/WebhookMessage"
          },
          {
            "properties": {
              "data": {
                "description": "The comment's snapshot, under `comment`, and the event's own fields:\n\n- `comment.created`: `post_id`, `author_id` and `moderation_state`, the `parent_id` of a reply, and `mentioned`, the ids of the end users the comment mentions, if any.\n- `comment.updated`: `changed`, the fields that changed: `body_md` and `attachments`. When the new text mentions people the old one didn't, `mentioned` has their end-user ids.\n- `comment.approved` and `comment.rejected`: `from`, the moderation state it had before.\n- `comment.held`: `reasons`, why an approved comment is now held: `ai` or `ai_unavailable`, when the AI moderation held it.\n- `comment.deleted` and `comment.restored`: nothing more.\n",
                "properties": {
                  "comment": {
                    "anyOf": [
                      {
                        "$ref": "#/components/schemas/WebhookComment"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "comment"
                ],
                "type": "object"
              }
            },
            "type": "object"
          }
        ]
      },
      "WebhookMessage": {
        "description": "What a webhook endpoint receives. `data` holds the event's own fields (ids and states) and a\nsnapshot of its subject: `post`, `comment`, `vote` (with its `post`) or `changelog_entry`. The\nsnapshot is taken when the message is queued, a moment after the event, and a replay sends it\nunchanged. It's null if the subject was deleted for good in between. Messages never include\npeople's names or emails: look them up with the API.\n",
        "properties": {
          "data": {
            "additionalProperties": true,
            "description": "The event's fields and its subject's snapshot. A test message has only a `message`.",
            "type": "object"
          },
          "timestamp": {
            "description": "When the event happened.",
            "format": "date-time",
            "type": "string"
          },
          "type": {
            "description": "The event's type, or `webhook.test`.",
            "type": "string"
          },
          "workspace_id": {
            "$ref": "#/components/schemas/WorkspaceID"
          }
        },
        "required": [
          "type",
          "timestamp",
          "workspace_id",
          "data"
        ],
        "type": "object"
      },
      "WebhookPost": {
        "description": "A post in a webhook message. It leaves out the post's text, and names its author by id.",
        "properties": {
          "author_id": {
            "allOf": [
              {
                "$ref": "#/components/schemas/EndUserID"
              }
            ],
            "description": "The end user who wrote the post."
          },
          "board": {
            "description": "The post's board.",
            "properties": {
              "id": {
                "$ref": "#/components/schemas/BoardID"
              },
              "name": {
                "description": "The board's name.",
                "type": "string"
              },
              "visibility": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/Visibility"
                  }
                ],
                "description": "`public` for everyone, or `private` for your team only: customers see neither the board nor its posts."
              }
            },
            "required": [
              "id",
              "name",
              "visibility"
            ],
            "type": "object"
          },
          "comment_count": {
            "description": "How many live, public, approved comments the post has.",
            "format": "int32",
            "type": "integer"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "deleted_at": {
            "description": "Set while the post is in the trash.",
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "id": {
            "$ref": "#/components/schemas/PostID"
          },
          "merged_into_id": {
            "description": "The post this one was merged into, or null.",
            "type": [
              "string",
              "null"
            ]
          },
          "moderation_state": {
            "description": "`approved`, `held` for your team's review, or `rejected`.",
            "enum": [
              "approved",
              "held",
              "rejected"
            ],
            "type": "string"
          },
          "number": {
            "description": "The post's number in the workspace: 1, 2, 3...",
            "format": "int64",
            "type": "integer"
          },
          "slug": {
            "description": "The post's slug, which `url` ends with.",
            "type": "string"
          },
          "source": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Source"
              }
            ],
            "description": "Where the post came from: `dashboard` (your team, in the dashboard), `api` (an API key or\nthe MCP server), `portal` (someone on the portal or in the widget), `import` (an import) or\n`slack` (made from Slack, with the command or the shortcut).\n",
            "enum": [
              "dashboard",
              "api",
              "portal",
              "import",
              "slack"
            ],
            "type": "string"
          },
          "status": {
            "$ref": "#/components/schemas/PostStatus"
          },
          "title": {
            "description": "The post's title.",
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          },
          "url": {
            "description": "The post's address in the portal.",
            "type": "string"
          },
          "visibility": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Visibility"
              }
            ],
            "description": "`public` for everyone. `private` hides the post from other customers: only your team and the\npost's author see it, and the author still gets notifications about it. A post on a private\nboard is hidden from customers whatever its visibility.\n"
          },
          "vote_count": {
            "description": "How many votes the post has.",
            "format": "int32",
            "type": "integer"
          }
        },
        "required": [
          "id",
          "number",
          "title",
          "slug",
          "status",
          "board",
          "visibility",
          "moderation_state",
          "source",
          "author_id",
          "vote_count",
          "comment_count",
          "merged_into_id",
          "url",
          "created_at",
          "updated_at",
          "deleted_at"
        ],
        "type": "object"
      },
      "WebhookPostMessage": {
        "allOf": [
          {
            "$ref": "#/components/schemas/WebhookMessage"
          },
          {
            "properties": {
              "data": {
                "description": "The post's snapshot, under `post`, and the event's own fields:\n\n- `post.created`: `board_id`, `author_id` and `number`. A post written in the portal or the widget also has its `moderation_state`: one held for review when it's written sends `post.created` with `held`, never `post.held`.\n- `post.updated`: `changed`, the fields that changed: `title`, `slug` (a new title gives the post a new slug), `body_md`, `board_id`, `visibility` and `attachments`.\n- `post.status_changed`: the status it went `from` and `to`, and the `status_change_id`.\n- `post.tags_changed`: the ids of the tags `added` and `removed`, and `source: ai` when the AI tagging added them.\n- `post.merged`: `into_post_id`, the post it was merged into.\n- `post.unmerged`: `from_post_id`, the post it had been merged into.\n- `post.approved` and `post.rejected`: `from`, the moderation state it had before.\n- `post.held`: `reasons`, why an approved post is now held: `ai` or `ai_unavailable` when the AI moderation held it, and `approval`, `sensitive_data` or `links` when its author's edit did. They're the `reason` values of the post's moderation flags.\n- `post.deleted` and `post.restored`: nothing more.\n",
                "properties": {
                  "post": {
                    "anyOf": [
                      {
                        "$ref": "#/components/schemas/WebhookPost"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "post"
                ],
                "type": "object"
              }
            },
            "type": "object"
          }
        ]
      },
      "WebhookVote": {
        "description": "A vote in a webhook message.",
        "properties": {
          "end_user_id": {
            "allOf": [
              {
                "$ref": "#/components/schemas/EndUserID"
              }
            ],
            "description": "The end user who voted."
          },
          "id": {
            "$ref": "#/components/schemas/VoteID"
          },
          "post_id": {
            "allOf": [
              {
                "$ref": "#/components/schemas/PostID"
              }
            ],
            "description": "The post voted for."
          }
        },
        "required": [
          "id",
          "post_id",
          "end_user_id"
        ],
        "type": "object"
      },
      "WebhookVoteMessage": {
        "allOf": [
          {
            "$ref": "#/components/schemas/WebhookMessage"
          },
          {
            "properties": {
              "data": {
                "description": "The `vote`, its post's snapshot under `post`, and the vote's `post_id` and `end_user_id`.\n`vote.created` and `vote.deleted` have the same fields.\n",
                "properties": {
                  "post": {
                    "anyOf": [
                      {
                        "$ref": "#/components/schemas/WebhookPost"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "vote": {
                    "$ref": "#/components/schemas/WebhookVote"
                  }
                },
                "required": [
                  "vote",
                  "post"
                ],
                "type": "object"
              }
            },
            "type": "object"
          }
        ]
      },
      "WidgetOrigins": {
        "description": "The origins that can embed the widget, such as `https://app.example.com`, or\n`https://*.example.com` for its subdomains. Only localhost can use http. An empty list allows\nany origin. The widget's page lists them in its `Content-Security-Policy: frame-ancestors`\nheader.\n",
        "items": {
          "maxLength": 2048,
          "minLength": 1,
          "type": "string"
        },
        "maxItems": 20,
        "type": "array"
      },
      "WidgetPosition": {
        "description": "Which side of the page the widget's launcher is on.",
        "enum": [
          "left",
          "right"
        ],
        "type": "string"
      },
      "WidgetSection": {
        "enum": [
          "feedback",
          "roadmap",
          "changelog"
        ],
        "type": "string"
      },
      "WidgetSections": {
        "description": "The widget's sections. They always show in the order `feedback`, `roadmap`, `changelog`, whatever order you send.",
        "items": {
          "$ref": "#/components/schemas/WidgetSection"
        },
        "maxItems": 3,
        "minItems": 1,
        "type": "array",
        "uniqueItems": true
      },
      "Workspace": {
        "additionalProperties": false,
        "properties": {
          "ai_duplicates": {
            "description": "Whether the AI looks for duplicates of new posts and suggests merging them.",
            "type": "boolean"
          },
          "ai_moderation": {
            "description": "Whether the AI screens what the public writes in the portal, and holds what it flags.",
            "type": "boolean"
          },
          "ai_tagging": {
            "description": "Whether the AI tags new posts that have no tags.",
            "type": "boolean"
          },
          "ai_translation": {
            "description": "Whether the AI translates posts and public comments into the portal's other languages. A\nread that names a `language` then gets a post's title and text, or a comment's text, in that\nlanguage, beside the original.\n",
            "type": "boolean"
          },
          "brand_color": {
            "description": "The portal's accent color, a hex color such as `#3b82f6`, or null.",
            "pattern": "^#[0-9a-f]{6}$",
            "type": [
              "string",
              "null"
            ]
          },
          "comment_approval": {
            "$ref": "#/components/schemas/Approval"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "deleted_at": {
            "description": "Set while the workspace is being deleted. Only its owners, signed in to the dashboard, can see it then: API keys get 404.",
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "digest": {
            "$ref": "#/components/schemas/DigestSetting"
          },
          "id": {
            "$ref": "#/components/schemas/WorkspaceID"
          },
          "locale": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Locale"
              }
            ],
            "description": "The workspace's default language. The portal uses it for visitors whose language it doesn't\noffer, and emails use it for people whose language isn't known. The changelog's RSS feed, AI\ndrafts and search use it too. The dashboard itself is in English.\n"
          },
          "logo_asset_id": {
            "description": "The uploaded image used as the logo.",
            "pattern": "^asset_[0-7][0-9a-hjkmnp-tv-z]{25}$",
            "type": [
              "string",
              "null"
            ]
          },
          "logo_url": {
            "description": "The logo's public address.",
            "format": "uri",
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "maxLength": 80,
            "minLength": 1,
            "type": "string"
          },
          "plan": {
            "description": "The billing plan, such as `free`.",
            "type": "string"
          },
          "portal_domain": {
            "description": "The portal's active custom domain, which is then its canonical host.",
            "type": [
              "string",
              "null"
            ]
          },
          "portal_done_days": {
            "$ref": "#/components/schemas/PortalDoneDays"
          },
          "portal_done_posts": {
            "$ref": "#/components/schemas/PortalDonePosts"
          },
          "portal_guests": {
            "$ref": "#/components/schemas/PortalGuests"
          },
          "portal_identities": {
            "$ref": "#/components/schemas/PortalIdentities"
          },
          "portal_roadmap": {
            "$ref": "#/components/schemas/RoadmapVisibility"
          },
          "post_approval": {
            "$ref": "#/components/schemas/Approval"
          },
          "powered_by": {
            "description": "Whether the portal shows \"Powered by Swingback\".",
            "type": "boolean"
          },
          "purge_after": {
            "description": "When a workspace that's being deleted will be purged for good, unless its owners restore it first.",
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "slug": {
            "$ref": "#/components/schemas/Slug"
          },
          "sso_login_url": {
            "$ref": "#/components/schemas/SSOLoginURL"
          },
          "theme": {
            "$ref": "#/components/schemas/Theme"
          },
          "time_zone": {
            "$ref": "#/components/schemas/TimeZone"
          },
          "unsigned_keep_email": {
            "description": "Whether Swingback keeps, unverified, the emails your app sends for those users. A kept email\nshows to your team, but it's never used to find anyone, never emailed and never shown in the\nportal. Off by default.\n",
            "type": "boolean"
          },
          "unsigned_sign_in": {
            "description": "Whether the widget signs in the users your app names without a signed token. This is\ndangerous: anyone who knows or guesses a user's id can sign in as them. Off by default.\n",
            "type": "boolean"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          },
          "widget_color": {
            "description": "The widget's accent color, a hex color such as `#3b82f6`, or null.",
            "pattern": "^#[0-9a-f]{6}$",
            "type": [
              "string",
              "null"
            ]
          },
          "widget_origins": {
            "$ref": "#/components/schemas/WidgetOrigins"
          },
          "widget_position": {
            "$ref": "#/components/schemas/WidgetPosition"
          },
          "widget_sections": {
            "$ref": "#/components/schemas/WidgetSections"
          }
        },
        "required": [
          "id",
          "name",
          "slug",
          "locale",
          "time_zone",
          "plan",
          "portal_identities",
          "portal_guests",
          "post_approval",
          "comment_approval",
          "portal_roadmap",
          "portal_done_posts",
          "portal_done_days",
          "widget_sections",
          "widget_color",
          "widget_position",
          "widget_origins",
          "sso_login_url",
          "digest",
          "portal_domain",
          "brand_color",
          "theme",
          "powered_by",
          "logo_asset_id",
          "logo_url",
          "ai_tagging",
          "ai_duplicates",
          "ai_moderation",
          "ai_translation",
          "unsigned_sign_in",
          "unsigned_keep_email",
          "deleted_at",
          "purge_after",
          "created_at",
          "updated_at"
        ],
        "type": "object"
      },
      "WorkspaceID": {
        "examples": [
          "ws_01h455vb4pex5vsknk084sn02q"
        ],
        "pattern": "^ws_[0-7][0-9a-hjkmnp-tv-z]{25}$",
        "type": "string"
      }
    },
    "securitySchemes": {
      "bearer": {
        "description": "An API key (`s_live_...`), which a workspace's owners and admins create in the dashboard.",
        "scheme": "bearer",
        "type": "http"
      }
    }
  },
  "info": {
    "description": "The Swingback REST API, for your servers.\n\n**Authentication.** Send an API key as a bearer token: `Authorization: Bearer s_live_...`. A\nworkspace's owners and admins create keys in the dashboard, under Settings → API keys. A `read` key can\ncall the operations that read; a `write` key can call all of them. A key acts with its creator's current\nrole, and stops working when its creator leaves the workspace. API keys need the Pro plan: on another plan,\nrequests return 403 `feature_not_in_plan`. Keep keys on your servers, never in a browser or an app.\n\n**Ids.** Every id is a typed string, such as `post_01h455vb4pex5vsknk084sn02q`. An id of the wrong kind or\nform returns 400 `validation_failed`; one that doesn't exist, or that you can't see, returns 404 in the path.\n\n**Paging.** Lists take `limit` (1 to 100, 25 by default) and `cursor`, and return\n`{data, next_cursor, has_more}`. While `has_more` is true, pass `next_cursor` as `cursor` to get the\nnext page. A cursor only works for the list it came from, with the same filters (400 `invalid_cursor`\notherwise). Lists don't return totals.\n\n**Errors.** Errors are RFC 9457 problem details (`application/problem+json`), with a stable `code` to\nbranch on and the request's `request_id` (also in the `X-Request-Id` header). For an invalid\nrequest (400), `errors` lists each field at fault, as a JSON `pointer` into the body or a query\n`parameter`, with its own `code`.\n\n**Retries.** Responses include `RateLimit-Policy` and `RateLimit` headers. A 429 includes\n`Retry-After` and `retry_after_seconds`: wait that long before retrying. Retry a 503, and other 5xx\nerrors, with exponential backoff. A POST accepts an `Idempotency-Key` header (1 to 255 visible ASCII\ncharacters, without spaces, such as a UUID). For 24 hours, a retry with the same key and body returns the first response\nagain, marked `Idempotent-Replayed: true`, instead of repeating the change. The same key with a different\nbody returns 422 `idempotency_key_reused`, and a retry while the first request is still running returns 409\n`idempotency_request_in_progress`.",
    "title": "Swingback REST API",
    "version": "0.1.0"
  },
  "openapi": "3.1.0",
  "paths": {
    "/v1/workspaces/{workspace_id}": {
      "get": {
        "description": "Returns the workspace, with its settings and its plan. Once a workspace is deleted, every API\nkey gets 404 for it: only its owners, signed in to the dashboard, can read it then, with\n`deleted_at` and `purge_after` set.\n",
        "operationId": "getWorkspace",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Workspace"
                }
              }
            },
            "description": "The workspace."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Retrieve a workspace",
        "tags": [
          "workspaces"
        ]
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        }
      ]
    },
    "/v1/workspaces/{workspace_id}/assets": {
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        }
      ],
      "post": {
        "description": "The request body is the image file, up to 10 MB: a PNG, JPEG, GIF or WebP image. The type is\nrecognized from the content (415 `unsupported_image` otherwise), and the image can be at most\n16,384 pixels on a side and 25 megapixels, and a GIF at most 500 frames and 100 megapixels across\nthem (422 `image_too_large` otherwise). A file of a known type that can't be read returns 422\n`invalid_image`. The image is re-encoded without its metadata. Attach it within a day, with `asset_ids` on a post or a\ncomment or as a changelog entry's `cover_asset_id`, or it's deleted.\n",
        "operationId": "uploadAsset",
        "requestBody": {
          "content": {
            "image/*": {
              "schema": {
                "format": "binary",
                "type": "string"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Asset"
                }
              }
            },
            "description": "The uploaded asset."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Upload an asset",
        "tags": [
          "assets"
        ]
      }
    },
    "/v1/workspaces/{workspace_id}/assets/{asset_id}": {
      "get": {
        "description": "Returns an uploaded image, attached or not.",
        "operationId": "getAsset",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Asset"
                }
              }
            },
            "description": "The asset."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Retrieve an asset",
        "tags": [
          "assets"
        ]
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        },
        {
          "$ref": "#/components/parameters/AssetIDParam"
        }
      ]
    },
    "/v1/workspaces/{workspace_id}/boards": {
      "get": {
        "description": "Returns the workspace's boards, in order of `position`.",
        "operationId": "listBoards",
        "parameters": [
          {
            "$ref": "#/components/parameters/Deleted"
          },
          {
            "$ref": "#/components/parameters/Limit"
          },
          {
            "$ref": "#/components/parameters/Cursor"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BoardList"
                }
              }
            },
            "description": "A page of boards."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "List boards",
        "tags": [
          "boards"
        ]
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        }
      ],
      "post": {
        "description": "If you send no `slug`, one is made from the name. A slug that another live board uses returns 409\n`slug_taken`. The plan sets how many boards you can have and whether they can be private (403\n`plan_limit_reached` or `feature_not_in_plan`).\n",
        "operationId": "createBoard",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BoardCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Board"
                }
              }
            },
            "description": "The new board."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Create a board",
        "tags": [
          "boards"
        ]
      }
    },
    "/v1/workspaces/{workspace_id}/boards/{board_id}": {
      "delete": {
        "description": "Moves the board and its posts to the trash. They stay there for 30 days, then are deleted for\ngood. Deleting a board that's already in the trash changes nothing.\n",
        "operationId": "deleteBoard",
        "responses": {
          "204": {
            "description": "The board is in the trash."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Delete a board",
        "tags": [
          "boards"
        ]
      },
      "get": {
        "description": "Returns a board, live or in the trash.",
        "operationId": "getBoard",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Board"
                }
              }
            },
            "description": "The board."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Retrieve a board",
        "tags": [
          "boards"
        ]
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        },
        {
          "$ref": "#/components/parameters/BoardIDParam"
        }
      ],
      "patch": {
        "description": "Fields you don't send stay unchanged, and a null `color` removes the color. A board in the trash\nreturns 409 `in_trash`.\n",
        "operationId": "updateBoard",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BoardUpdate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Board"
                }
              }
            },
            "description": "The updated board."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Update a board",
        "tags": [
          "boards"
        ]
      }
    },
    "/v1/workspaces/{workspace_id}/boards/{board_id}/restore": {
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        },
        {
          "$ref": "#/components/parameters/BoardIDParam"
        }
      ],
      "post": {
        "description": "Takes the board and its posts out of the trash. If a live board took its slug in the meantime,\nthe restored board gets a new one. The plan's board limit and private boards apply as when\ncreating a board. Restoring a live board changes nothing.\n",
        "operationId": "restoreBoard",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Board"
                }
              }
            },
            "description": "The restored board."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Restore a board",
        "tags": [
          "boards"
        ]
      }
    },
    "/v1/workspaces/{workspace_id}/changelog": {
      "get": {
        "description": "Returns live entries, or the entries in the trash with `deleted=true`, sorted by the date each one\nshows (when it was published, is scheduled or was created), the most recent first.\n",
        "operationId": "listChangelogEntries",
        "parameters": [
          {
            "description": "Only the entries with any of these statuses. Repeat the parameter for each value.",
            "in": "query",
            "name": "status",
            "schema": {
              "items": {
                "$ref": "#/components/schemas/ChangelogStatus"
              },
              "maxItems": 3,
              "type": "array"
            }
          },
          {
            "description": "Only the entries with any of these tags. Repeat the parameter for each value.",
            "in": "query",
            "name": "tag_id",
            "schema": {
              "items": {
                "$ref": "#/components/schemas/TagID"
              },
              "maxItems": 20,
              "type": "array"
            }
          },
          {
            "$ref": "#/components/parameters/Deleted"
          },
          {
            "$ref": "#/components/parameters/Limit"
          },
          {
            "$ref": "#/components/parameters/Cursor"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ChangelogEntryList"
                }
              }
            },
            "description": "A page of entries."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "List changelog entries",
        "tags": [
          "changelog"
        ]
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        }
      ],
      "post": {
        "description": "Creates the entry as a draft. Its authors, `author_ids`, are team members' account ids\n(`acct_...`): with an API key, the entry has no author unless you name some. To publish or\nschedule the draft, call `publishChangelogEntry`.\n",
        "operationId": "createChangelogEntry",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ChangelogEntryCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ChangelogEntry"
                }
              }
            },
            "description": "The new draft entry."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Create a changelog entry",
        "tags": [
          "changelog"
        ]
      }
    },
    "/v1/workspaces/{workspace_id}/changelog-drafts": {
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        }
      ],
      "post": {
        "description": "Has the model write a title, a summary and a Markdown body from up to 20 live posts and your\nnotes, in the workspace's default language. The draft is written in the background: poll\n`getChangelogDraft` until its `status` is `ready`. A draft is only text for your editor: nothing\nis created or published. Each draft the model answers counts toward the plan's monthly AI drafts (403\n`plan_limit_reached` once they're used up). Drafts are deleted after 7 days.\n",
        "operationId": "createChangelogDraft",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ChangelogDraftCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ChangelogDraft"
                }
              }
            },
            "description": "The draft, while the model writes it."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Create a changelog draft",
        "tags": [
          "ai"
        ]
      }
    },
    "/v1/workspaces/{workspace_id}/changelog-drafts/{changelog_draft_id}": {
      "get": {
        "description": "Returns a changelog draft, with its text once its `status` is `ready`.",
        "operationId": "getChangelogDraft",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ChangelogDraft"
                }
              }
            },
            "description": "The draft."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Retrieve a changelog draft",
        "tags": [
          "ai"
        ]
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        },
        {
          "$ref": "#/components/parameters/ChangelogDraftIDParam"
        }
      ]
    },
    "/v1/workspaces/{workspace_id}/changelog/{changelog_entry_id}": {
      "delete": {
        "description": "Moves the entry to the trash. It stays there for 30 days, then is deleted for good. While it's in\nthe trash, the portal doesn't show it, and a scheduled entry isn't published. Deleting an entry\nthat's already in the trash changes nothing.\n",
        "operationId": "deleteChangelogEntry",
        "responses": {
          "204": {
            "description": "The entry is in the trash."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Delete a changelog entry",
        "tags": [
          "changelog"
        ]
      },
      "get": {
        "description": "Returns a changelog entry, live or in the trash.",
        "operationId": "getChangelogEntry",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ChangelogEntry"
                }
              }
            },
            "description": "The entry."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Retrieve a changelog entry",
        "tags": [
          "changelog"
        ]
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        },
        {
          "$ref": "#/components/parameters/ChangelogEntryIDParam"
        }
      ],
      "patch": {
        "description": "Fields you don't send stay unchanged, and `cover_asset_id: null` removes the cover. A new title\ngives a new slug to an entry that was never published; a published entry keeps its slug. An\nentry in the trash returns 409 `in_trash`.\n",
        "operationId": "updateChangelogEntry",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ChangelogEntryUpdate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ChangelogEntry"
                }
              }
            },
            "description": "The updated entry."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Update a changelog entry",
        "tags": [
          "changelog"
        ]
      }
    },
    "/v1/workspaces/{workspace_id}/changelog/{changelog_entry_id}/publication": {
      "delete": {
        "description": "Returns the entry to draft: a scheduled entry is unscheduled, and a published one leaves the\nportal. Unpublishing a draft changes nothing. An entry in the trash returns 409 `in_trash`:\nrestore it first.\n",
        "operationId": "unpublishChangelogEntry",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ChangelogEntry"
                }
              }
            },
            "description": "The draft entry."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Unpublish a changelog entry",
        "tags": [
          "changelog"
        ]
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        },
        {
          "$ref": "#/components/parameters/ChangelogEntryIDParam"
        }
      ],
      "put": {
        "description": "Without `publish_at`, publishes the entry now. Publishing a published entry again changes\nnothing. With `publish_at`, which must be in the future and within a year, schedules the entry:\nit's published within a minute of that time. Scheduling a published entry returns 409\n`already_published`: unpublish it first. An entry in the trash returns 409 `in_trash`: restore it\nfirst.\n",
        "operationId": "publishChangelogEntry",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ChangelogPublication"
              }
            }
          }
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ChangelogEntry"
                }
              }
            },
            "description": "The published or scheduled entry."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Publish or schedule a changelog entry",
        "tags": [
          "changelog"
        ]
      }
    },
    "/v1/workspaces/{workspace_id}/changelog/{changelog_entry_id}/restore": {
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        },
        {
          "$ref": "#/components/parameters/ChangelogEntryIDParam"
        }
      ],
      "post": {
        "description": "Takes the entry out of the trash as it was: a published entry shows again, and a scheduled one is\npublished when it's due. If a live entry took its slug in the meantime, the restored entry gets a\nnew one. Restoring a live entry changes nothing.\n",
        "operationId": "restoreChangelogEntry",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ChangelogEntry"
                }
              }
            },
            "description": "The restored entry."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Restore a changelog entry",
        "tags": [
          "changelog"
        ]
      }
    },
    "/v1/workspaces/{workspace_id}/comments": {
      "get": {
        "description": "Returns the comments on live posts, internal notes included, newest first, or the comments in\nthe trash with `deleted=true`. The review queue for comments is `moderation_state=held` with\n`sort=oldest`.\n",
        "operationId": "listWorkspaceComments",
        "parameters": [
          {
            "description": "`newest` first (the default), or `oldest` first.",
            "in": "query",
            "name": "sort",
            "schema": {
              "enum": [
                "newest",
                "oldest"
              ],
              "type": "string"
            }
          },
          {
            "description": "Only the comments in any of these moderation states. Repeat the parameter for each value.\n",
            "in": "query",
            "name": "moderation_state",
            "schema": {
              "items": {
                "$ref": "#/components/schemas/ModerationState"
              },
              "maxItems": 3,
              "type": "array"
            }
          },
          {
            "description": "Only the public comments, or only the internal notes.",
            "in": "query",
            "name": "visibility",
            "schema": {
              "$ref": "#/components/schemas/CommentVisibility"
            }
          },
          {
            "$ref": "#/components/parameters/Deleted"
          },
          {
            "$ref": "#/components/parameters/TranslationLanguage"
          },
          {
            "$ref": "#/components/parameters/Limit"
          },
          {
            "$ref": "#/components/parameters/Cursor"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CommentList"
                }
              }
            },
            "description": "A page of comments."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "List comments",
        "tags": [
          "comments",
          "moderation"
        ]
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        }
      ]
    },
    "/v1/workspaces/{workspace_id}/comments/{comment_id}": {
      "delete": {
        "description": "Moves the comment to the trash, and hides its replies with it. It stays there for 30 days, then\nis deleted for good, with its replies. Deleting a comment that's already in the trash changes\nnothing. A comment copied from a GitHub or Linear issue can't be deleted here (409\n`synced_comment`).\n",
        "operationId": "deleteComment",
        "responses": {
          "204": {
            "description": "The comment is in the trash."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Delete a comment",
        "tags": [
          "comments"
        ]
      },
      "get": {
        "description": "Returns a comment, live or in the trash.",
        "operationId": "getComment",
        "parameters": [
          {
            "$ref": "#/components/parameters/TranslationLanguage"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Comment"
                }
              }
            },
            "description": "The comment."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Retrieve a comment",
        "tags": [
          "comments"
        ]
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        },
        {
          "$ref": "#/components/parameters/CommentIDParam"
        }
      ],
      "patch": {
        "description": "Fields you don't send stay unchanged. Whoever edits it, the body is still rendered as its\nauthor's text: in a customer's comment, images don't show and links are marked `nofollow`. A\ncomment in the trash, in a thread in the trash, or on a post in the trash or on a board in the\ntrash returns 409 `in_trash`. A comment copied from a GitHub or Linear issue is read-only (409 `synced_comment`).\n",
        "operationId": "updateComment",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CommentUpdate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Comment"
                }
              }
            },
            "description": "The updated comment."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Update a comment",
        "tags": [
          "comments"
        ]
      }
    },
    "/v1/workspaces/{workspace_id}/comments/{comment_id}/moderation": {
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        },
        {
          "$ref": "#/components/parameters/CommentIDParam"
        }
      ],
      "post": {
        "description": "An approved comment shows in the portal and counts on its post. A rejected comment shows only\nto its author and your team. Internal notes aren't moderated (422 `not_moderatable`).\n",
        "operationId": "moderateComment",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ModerationDecision"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Comment"
                }
              }
            },
            "description": "The moderated comment."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Approve or reject a comment",
        "tags": [
          "moderation"
        ]
      }
    },
    "/v1/workspaces/{workspace_id}/comments/{comment_id}/pin": {
      "delete": {
        "description": "Unpins the comment. A comment in the trash, in a thread in the trash, or on a post or a board in\nthe trash returns 409 `in_trash`. Unpinning a comment that isn't pinned changes nothing.\n",
        "operationId": "unpinComment",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Comment"
                }
              }
            },
            "description": "The unpinned comment."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Unpin a comment",
        "tags": [
          "comments"
        ]
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        },
        {
          "$ref": "#/components/parameters/CommentIDParam"
        }
      ],
      "put": {
        "description": "Pins a public top-level comment on the post it was written on, in place of the post's pinned\ncomment if it has one. Any other comment, including one that shows on the post only through a\nmerge, returns 422 `not_pinnable`. A comment in the trash, in a thread in the trash, or on a post\nor a board in the trash returns 409 `in_trash`. Pinning a pinned comment again changes nothing.\n",
        "operationId": "pinComment",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Comment"
                }
              }
            },
            "description": "The pinned comment."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Pin a comment",
        "tags": [
          "comments"
        ]
      }
    },
    "/v1/workspaces/{workspace_id}/comments/{comment_id}/restore": {
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        },
        {
          "$ref": "#/components/parameters/CommentIDParam"
        }
      ],
      "post": {
        "description": "Takes the comment out of the trash, and its replies show again. A comment on a post in the trash,\nor on a board in the trash, returns 409 `in_trash`. Restoring a live comment changes nothing.\n",
        "operationId": "restoreComment",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Comment"
                }
              }
            },
            "description": "The restored comment."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Restore a comment",
        "tags": [
          "comments"
        ]
      }
    },
    "/v1/workspaces/{workspace_id}/companies": {
      "get": {
        "description": "Returns the workspace's companies, the most valuable first.",
        "operationId": "listCompanies",
        "parameters": [
          {
            "description": "Only the company with this id in your system.",
            "in": "query",
            "name": "external_id",
            "schema": {
              "maxLength": 255,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Limit"
          },
          {
            "$ref": "#/components/parameters/Cursor"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CompanyList"
                }
              }
            },
            "description": "A page of companies."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "List companies",
        "tags": [
          "companies"
        ]
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        }
      ],
      "post": {
        "description": "Finds the company by `external_id` and updates the fields you send. If there's no match, creates\nthe company. A trait value whose type doesn't match the trait's definition returns 400.\n",
        "operationId": "upsertCompany",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CompanyUpsert"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Company"
                }
              }
            },
            "description": "The existing company, updated."
          },
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Company"
                }
              }
            },
            "description": "The new company."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Create or update a company",
        "tags": [
          "companies"
        ]
      }
    },
    "/v1/workspaces/{workspace_id}/companies/{company_id}": {
      "delete": {
        "description": "Its members leave it, and its value no longer counts toward the `customer_value` of the posts\nthey vote for.\n",
        "operationId": "deleteCompany",
        "responses": {
          "204": {
            "description": "The company was deleted."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Delete a company",
        "tags": [
          "companies"
        ]
      },
      "get": {
        "description": "Returns a company, with its value, its traits and how many end users belong to it.",
        "operationId": "getCompany",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Company"
                }
              }
            },
            "description": "The company."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Retrieve a company",
        "tags": [
          "companies"
        ]
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        },
        {
          "$ref": "#/components/parameters/CompanyIDParam"
        }
      ]
    },
    "/v1/workspaces/{workspace_id}/end-users": {
      "get": {
        "description": "Returns the workspace's end users, newest first.",
        "operationId": "listEndUsers",
        "parameters": [
          {
            "description": "Matches part of the name, the email or the external id, ignoring case.",
            "in": "query",
            "name": "q",
            "schema": {
              "maxLength": 100,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "description": "Only the members of this company.",
            "in": "query",
            "name": "company_id",
            "schema": {
              "$ref": "#/components/schemas/CompanyID"
            }
          },
          {
            "$ref": "#/components/parameters/Limit"
          },
          {
            "$ref": "#/components/parameters/Cursor"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EndUserList"
                }
              }
            },
            "description": "A page of end users."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "List end users",
        "tags": [
          "end-users"
        ]
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        }
      ],
      "post": {
        "description": "Finds the customer by `external_id`, else by `email`, and updates the fields you send. If there's\nno match, creates the customer, with its traits and companies. An email that belongs to another\ncustomer returns 409 `end_user_conflict`. A trait value whose type doesn't match the trait's\ndefinition returns 400.\n",
        "operationId": "upsertEndUser",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EndUserUpsert"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EndUser"
                }
              }
            },
            "description": "The existing customer, updated."
          },
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EndUser"
                }
              }
            },
            "description": "The new customer."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Create or update an end user",
        "tags": [
          "end-users"
        ]
      }
    },
    "/v1/workspaces/{workspace_id}/end-users/{end_user_id}": {
      "delete": {
        "description": "Clears the email, name, avatar, external id and traits of a customer or a guest, and deletes\ntheir sessions, sign-in identities, follows, company memberships, notifications, email\npreferences, pending emails and Slack links. What they wrote, voted for and liked stays,\nanonymously. A team member's end user returns 422 `cannot_erase_team`:\nremove the member from the team instead. Erasing an end user again changes nothing.\n",
        "operationId": "eraseEndUser",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EndUser"
                }
              }
            },
            "description": "The erased end user."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Erase an end user's personal data",
        "tags": [
          "end-users"
        ]
      },
      "get": {
        "description": "Returns an end user of any kind, banned or erased ones included.",
        "operationId": "getEndUser",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EndUser"
                }
              }
            },
            "description": "The end user."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Retrieve an end user",
        "tags": [
          "end-users"
        ]
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        },
        {
          "$ref": "#/components/parameters/EndUserIDParam"
        }
      ]
    },
    "/v1/workspaces/{workspace_id}/end-users/{end_user_id}/ban": {
      "delete": {
        "description": "Lifts the ban, so the end user can write in the portal again. Unbanning again changes nothing.",
        "operationId": "unbanEndUser",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EndUser"
                }
              }
            },
            "description": "The unbanned end user."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Unban an end user",
        "tags": [
          "moderation"
        ]
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        },
        {
          "$ref": "#/components/parameters/EndUserIDParam"
        }
      ],
      "put": {
        "description": "A banned end user can still read the portal, but everything they write there (posts, comments,\nvotes, follows, likes and uploads) returns 403 `banned`. A team member can't be banned (422\n`cannot_ban_team`). Banning an end user again changes nothing.\n",
        "operationId": "banEndUser",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EndUser"
                }
              }
            },
            "description": "The banned end user."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Ban an end user",
        "tags": [
          "moderation"
        ]
      }
    },
    "/v1/workspaces/{workspace_id}/end-users/{end_user_id}/export": {
      "get": {
        "description": "Returns what Swingback keeps about an end user, for a data subject access request: their\nprofile, traits and companies; what they wrote, voted for and liked; their follows, notifications\nand email preferences; and their sessions and sign-in methods.\n",
        "operationId": "exportEndUser",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EndUserExport"
                }
              }
            },
            "description": "The end user's data."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Export an end user's data",
        "tags": [
          "end-users"
        ]
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        },
        {
          "$ref": "#/components/parameters/EndUserIDParam"
        }
      ]
    },
    "/v1/workspaces/{workspace_id}/members": {
      "get": {
        "description": "Returns the workspace's team members, the earliest to join first.",
        "operationId": "listMembers",
        "parameters": [
          {
            "$ref": "#/components/parameters/Limit"
          },
          {
            "$ref": "#/components/parameters/Cursor"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MemberList"
                }
              }
            },
            "description": "A page of members."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "List members",
        "tags": [
          "members"
        ]
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        }
      ]
    },
    "/v1/workspaces/{workspace_id}/merge-suggestions": {
      "get": {
        "description": "Returns the pairs of posts that the model took for duplicates, newest first, when the workspace\nturns on `ai_duplicates`. A pending suggestion is listed only while neither of its posts is in\nthe trash or merged; a post on a board in the trash still counts, and accepting its suggestion\nreturns 409 `in_trash`.\n",
        "operationId": "listMergeSuggestions",
        "parameters": [
          {
            "description": "Only the suggestions with this status. Defaults to `pending`.",
            "in": "query",
            "name": "status",
            "schema": {
              "enum": [
                "pending",
                "accepted",
                "dismissed"
              ],
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Limit"
          },
          {
            "$ref": "#/components/parameters/Cursor"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MergeSuggestionList"
                }
              }
            },
            "description": "A page of suggestions."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "List merge suggestions",
        "tags": [
          "ai"
        ]
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        }
      ]
    },
    "/v1/workspaces/{workspace_id}/merge-suggestions/{merge_suggestion_id}/accept": {
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        },
        {
          "$ref": "#/components/parameters/MergeSuggestionIDParam"
        }
      ],
      "post": {
        "description": "Merges the suggestion's `post` into its `similar_post`, as `mergePost` does, then marks the\nsuggestion accepted. A suggestion that was already accepted or dismissed returns 409\n`suggestion_decided`.\n",
        "operationId": "acceptMergeSuggestion",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MergeSuggestion"
                }
              }
            },
            "description": "The accepted suggestion."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Accept a merge suggestion",
        "tags": [
          "ai"
        ]
      }
    },
    "/v1/workspaces/{workspace_id}/merge-suggestions/{merge_suggestion_id}/dismiss": {
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        },
        {
          "$ref": "#/components/parameters/MergeSuggestionIDParam"
        }
      ],
      "post": {
        "description": "Dismisses the suggestion, so the pair isn't suggested again. A suggestion that was already\naccepted or dismissed returns 409 `suggestion_decided`.\n",
        "operationId": "dismissMergeSuggestion",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MergeSuggestion"
                }
              }
            },
            "description": "The dismissed suggestion."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Dismiss a merge suggestion",
        "tags": [
          "ai"
        ]
      }
    },
    "/v1/workspaces/{workspace_id}/posts": {
      "get": {
        "description": "Returns live posts, or the posts in the trash with `deleted=true`. Merged posts are left out,\nand so are the posts on a board in the trash, unless they're in the trash themselves: restore the\nboard to list them.\nEvery sort ends on the id, so posts with equal values keep one order. A post whose value changes\nwhile you page, such as a new vote under `top`, can repeat or be skipped. `q` searches titles and bodies in the\nworkspace's language, forgives accents and typos in titles, and sorts by relevance. A search\nreturns at most 1,000 results.\n",
        "operationId": "listPosts",
        "parameters": [
          {
            "description": "Defaults to `newest`, or to `relevance` with `q`. A search can only sort by `relevance`, and\n`relevance` needs `q`.\n",
            "in": "query",
            "name": "sort",
            "schema": {
              "$ref": "#/components/schemas/PostSort"
            }
          },
          {
            "description": "The words to search for.",
            "in": "query",
            "name": "q",
            "schema": {
              "maxLength": 200,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "description": "Only the posts on this board.",
            "in": "query",
            "name": "board_id",
            "schema": {
              "$ref": "#/components/schemas/BoardID"
            }
          },
          {
            "description": "Only the posts with any of these statuses. Repeat the parameter for each value.",
            "in": "query",
            "name": "status",
            "schema": {
              "items": {
                "$ref": "#/components/schemas/PostStatus"
              },
              "maxItems": 6,
              "type": "array"
            }
          },
          {
            "description": "Only the posts with any of these tags. Repeat the parameter for each value.",
            "in": "query",
            "name": "tag_id",
            "schema": {
              "items": {
                "$ref": "#/components/schemas/TagID"
              },
              "maxItems": 20,
              "type": "array"
            }
          },
          {
            "description": "Only the posts by this end user.",
            "in": "query",
            "name": "author_id",
            "schema": {
              "$ref": "#/components/schemas/EndUserID"
            }
          },
          {
            "description": "Only the posts that members of this company vote for.",
            "in": "query",
            "name": "company_id",
            "schema": {
              "$ref": "#/components/schemas/CompanyID"
            }
          },
          {
            "description": "Only the public posts, or only the private ones.",
            "in": "query",
            "name": "visibility",
            "schema": {
              "$ref": "#/components/schemas/Visibility"
            }
          },
          {
            "description": "Only the posts in any of these moderation states. Repeat the parameter for each value.\n",
            "in": "query",
            "name": "moderation_state",
            "schema": {
              "items": {
                "$ref": "#/components/schemas/ModerationState"
              },
              "maxItems": 3,
              "type": "array"
            }
          },
          {
            "$ref": "#/components/parameters/Deleted"
          },
          {
            "$ref": "#/components/parameters/Limit"
          },
          {
            "$ref": "#/components/parameters/Cursor"
          },
          {
            "$ref": "#/components/parameters/TranslationLanguage"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PostList"
                }
              }
            },
            "description": "A page of posts."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "List posts",
        "tags": [
          "posts"
        ]
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        }
      ],
      "post": {
        "description": "With an API key, `author` is required: it names the customer the post is from, who is created if\nnew. The author follows the post.\n",
        "operationId": "createPost",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PostCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Post"
                }
              }
            },
            "description": "The new post."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Create a post",
        "tags": [
          "posts"
        ]
      }
    },
    "/v1/workspaces/{workspace_id}/posts/{post_id}": {
      "delete": {
        "description": "Moves the post to the trash. It stays there for 30 days, then is deleted for good. Deleting a\npost that's already in the trash changes nothing.\n",
        "operationId": "deletePost",
        "responses": {
          "204": {
            "description": "The post is in the trash."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Delete a post",
        "tags": [
          "posts"
        ]
      },
      "get": {
        "description": "Returns a post, live or in the trash.",
        "operationId": "getPost",
        "parameters": [
          {
            "$ref": "#/components/parameters/TranslationLanguage"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Post"
                }
              }
            },
            "description": "The post."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Retrieve a post",
        "tags": [
          "posts"
        ]
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        },
        {
          "$ref": "#/components/parameters/PostIDParam"
        }
      ],
      "patch": {
        "description": "Fields you don't send stay unchanged. A new title gives the post a new slug, and the old slug\nstill leads to the post. A post in the trash, or on a board in the trash, returns 409\n`in_trash`.\n",
        "operationId": "updatePost",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PostUpdate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Post"
                }
              }
            },
            "description": "The updated post."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Update a post",
        "tags": [
          "posts"
        ]
      }
    },
    "/v1/workspaces/{workspace_id}/posts/{post_id}/activity": {
      "get": {
        "description": "Returns the post's timeline, oldest first: its live comments, internal notes included, and its\nstatus changes.\n",
        "operationId": "listPostActivity",
        "parameters": [
          {
            "$ref": "#/components/parameters/TranslationLanguage"
          },
          {
            "$ref": "#/components/parameters/Limit"
          },
          {
            "$ref": "#/components/parameters/Cursor"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ActivityList"
                }
              }
            },
            "description": "A page of the post's activity."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "List a post's activity",
        "tags": [
          "comments"
        ]
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        },
        {
          "$ref": "#/components/parameters/PostIDParam"
        }
      ]
    },
    "/v1/workspaces/{workspace_id}/posts/{post_id}/comments": {
      "get": {
        "description": "Returns the post's live comments, internal notes included, oldest first, or its comments in the\ntrash with `deleted=true`. A reply names its comment in `parent_id`. A reply is hidden while its\nparent is in the trash.\n",
        "operationId": "listComments",
        "parameters": [
          {
            "description": "Only the public comments, or only the internal notes.",
            "in": "query",
            "name": "visibility",
            "schema": {
              "$ref": "#/components/schemas/CommentVisibility"
            }
          },
          {
            "$ref": "#/components/parameters/Pinned"
          },
          {
            "$ref": "#/components/parameters/Deleted"
          },
          {
            "$ref": "#/components/parameters/TranslationLanguage"
          },
          {
            "$ref": "#/components/parameters/Limit"
          },
          {
            "$ref": "#/components/parameters/Cursor"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CommentList"
                }
              }
            },
            "description": "A page of comments."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "List a post's comments",
        "tags": [
          "comments"
        ]
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        },
        {
          "$ref": "#/components/parameters/PostIDParam"
        }
      ],
      "post": {
        "description": "Adds a comment to the post. With an API key, `author` is required: it names the end user who\ncomments, who is created if new. Authors of public comments follow the post.\n\n`visibility: internal` makes an internal note, which only your team sees. Its `author` must be\na team member's end user, or the request fails validation with `not_team` on `author`. A reply\n(`parent_id`) answers a top-level comment, since replies have no replies of their own\n(`not_top_level` on `parent_id`). A reply to an internal note is internal: asking for `public`\nfails with `internal_parent` on `visibility`.\n",
        "operationId": "createComment",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CommentCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Comment"
                }
              }
            },
            "description": "The new comment."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Create a comment",
        "tags": [
          "comments"
        ]
      }
    },
    "/v1/workspaces/{workspace_id}/posts/{post_id}/issue-links": {
      "get": {
        "description": "Returns the post's links to GitHub or Linear issues, oldest first, including the links of the\nposts merged into it. Each link has its destination and, once the issue exists, the issue as its\ntracker describes it. An issue's `status` is the post status its state maps to, under its\nconnection's settings. Only members create links, in the dashboard: API keys can read them.\n",
        "operationId": "listPostIssueLinks",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IssueLinkList"
                }
              }
            },
            "description": "The post's issue links."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "List a post's issue links",
        "tags": [
          "posts"
        ]
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        },
        {
          "$ref": "#/components/parameters/PostIDParam"
        }
      ]
    },
    "/v1/workspaces/{workspace_id}/posts/{post_id}/merge": {
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        },
        {
          "$ref": "#/components/parameters/PostIDParam"
        }
      ],
      "post": {
        "description": "Merges the post into another post, the target. The votes and comments of the post, and of the\nposts already merged into it, then count and show on the target. An end user who voted for both\nposts counts once, from their earliest vote. Followers stay on their own post.\n\nThe merged post is read-only (409 `merged`) until it's unmerged, and the portal shows the target\nin its place. Neither post can be merged already (409 `merged`, 422 `merge_target_merged`), or be\nin the trash or on a board in the trash (409 `in_trash`). A target that doesn't exist, and a post\nmerged into itself, return 400 `validation_failed`, with `not_found` or `same_post` on\n`into_post_id`.\n",
        "operationId": "mergePost",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PostMerge"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Post"
                }
              }
            },
            "description": "The target post."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Merge a post",
        "tags": [
          "posts"
        ]
      }
    },
    "/v1/workspaces/{workspace_id}/posts/{post_id}/moderation": {
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        },
        {
          "$ref": "#/components/parameters/PostIDParam"
        }
      ],
      "post": {
        "description": "An approved post shows in the portal. A rejected post shows only to its author and your team.\nEither decision resolves the post's `moderation_flags`. Making the same decision again changes\nnothing.\n",
        "operationId": "moderatePost",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ModerationDecision"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Post"
                }
              }
            },
            "description": "The moderated post."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Approve or reject a post",
        "tags": [
          "moderation"
        ]
      }
    },
    "/v1/workspaces/{workspace_id}/posts/{post_id}/restore": {
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        },
        {
          "$ref": "#/components/parameters/PostIDParam"
        }
      ],
      "post": {
        "description": "Takes the post out of the trash. If a live post took its slug in the meantime, the restored post\ngets a new one. Restoring a live post changes nothing.\n",
        "operationId": "restorePost",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Post"
                }
              }
            },
            "description": "The restored post."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Restore a post",
        "tags": [
          "posts"
        ]
      }
    },
    "/v1/workspaces/{workspace_id}/posts/{post_id}/status": {
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        },
        {
          "$ref": "#/components/parameters/PostIDParam"
        }
      ],
      "post": {
        "description": "Records the change, and the optional note, in the post's history. Setting the status the post\nalready has changes nothing, unless you send a note: then it returns 422 `status_unchanged`.\n\nA few seconds later, the post's linked GitHub or Linear issues follow the new status, unless you\nsend `sync_issues: false` or their connection doesn't send statuses to issues. With one issue, the issue follows the post forward or back; with\nseveral, they only move forward. If the workspace's routing rules create issues automatically, a\npost that reaches their status also gets the issues they name.\n",
        "operationId": "setPostStatus",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PostStatusUpdate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Post"
                }
              }
            },
            "description": "The updated post."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Change a post's status",
        "tags": [
          "posts"
        ]
      }
    },
    "/v1/workspaces/{workspace_id}/posts/{post_id}/status-changes": {
      "get": {
        "description": "Returns the post's status history, newest first.",
        "operationId": "listPostStatusChanges",
        "parameters": [
          {
            "$ref": "#/components/parameters/Limit"
          },
          {
            "$ref": "#/components/parameters/Cursor"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StatusChangeList"
                }
              }
            },
            "description": "A page of status changes."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "List a post's status changes",
        "tags": [
          "posts"
        ]
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        },
        {
          "$ref": "#/components/parameters/PostIDParam"
        }
      ]
    },
    "/v1/workspaces/{workspace_id}/posts/{post_id}/subscribers": {
      "get": {
        "description": "Returns the end users who follow the post, the earliest first.",
        "operationId": "listSubscribers",
        "parameters": [
          {
            "$ref": "#/components/parameters/Limit"
          },
          {
            "$ref": "#/components/parameters/Cursor"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SubscriberList"
                }
              }
            },
            "description": "A page of subscribers."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "List a post's subscribers",
        "tags": [
          "subscribers"
        ]
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        },
        {
          "$ref": "#/components/parameters/PostIDParam"
        }
      ],
      "post": {
        "description": "Makes an end user follow the post. With an API key, `end_user` is required: it names the\ncustomer who follows, who is created if new. This undoes an earlier unfollow.\n",
        "operationId": "createSubscriber",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SubscriberCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Subscriber"
                }
              }
            },
            "description": "The end user already followed the post."
          },
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Subscriber"
                }
              }
            },
            "description": "The end user now follows the post."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Add a subscriber",
        "tags": [
          "subscribers"
        ]
      }
    },
    "/v1/workspaces/{workspace_id}/posts/{post_id}/subscribers/{end_user_id}": {
      "delete": {
        "description": "Makes the end user unfollow the post. The unfollow sticks: voting or commenting later doesn't\nmake them follow the post again.\n",
        "operationId": "deleteSubscriber",
        "responses": {
          "204": {
            "description": "The end user no longer follows the post."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Remove a subscriber",
        "tags": [
          "subscribers"
        ]
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        },
        {
          "$ref": "#/components/parameters/PostIDParam"
        },
        {
          "$ref": "#/components/parameters/EndUserIDParam"
        }
      ]
    },
    "/v1/workspaces/{workspace_id}/posts/{post_id}/tags": {
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        },
        {
          "$ref": "#/components/parameters/PostIDParam"
        }
      ],
      "put": {
        "description": "Sets the post's tags to exactly the ones you send. An empty list removes them all.",
        "operationId": "setPostTags",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PostTagsUpdate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Post"
                }
              }
            },
            "description": "The updated post."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Replace a post's tags",
        "tags": [
          "posts"
        ]
      }
    },
    "/v1/workspaces/{workspace_id}/posts/{post_id}/unmerge": {
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        },
        {
          "$ref": "#/components/parameters/PostIDParam"
        }
      ],
      "post": {
        "description": "Takes a merged post out of the post it was merged into. Its votes and comments, and those of\nthe posts merged into it, count on it again, exactly as before the merge. If the post its votes\ncount on now, the last one in its chain of merges, is in the trash or on a board in the trash,\nrestore that one first (409 `in_trash`). Unmerging a post that isn't merged changes nothing.\n",
        "operationId": "unmergePost",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Post"
                }
              }
            },
            "description": "The unmerged post."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Unmerge a post",
        "tags": [
          "posts"
        ]
      }
    },
    "/v1/workspaces/{workspace_id}/posts/{post_id}/votes": {
      "get": {
        "description": "Returns the post's votes, newest first.",
        "operationId": "listVotes",
        "parameters": [
          {
            "$ref": "#/components/parameters/Limit"
          },
          {
            "$ref": "#/components/parameters/Cursor"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoteList"
                }
              }
            },
            "description": "A page of votes."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "List a post's votes",
        "tags": [
          "votes"
        ]
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        },
        {
          "$ref": "#/components/parameters/PostIDParam"
        }
      ],
      "post": {
        "description": "Adds a vote to the post. With an API key, `end_user` is required: it names the customer who\nvotes, who is created if new. The voter follows the post, unless they unfollowed it before. If\nthe end user already voted for the post, returns their existing vote with 200.\n",
        "operationId": "createVote",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VoteCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Vote"
                }
              }
            },
            "description": "The end user's existing vote."
          },
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Vote"
                }
              }
            },
            "description": "The new vote."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Create a vote",
        "tags": [
          "votes"
        ]
      }
    },
    "/v1/workspaces/{workspace_id}/posts/{post_id}/votes/{vote_id}": {
      "delete": {
        "description": "Removes the vote from the post.",
        "operationId": "deleteVote",
        "responses": {
          "204": {
            "description": "The vote was deleted."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Delete a vote",
        "tags": [
          "votes"
        ]
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        },
        {
          "$ref": "#/components/parameters/PostIDParam"
        },
        {
          "$ref": "#/components/parameters/VoteIDParam"
        }
      ]
    },
    "/v1/workspaces/{workspace_id}/roadmap": {
      "get": {
        "description": "Returns a column for each status, all six by default, each with the first page of its posts:\nlive, not merged, on every board. In `completed` and `closed`, the posts whose status changed\nmost recently come first; the other columns sort by votes. To page through a column, pass its\n`next_cursor` to `listRoadmapColumn`.\n",
        "operationId": "getRoadmap",
        "parameters": [
          {
            "description": "Only these columns. Repeat the parameter for each value.",
            "in": "query",
            "name": "status",
            "schema": {
              "items": {
                "$ref": "#/components/schemas/PostStatus"
              },
              "maxItems": 6,
              "type": "array"
            }
          },
          {
            "description": "Only the posts on this board.",
            "in": "query",
            "name": "board_id",
            "schema": {
              "$ref": "#/components/schemas/BoardID"
            }
          },
          {
            "description": "Only the posts with any of these tags. Repeat the parameter for each value.",
            "in": "query",
            "name": "tag_id",
            "schema": {
              "items": {
                "$ref": "#/components/schemas/TagID"
              },
              "maxItems": 20,
              "type": "array"
            }
          },
          {
            "$ref": "#/components/parameters/Limit"
          },
          {
            "$ref": "#/components/parameters/TranslationLanguage"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Roadmap"
                }
              }
            },
            "description": "The columns, in the order of the statuses."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Retrieve the roadmap",
        "tags": [
          "roadmap"
        ]
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        }
      ]
    },
    "/v1/workspaces/{workspace_id}/roadmap/{status}": {
      "get": {
        "description": "Returns a page of the posts in one column of the roadmap, sorted as `getRoadmap` sorts them. To\ncontinue a column that `getRoadmap` returned, pass its `next_cursor` as `cursor`, with the same\nfilters.\n",
        "operationId": "listRoadmapColumn",
        "parameters": [
          {
            "description": "Only the posts on this board.",
            "in": "query",
            "name": "board_id",
            "schema": {
              "$ref": "#/components/schemas/BoardID"
            }
          },
          {
            "description": "Only the posts with any of these tags. Repeat the parameter for each value.",
            "in": "query",
            "name": "tag_id",
            "schema": {
              "items": {
                "$ref": "#/components/schemas/TagID"
              },
              "maxItems": 20,
              "type": "array"
            }
          },
          {
            "$ref": "#/components/parameters/Limit"
          },
          {
            "$ref": "#/components/parameters/Cursor"
          },
          {
            "$ref": "#/components/parameters/TranslationLanguage"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PostList"
                }
              }
            },
            "description": "A page of posts."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "List a roadmap column's posts",
        "tags": [
          "roadmap"
        ]
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        },
        {
          "description": "The column's status.",
          "in": "path",
          "name": "status",
          "required": true,
          "schema": {
            "$ref": "#/components/schemas/PostStatus"
          }
        }
      ]
    },
    "/v1/workspaces/{workspace_id}/stats": {
      "get": {
        "description": "Returns the totals that lists don't give: posts, posts by status, votes, boards and end users.\nEach field says what it counts.\n",
        "operationId": "getStats",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Stats"
                }
              }
            },
            "description": "The counts."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Retrieve workspace stats",
        "tags": [
          "stats"
        ]
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        }
      ]
    },
    "/v1/workspaces/{workspace_id}/tags": {
      "get": {
        "description": "Returns the workspace's tags, sorted by name.",
        "operationId": "listTags",
        "parameters": [
          {
            "description": "Only the tags of this scope.",
            "in": "query",
            "name": "scope",
            "schema": {
              "$ref": "#/components/schemas/TagScope"
            }
          },
          {
            "$ref": "#/components/parameters/Limit"
          },
          {
            "$ref": "#/components/parameters/Cursor"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TagList"
                }
              }
            },
            "description": "A page of tags."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "List tags",
        "tags": [
          "tags"
        ]
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        }
      ],
      "post": {
        "description": "Names are unique within a scope, ignoring case: a name that's taken returns 409\n`tag_name_taken`.\n",
        "operationId": "createTag",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TagCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Tag"
                }
              }
            },
            "description": "The new tag."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Create a tag",
        "tags": [
          "tags"
        ]
      }
    },
    "/v1/workspaces/{workspace_id}/tags/{tag_id}": {
      "delete": {
        "description": "Removes the tag from every post or changelog entry it labels.",
        "operationId": "deleteTag",
        "responses": {
          "204": {
            "description": "The tag was deleted."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Delete a tag",
        "tags": [
          "tags"
        ]
      },
      "get": {
        "description": "Returns a tag, for posts or for changelog entries.",
        "operationId": "getTag",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Tag"
                }
              }
            },
            "description": "The tag."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Retrieve a tag",
        "tags": [
          "tags"
        ]
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        },
        {
          "$ref": "#/components/parameters/TagIDParam"
        }
      ],
      "patch": {
        "description": "Renames or recolors a tag. Fields you don't send stay unchanged, and a null `color` removes the\ncolor.\n",
        "operationId": "updateTag",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TagUpdate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Tag"
                }
              }
            },
            "description": "The updated tag."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Update a tag",
        "tags": [
          "tags"
        ]
      }
    },
    "/v1/workspaces/{workspace_id}/traits": {
      "get": {
        "description": "Returns the trait definitions, sorted by subject, then key, in a single page: a workspace has at\nmost 50 per subject.\n",
        "operationId": "listTraits",
        "parameters": [
          {
            "description": "Only the traits of end users, or only those of companies. Both by default.",
            "in": "query",
            "name": "subject",
            "schema": {
              "$ref": "#/components/schemas/TraitSubject"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TraitDefinitionList"
                }
              }
            },
            "description": "The trait definitions."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "List traits",
        "tags": [
          "traits"
        ]
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        }
      ],
      "post": {
        "description": "Defines a key before any value is sent for it. This is how a trait gets the type `date`. A key\nthat's already defined returns 409 `trait_defined`: to change its type, delete the trait first.\n",
        "operationId": "defineTrait",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TraitDefinitionCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TraitDefinition"
                }
              }
            },
            "description": "The new trait definition."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Define a trait",
        "tags": [
          "traits"
        ]
      }
    },
    "/v1/workspaces/{workspace_id}/traits/{trait_id}": {
      "delete": {
        "description": "Deletes the trait's definition and every value of it.",
        "operationId": "deleteTrait",
        "responses": {
          "204": {
            "description": "The trait and its values were deleted."
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "summary": "Delete a trait",
        "tags": [
          "traits"
        ]
      },
      "parameters": [
        {
          "$ref": "#/components/parameters/WorkspaceIDParam"
        },
        {
          "$ref": "#/components/parameters/TraitIDParam"
        }
      ]
    }
  },
  "servers": [
    {
      "url": "https://api.swingback.dev"
    }
  ],
  "tags": [
    {
      "description": "Workspaces, with their settings and plan. A workspace the caller doesn't belong to returns 404,\nand an API key sees only its own workspace.\n",
      "name": "workspaces"
    },
    {
      "description": "The workspace's team members and their roles. Owners manage roles, and a workspace always has at\nleast one owner.\n",
      "name": "members"
    },
    {
      "description": "The people who give feedback: customers (kind `user`), found by their id in your system\n(`external_id`) or by email; team members acting as themselves (kind `team`); and guests (kind\n`guest`). Customers have typed traits and belong to companies. Erasing an end user clears their\npersonal data and keeps what they wrote and voted for, anonymously.\n",
      "name": "end-users"
    },
    {
      "description": "Your customers' organizations, found by their id in your system (`external_id`). A company's\n`value` is what it's worth to you, such as its monthly revenue in cents. A post's\n`customer_value` adds up the values of the distinct companies whose members vote for it.\n",
      "name": "companies"
    },
    {
      "description": "Typed attributes of end users and companies: `string`, `number`, `boolean` or `date`. The first\nvalue sent for a new key defines its type, and later values must have that type. A workspace has\nat most 50 traits per subject.\n",
      "name": "traits"
    },
    {
      "description": "Boards group posts, and are public or private. A deleted board stays in the trash with its posts\nfor 30 days, and can be restored until then.\n",
      "name": "boards"
    },
    {
      "description": "Tags label posts or changelog entries, as their `scope` says.",
      "name": "tags"
    },
    {
      "description": "The feedback itself: a title and a Markdown body on a board, with a status and its history, tags\nand votes. A deleted post stays in the trash for 30 days, and can be restored until then.\n",
      "name": "posts"
    },
    {
      "description": "Votes for posts. An end user can vote for a post once.",
      "name": "votes"
    },
    {
      "description": "The end users who hear about a post's updates. A post's author, voters and commenters follow it\nautomatically, and others follow it by choice. An unfollow sticks.\n",
      "name": "subscribers"
    },
    {
      "description": "Comments on posts, with one level of replies, and your team's internal notes, which the portal\nnever shows. A post has at most one pinned comment. A deleted comment stays in the trash for 30\ndays, with its replies hidden, and can be restored until then.\n",
      "name": "comments"
    },
    {
      "description": "Uploaded images, attached to posts and comments (at most 4 each) or used as a changelog entry's\ncover. Uploads are re-encoded without their metadata, and an upload that's still attached to\nnothing after a day is deleted.\n",
      "name": "assets"
    },
    {
      "description": "What end users write in the portal can wait for your team's review: it's held, with the reasons\nin `moderation_flags`, until someone approves or rejects it. The review queues are `listPosts` and\n`listWorkspaceComments` with `moderation_state=held`. Banned end users can read the portal but\ncan't write in it.\n",
      "name": "moderation"
    },
    {
      "description": "The roadmap shows posts by status, in a column for each status. The team's roadmap has every\nstatus on every board. The portal's roadmap shows only `planned`, `in_progress` and `completed`,\non the boards you put on the roadmap.\n",
      "name": "roadmap"
    },
    {
      "description": "Your team's announcements: drafts, scheduled entries and published ones. A scheduled entry is\npublished within a minute of its time. The portal shows published entries, with the linked posts\neach reader can see. A whispered entry is published quietly: it's never announced or marked\nunread.\n",
      "name": "changelog"
    },
    {
      "description": "Totals, which lists don't return.",
      "name": "stats"
    },
    {
      "description": "AI features, which owners and admins turn on one at a time (`ai_tagging`, `ai_duplicates`,\n`ai_moderation`, `ai_translation`, and `ai_routing` in the issue routing settings). Jev, from\nTypeSafe AI, tags new posts, finds duplicates and moderates what the public writes. Claude, from\nAnthropic, translates posts and comments, writes drafts and suggests where issues go, and answers\nwhen Jev doesn't. A workspace's content goes to them only while a feature is on, or when a member\nasks for a draft, a suggestion or a backfill.\n\nThe model only picks among the options it's given. It adds tags (and never removes them),\nsuggests merges (a person decides), holds what the public writes (a moderator decides), suggests\nwhere a post's issue could go (a member creates the issue), and drafts changelog entries and\nissues (nothing publishes or creates them).\n\nA plan counts two things a month (UTC). `ai_reads` counts the posts and comments the model reads:\nonce each, whatever it does with them (tags, duplicates, moderation, translation, where an issue\ncould go), and once more each time it reads one again, after an edit or a second request.\n`ai_drafts` counts what the model writes on request: a changelog entry, an issue, a post from a\nSlack message or an import's column mapping. A call that fails doesn't count. Similar posts and\nduplicate candidates are found with embeddings that Swingback computes on its own servers, which\nno plan counts.\n",
      "name": "ai"
    }
  ],
  "webhooks": {
    "changelog_entry.published": {
      "post": {
        "parameters": [
          {
            "description": "The message's id, which is the event's id: the same on every attempt and replay. Deduplicate on it.",
            "in": "header",
            "name": "webhook-id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "The attempt's time, in Unix seconds.",
            "in": "header",
            "name": "webhook-timestamp",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "`v1,` followed by the base64 HMAC-SHA256 of `id.timestamp.body`. During a secret rotation, two signatures, separated by a space.",
            "in": "header",
            "name": "webhook-signature",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WebhookChangelogEntryMessage"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Return any 2xx within 15 seconds to accept the message. A 410 Gone turns the endpoint off; anything else is retried."
          }
        },
        "summary": "A changelog entry was published."
      }
    },
    "changelog_entry.unpublished": {
      "post": {
        "parameters": [
          {
            "description": "The message's id, which is the event's id: the same on every attempt and replay. Deduplicate on it.",
            "in": "header",
            "name": "webhook-id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "The attempt's time, in Unix seconds.",
            "in": "header",
            "name": "webhook-timestamp",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "`v1,` followed by the base64 HMAC-SHA256 of `id.timestamp.body`. During a secret rotation, two signatures, separated by a space.",
            "in": "header",
            "name": "webhook-signature",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WebhookChangelogEntryMessage"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Return any 2xx within 15 seconds to accept the message. A 410 Gone turns the endpoint off; anything else is retried."
          }
        },
        "summary": "A published changelog entry went back to draft."
      }
    },
    "comment.approved": {
      "post": {
        "parameters": [
          {
            "description": "The message's id, which is the event's id: the same on every attempt and replay. Deduplicate on it.",
            "in": "header",
            "name": "webhook-id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "The attempt's time, in Unix seconds.",
            "in": "header",
            "name": "webhook-timestamp",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "`v1,` followed by the base64 HMAC-SHA256 of `id.timestamp.body`. During a secret rotation, two signatures, separated by a space.",
            "in": "header",
            "name": "webhook-signature",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WebhookCommentMessage"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Return any 2xx within 15 seconds to accept the message. A 410 Gone turns the endpoint off; anything else is retried."
          }
        },
        "summary": "A held or rejected comment was approved."
      }
    },
    "comment.created": {
      "post": {
        "parameters": [
          {
            "description": "The message's id, which is the event's id: the same on every attempt and replay. Deduplicate on it.",
            "in": "header",
            "name": "webhook-id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "The attempt's time, in Unix seconds.",
            "in": "header",
            "name": "webhook-timestamp",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "`v1,` followed by the base64 HMAC-SHA256 of `id.timestamp.body`. During a secret rotation, two signatures, separated by a space.",
            "in": "header",
            "name": "webhook-signature",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WebhookCommentMessage"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Return any 2xx within 15 seconds to accept the message. A 410 Gone turns the endpoint off; anything else is retried."
          }
        },
        "summary": "A public comment was created."
      }
    },
    "comment.deleted": {
      "post": {
        "parameters": [
          {
            "description": "The message's id, which is the event's id: the same on every attempt and replay. Deduplicate on it.",
            "in": "header",
            "name": "webhook-id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "The attempt's time, in Unix seconds.",
            "in": "header",
            "name": "webhook-timestamp",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "`v1,` followed by the base64 HMAC-SHA256 of `id.timestamp.body`. During a secret rotation, two signatures, separated by a space.",
            "in": "header",
            "name": "webhook-signature",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WebhookCommentMessage"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Return any 2xx within 15 seconds to accept the message. A 410 Gone turns the endpoint off; anything else is retried."
          }
        },
        "summary": "A public comment was moved to the trash, or, for one published from an issue, deleted for good."
      }
    },
    "comment.held": {
      "post": {
        "parameters": [
          {
            "description": "The message's id, which is the event's id: the same on every attempt and replay. Deduplicate on it.",
            "in": "header",
            "name": "webhook-id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "The attempt's time, in Unix seconds.",
            "in": "header",
            "name": "webhook-timestamp",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "`v1,` followed by the base64 HMAC-SHA256 of `id.timestamp.body`. During a secret rotation, two signatures, separated by a space.",
            "in": "header",
            "name": "webhook-signature",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WebhookCommentMessage"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Return any 2xx within 15 seconds to accept the message. A 410 Gone turns the endpoint off; anything else is retried."
          }
        },
        "summary": "An approved comment was held for review."
      }
    },
    "comment.rejected": {
      "post": {
        "parameters": [
          {
            "description": "The message's id, which is the event's id: the same on every attempt and replay. Deduplicate on it.",
            "in": "header",
            "name": "webhook-id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "The attempt's time, in Unix seconds.",
            "in": "header",
            "name": "webhook-timestamp",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "`v1,` followed by the base64 HMAC-SHA256 of `id.timestamp.body`. During a secret rotation, two signatures, separated by a space.",
            "in": "header",
            "name": "webhook-signature",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WebhookCommentMessage"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Return any 2xx within 15 seconds to accept the message. A 410 Gone turns the endpoint off; anything else is retried."
          }
        },
        "summary": "A comment was rejected."
      }
    },
    "comment.restored": {
      "post": {
        "parameters": [
          {
            "description": "The message's id, which is the event's id: the same on every attempt and replay. Deduplicate on it.",
            "in": "header",
            "name": "webhook-id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "The attempt's time, in Unix seconds.",
            "in": "header",
            "name": "webhook-timestamp",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "`v1,` followed by the base64 HMAC-SHA256 of `id.timestamp.body`. During a secret rotation, two signatures, separated by a space.",
            "in": "header",
            "name": "webhook-signature",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WebhookCommentMessage"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Return any 2xx within 15 seconds to accept the message. A 410 Gone turns the endpoint off; anything else is retried."
          }
        },
        "summary": "A public comment was restored from the trash."
      }
    },
    "comment.updated": {
      "post": {
        "parameters": [
          {
            "description": "The message's id, which is the event's id: the same on every attempt and replay. Deduplicate on it.",
            "in": "header",
            "name": "webhook-id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "The attempt's time, in Unix seconds.",
            "in": "header",
            "name": "webhook-timestamp",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "`v1,` followed by the base64 HMAC-SHA256 of `id.timestamp.body`. During a secret rotation, two signatures, separated by a space.",
            "in": "header",
            "name": "webhook-signature",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WebhookCommentMessage"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Return any 2xx within 15 seconds to accept the message. A 410 Gone turns the endpoint off; anything else is retried."
          }
        },
        "summary": "A public comment's text or attachments changed."
      }
    },
    "post.approved": {
      "post": {
        "parameters": [
          {
            "description": "The message's id, which is the event's id: the same on every attempt and replay. Deduplicate on it.",
            "in": "header",
            "name": "webhook-id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "The attempt's time, in Unix seconds.",
            "in": "header",
            "name": "webhook-timestamp",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "`v1,` followed by the base64 HMAC-SHA256 of `id.timestamp.body`. During a secret rotation, two signatures, separated by a space.",
            "in": "header",
            "name": "webhook-signature",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WebhookPostMessage"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Return any 2xx within 15 seconds to accept the message. A 410 Gone turns the endpoint off; anything else is retried."
          }
        },
        "summary": "A held or rejected post was approved."
      }
    },
    "post.created": {
      "post": {
        "parameters": [
          {
            "description": "The message's id, which is the event's id: the same on every attempt and replay. Deduplicate on it.",
            "in": "header",
            "name": "webhook-id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "The attempt's time, in Unix seconds.",
            "in": "header",
            "name": "webhook-timestamp",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "`v1,` followed by the base64 HMAC-SHA256 of `id.timestamp.body`. During a secret rotation, two signatures, separated by a space.",
            "in": "header",
            "name": "webhook-signature",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WebhookPostMessage"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Return any 2xx within 15 seconds to accept the message. A 410 Gone turns the endpoint off; anything else is retried."
          }
        },
        "summary": "A post was created."
      }
    },
    "post.deleted": {
      "post": {
        "parameters": [
          {
            "description": "The message's id, which is the event's id: the same on every attempt and replay. Deduplicate on it.",
            "in": "header",
            "name": "webhook-id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "The attempt's time, in Unix seconds.",
            "in": "header",
            "name": "webhook-timestamp",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "`v1,` followed by the base64 HMAC-SHA256 of `id.timestamp.body`. During a secret rotation, two signatures, separated by a space.",
            "in": "header",
            "name": "webhook-signature",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WebhookPostMessage"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Return any 2xx within 15 seconds to accept the message. A 410 Gone turns the endpoint off; anything else is retried."
          }
        },
        "summary": "A post was moved to the trash."
      }
    },
    "post.held": {
      "post": {
        "parameters": [
          {
            "description": "The message's id, which is the event's id: the same on every attempt and replay. Deduplicate on it.",
            "in": "header",
            "name": "webhook-id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "The attempt's time, in Unix seconds.",
            "in": "header",
            "name": "webhook-timestamp",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "`v1,` followed by the base64 HMAC-SHA256 of `id.timestamp.body`. During a secret rotation, two signatures, separated by a space.",
            "in": "header",
            "name": "webhook-signature",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WebhookPostMessage"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Return any 2xx within 15 seconds to accept the message. A 410 Gone turns the endpoint off; anything else is retried."
          }
        },
        "summary": "An approved post was held for review."
      }
    },
    "post.merged": {
      "post": {
        "parameters": [
          {
            "description": "The message's id, which is the event's id: the same on every attempt and replay. Deduplicate on it.",
            "in": "header",
            "name": "webhook-id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "The attempt's time, in Unix seconds.",
            "in": "header",
            "name": "webhook-timestamp",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "`v1,` followed by the base64 HMAC-SHA256 of `id.timestamp.body`. During a secret rotation, two signatures, separated by a space.",
            "in": "header",
            "name": "webhook-signature",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WebhookPostMessage"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Return any 2xx within 15 seconds to accept the message. A 410 Gone turns the endpoint off; anything else is retried."
          }
        },
        "summary": "A post was merged into another."
      }
    },
    "post.rejected": {
      "post": {
        "parameters": [
          {
            "description": "The message's id, which is the event's id: the same on every attempt and replay. Deduplicate on it.",
            "in": "header",
            "name": "webhook-id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "The attempt's time, in Unix seconds.",
            "in": "header",
            "name": "webhook-timestamp",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "`v1,` followed by the base64 HMAC-SHA256 of `id.timestamp.body`. During a secret rotation, two signatures, separated by a space.",
            "in": "header",
            "name": "webhook-signature",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WebhookPostMessage"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Return any 2xx within 15 seconds to accept the message. A 410 Gone turns the endpoint off; anything else is retried."
          }
        },
        "summary": "A post was rejected."
      }
    },
    "post.restored": {
      "post": {
        "parameters": [
          {
            "description": "The message's id, which is the event's id: the same on every attempt and replay. Deduplicate on it.",
            "in": "header",
            "name": "webhook-id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "The attempt's time, in Unix seconds.",
            "in": "header",
            "name": "webhook-timestamp",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "`v1,` followed by the base64 HMAC-SHA256 of `id.timestamp.body`. During a secret rotation, two signatures, separated by a space.",
            "in": "header",
            "name": "webhook-signature",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WebhookPostMessage"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Return any 2xx within 15 seconds to accept the message. A 410 Gone turns the endpoint off; anything else is retried."
          }
        },
        "summary": "A post was restored from the trash."
      }
    },
    "post.status_changed": {
      "post": {
        "parameters": [
          {
            "description": "The message's id, which is the event's id: the same on every attempt and replay. Deduplicate on it.",
            "in": "header",
            "name": "webhook-id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "The attempt's time, in Unix seconds.",
            "in": "header",
            "name": "webhook-timestamp",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "`v1,` followed by the base64 HMAC-SHA256 of `id.timestamp.body`. During a secret rotation, two signatures, separated by a space.",
            "in": "header",
            "name": "webhook-signature",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WebhookPostMessage"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Return any 2xx within 15 seconds to accept the message. A 410 Gone turns the endpoint off; anything else is retried."
          }
        },
        "summary": "A post's status changed."
      }
    },
    "post.tags_changed": {
      "post": {
        "parameters": [
          {
            "description": "The message's id, which is the event's id: the same on every attempt and replay. Deduplicate on it.",
            "in": "header",
            "name": "webhook-id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "The attempt's time, in Unix seconds.",
            "in": "header",
            "name": "webhook-timestamp",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "`v1,` followed by the base64 HMAC-SHA256 of `id.timestamp.body`. During a secret rotation, two signatures, separated by a space.",
            "in": "header",
            "name": "webhook-signature",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WebhookPostMessage"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Return any 2xx within 15 seconds to accept the message. A 410 Gone turns the endpoint off; anything else is retried."
          }
        },
        "summary": "A post's tags changed."
      }
    },
    "post.unmerged": {
      "post": {
        "parameters": [
          {
            "description": "The message's id, which is the event's id: the same on every attempt and replay. Deduplicate on it.",
            "in": "header",
            "name": "webhook-id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "The attempt's time, in Unix seconds.",
            "in": "header",
            "name": "webhook-timestamp",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "`v1,` followed by the base64 HMAC-SHA256 of `id.timestamp.body`. During a secret rotation, two signatures, separated by a space.",
            "in": "header",
            "name": "webhook-signature",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WebhookPostMessage"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Return any 2xx within 15 seconds to accept the message. A 410 Gone turns the endpoint off; anything else is retried."
          }
        },
        "summary": "A merged post was unmerged."
      }
    },
    "post.updated": {
      "post": {
        "parameters": [
          {
            "description": "The message's id, which is the event's id: the same on every attempt and replay. Deduplicate on it.",
            "in": "header",
            "name": "webhook-id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "The attempt's time, in Unix seconds.",
            "in": "header",
            "name": "webhook-timestamp",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "`v1,` followed by the base64 HMAC-SHA256 of `id.timestamp.body`. During a secret rotation, two signatures, separated by a space.",
            "in": "header",
            "name": "webhook-signature",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WebhookPostMessage"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Return any 2xx within 15 seconds to accept the message. A 410 Gone turns the endpoint off; anything else is retried."
          }
        },
        "summary": "A post's title, text, board, visibility or attachments changed."
      }
    },
    "vote.created": {
      "post": {
        "parameters": [
          {
            "description": "The message's id, which is the event's id: the same on every attempt and replay. Deduplicate on it.",
            "in": "header",
            "name": "webhook-id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "The attempt's time, in Unix seconds.",
            "in": "header",
            "name": "webhook-timestamp",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "`v1,` followed by the base64 HMAC-SHA256 of `id.timestamp.body`. During a secret rotation, two signatures, separated by a space.",
            "in": "header",
            "name": "webhook-signature",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WebhookVoteMessage"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Return any 2xx within 15 seconds to accept the message. A 410 Gone turns the endpoint off; anything else is retried."
          }
        },
        "summary": "An end user voted for a post."
      }
    },
    "vote.deleted": {
      "post": {
        "parameters": [
          {
            "description": "The message's id, which is the event's id: the same on every attempt and replay. Deduplicate on it.",
            "in": "header",
            "name": "webhook-id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "The attempt's time, in Unix seconds.",
            "in": "header",
            "name": "webhook-timestamp",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "`v1,` followed by the base64 HMAC-SHA256 of `id.timestamp.body`. During a secret rotation, two signatures, separated by a space.",
            "in": "header",
            "name": "webhook-signature",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WebhookVoteMessage"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Return any 2xx within 15 seconds to accept the message. A 410 Gone turns the endpoint off; anything else is retried."
          }
        },
        "summary": "An end user's vote was removed."
      }
    },
    "webhook.test": {
      "post": {
        "parameters": [
          {
            "description": "The message's id, which is the event's id: the same on every attempt and replay. Deduplicate on it.",
            "in": "header",
            "name": "webhook-id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "The attempt's time, in Unix seconds.",
            "in": "header",
            "name": "webhook-timestamp",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "`v1,` followed by the base64 HMAC-SHA256 of `id.timestamp.body`. During a secret rotation, two signatures, separated by a space.",
            "in": "header",
            "name": "webhook-signature",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WebhookMessage"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Return any 2xx within 15 seconds to accept the test. A test is tried once: it is never retried, and never turns the endpoint off, a 410 Gone included."
          }
        },
        "summary": "A test message your team sent from the dashboard."
      }
    }
  }
}
