{
  "openapi": "3.1.1",
  "info": {
    "title": "Blazot API",
    "description": "Read Blazot's public content: users, Sites (Blazot's business accounts), the transmissions they publish, hashtags, hubs, events, catalogs and classified ads. Times are UTC (ISO 8601 with a trailing `Z`), except event start and end times, which are the Site's local time. Get an access token from `/v2/auth/token` with your API key and secret, then send it as a bearer token. Call the API from your server, never from a web page: it allows no cross-origin requests, and your secret must stay private.",
    "termsOfService": "https://developers.blazot.com/terms",
    "contact": {
      "name": "Blazot developer support",
      "url": "https://developers.blazot.com/support"
    },
    "version": "2.0"
  },
  "servers": [
    {
      "url": "https://api.blazot.com",
      "description": "Production"
    }
  ],
  "paths": {
    "/v2/auth/token": {
      "get": {
        "tags": [
          "Authentication"
        ],
        "summary": "An access token for your API key.",
        "description": "Send your key in the `x-api-key` header and its secret in `x-secret-auth-key`. Use the token as a bearer token on every other call, and reuse it for `expiresIn` seconds: this call has its own small rate limit. A problem with the key, the secret or the account is a 401 with the detail \"Invalid API credentials.\"; the detail \"Account is unavailable.\" means the key and secret are right but the account can't use the API right now (for example a payment is past due).",
        "operationId": "authentication.getToken",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Token"
                }
              }
            }
          },
          "401": {
            "description": "The key, the secret or the account can't be used; see the problem's `detail`.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests for your rate limit. Wait for `Retry-After` before trying again.",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Requests allowed in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the window resets, as a Unix time in seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error. Quote the problem's `correlationId` to support.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "security": [
          {
            "apiKey": [],
            "apiSecret": []
          }
        ]
      }
    },
    "/v2/classifieds/ads/{adId}": {
      "get": {
        "tags": [
          "Classifieds"
        ],
        "summary": "One classified ad.",
        "description": "A 404 when the ad doesn't exist, hasn't been approved yet, was removed or its owner's account isn't available. Sold and expired ads are still returned: check `sold` and `expires`.",
        "operationId": "classifieds.getAd",
        "parameters": [
          {
            "name": "adId",
            "in": "path",
            "description": "The ad's id.",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ClassifiedAd"
                }
              }
            }
          },
          "401": {
            "description": "The token is missing, expired or no longer valid, or the account can't use the API; see the problem's `detail`.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not found, or not visible to you.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests for your rate limit. Wait for `Retry-After` before trying again.",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Requests allowed in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the window resets, as a Unix time in seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error. Quote the problem's `correlationId` to support.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v2/classifieds/categories": {
      "get": {
        "tags": [
          "Classifieds"
        ],
        "summary": "The top-level classifieds categories.",
        "description": "Ads are filed in bottom-level categories (`isBottomLevel`): list a category's subcategories with `/v2/classifieds/categories/{categoryId}/subcategories` until you reach them.",
        "operationId": "classifieds.listCategories",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ClassifiedCategory"
                  }
                }
              }
            }
          },
          "401": {
            "description": "The token is missing, expired or no longer valid, or the account can't use the API; see the problem's `detail`.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests for your rate limit. Wait for `Retry-After` before trying again.",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Requests allowed in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the window resets, as a Unix time in seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error. Quote the problem's `correlationId` to support.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v2/classifieds/categories/{categoryId}/ads": {
      "get": {
        "tags": [
          "Classifieds"
        ],
        "summary": "A page of a category's classified ads, newest first.",
        "description": "Approved ads that haven't expired; sold ones are included. This list has no polling.",
        "operationId": "classifieds.listAdsInCategory",
        "parameters": [
          {
            "name": "categoryId",
            "in": "path",
            "description": "The category's id.",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "A previous page's `nextCursor`, to fetch the next (older) page.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "take",
            "in": "query",
            "description": "Items per page, 1–100 (default 20).",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ClassifiedAdCursorPage"
                }
              }
            }
          },
          "400": {
            "description": "The request isn't valid, for example a bad cursor or parameter value.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "The token is missing, expired or no longer valid, or the account can't use the API; see the problem's `detail`.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests for your rate limit. Wait for `Retry-After` before trying again.",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Requests allowed in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the window resets, as a Unix time in seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error. Quote the problem's `correlationId` to support.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v2/classifieds/categories/{categoryId}/subcategories": {
      "get": {
        "tags": [
          "Classifieds"
        ],
        "summary": "The subcategories of a classifieds category.",
        "description": "An empty list for a bottom-level category, which holds ads instead. A 404 when there's no such category.",
        "operationId": "classifieds.listSubcategories",
        "parameters": [
          {
            "name": "categoryId",
            "in": "path",
            "description": "The category's id.",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ClassifiedCategory"
                  }
                }
              }
            }
          },
          "401": {
            "description": "The token is missing, expired or no longer valid, or the account can't use the API; see the problem's `detail`.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not found, or not visible to you.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests for your rate limit. Wait for `Retry-After` before trying again.",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Requests allowed in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the window resets, as a Unix time in seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error. Quote the problem's `correlationId` to support.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v2/emoticons": {
      "get": {
        "tags": [
          "Emoticons"
        ],
        "summary": "The full emoticon set.",
        "operationId": "emoticons.listEmoticons",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Emoticon"
                  }
                }
              }
            }
          },
          "401": {
            "description": "The token is missing, expired or no longer valid, or the account can't use the API; see the problem's `detail`.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests for your rate limit. Wait for `Retry-After` before trying again.",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Requests allowed in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the window resets, as a Unix time in seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error. Quote the problem's `correlationId` to support.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v2/hashtags/transmissions": {
      "get": {
        "tags": [
          "Hashtags"
        ],
        "summary": "The transmissions with any of several hashtags, newest first.",
        "description": "A transmission with several of the hashtags appears once. Page back with `cursor`, or poll for new transmissions with `newerThan`.",
        "operationId": "hashtags.listTransmissionsForTags",
        "parameters": [
          {
            "name": "tag",
            "in": "query",
            "description": "1 to 10 hashtags: repeat the `tag` parameter for each one. A leading `#` is allowed (URL-encoded as `%23`).",
            "required": true,
            "schema": {
              "maxItems": 10,
              "minItems": 1,
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "A previous page's `nextCursor`, to fetch the next (older) page.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "newerThan",
            "in": "query",
            "description": "A previous response's `newestCursor`, to fetch the new transmissions since then (polling). Not with `cursor`.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "take",
            "in": "query",
            "description": "Items per page, 1–25 (default 20).",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TransmissionCursorPage"
                }
              }
            }
          },
          "400": {
            "description": "The request isn't valid, for example a bad cursor or parameter value.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "The token is missing, expired or no longer valid, or the account can't use the API; see the problem's `detail`.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests for your rate limit. Wait for `Retry-After` before trying again.",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Requests allowed in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the window resets, as a Unix time in seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error. Quote the problem's `correlationId` to support.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v2/hashtags/{tag}/transmissions": {
      "get": {
        "tags": [
          "Hashtags"
        ],
        "summary": "The transmissions with a hashtag, newest first.",
        "description": "Page back with `cursor`, or poll for new transmissions with `newerThan`. A hashtag nobody has used gives an empty page; a 404 only when the tag is blank (for example just `#`).",
        "operationId": "hashtags.listTransmissions",
        "parameters": [
          {
            "name": "tag",
            "in": "path",
            "description": "The hashtag. A leading `#` is allowed (URL-encoded as `%23`).",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "A previous page's `nextCursor`, to fetch the next (older) page.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "take",
            "in": "query",
            "description": "Items per page, 1–25 (default 20).",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "newerThan",
            "in": "query",
            "description": "A previous response's `newestCursor`, to fetch the new transmissions since then (polling). Not with `cursor`.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TransmissionCursorPage"
                }
              }
            }
          },
          "400": {
            "description": "The request isn't valid, for example a bad cursor or parameter value.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "The token is missing, expired or no longer valid, or the account can't use the API; see the problem's `detail`.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not found, or not visible to you.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests for your rate limit. Wait for `Retry-After` before trying again.",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Requests allowed in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the window resets, as a Unix time in seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error. Quote the problem's `correlationId` to support.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v2/hubs/categories": {
      "get": {
        "tags": [
          "Hubs"
        ],
        "summary": "The hub categories.",
        "operationId": "hubs.listCategories",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/HubCategory"
                  }
                }
              }
            }
          },
          "401": {
            "description": "The token is missing, expired or no longer valid, or the account can't use the API; see the problem's `detail`.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests for your rate limit. Wait for `Retry-After` before trying again.",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Requests allowed in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the window resets, as a Unix time in seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error. Quote the problem's `correlationId` to support.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v2/hubs/categories/{categoryId}/hubs": {
      "get": {
        "tags": [
          "Hubs"
        ],
        "summary": "A page of the hubs in one category.",
        "description": "The order is stable, so paging is consistent, but it isn't by date.",
        "operationId": "hubs.listHubsInCategory",
        "parameters": [
          {
            "name": "categoryId",
            "in": "path",
            "description": "The category's id.",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "The page number, from 1 (at most 1000).",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "description": "Items per page, 1–100 (default 20).",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HubSummaryOffsetPage"
                }
              }
            }
          },
          "400": {
            "description": "The request isn't valid, for example a bad cursor or parameter value.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "The token is missing, expired or no longer valid, or the account can't use the API; see the problem's `detail`.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests for your rate limit. Wait for `Retry-After` before trying again.",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Requests allowed in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the window resets, as a Unix time in seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error. Quote the problem's `correlationId` to support.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v2/hubs/{hubName}": {
      "get": {
        "tags": [
          "Hubs"
        ],
        "summary": "One hub's public details.",
        "description": "A 404 when there's no such hub or it isn't available.",
        "operationId": "hubs.getHub",
        "parameters": [
          {
            "name": "hubName",
            "in": "path",
            "description": "The hub's name.",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Hub"
                }
              }
            }
          },
          "401": {
            "description": "The token is missing, expired or no longer valid, or the account can't use the API; see the problem's `detail`.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not found, or not visible to you.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests for your rate limit. Wait for `Retry-After` before trying again.",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Requests allowed in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the window resets, as a Unix time in seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error. Quote the problem's `correlationId` to support.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v2/hubs/{hubName}/members": {
      "get": {
        "tags": [
          "Hubs"
        ],
        "summary": "A page of a hub's approved members.",
        "description": "Only the hub's approved members and its admins can see its members; anyone else gets a 404, including someone whose request to join is still waiting. The hub's details stay readable to everyone.",
        "operationId": "hubs.listMembers",
        "parameters": [
          {
            "name": "hubName",
            "in": "path",
            "description": "The hub's name.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "The page number, from 1 (at most 1000).",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "description": "Items per page, 1–100 (default 20).",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProfileSummaryOffsetPage"
                }
              }
            }
          },
          "400": {
            "description": "The request isn't valid, for example a bad cursor or parameter value.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "The token is missing, expired or no longer valid, or the account can't use the API; see the problem's `detail`.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not found, or not visible to you.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests for your rate limit. Wait for `Retry-After` before trying again.",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Requests allowed in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the window resets, as a Unix time in seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error. Quote the problem's `correlationId` to support.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v2/hubs/{hubName}/transmissions": {
      "get": {
        "tags": [
          "Hubs"
        ],
        "summary": "A page of a hub's transmissions, newest first.",
        "description": "A public hub's transmissions are visible to everyone; a private hub's only to its approved members (anyone else gets a 404, an admin who hasn't joined included). This feed has no polling.",
        "operationId": "hubs.listTransmissions",
        "parameters": [
          {
            "name": "hubName",
            "in": "path",
            "description": "The hub's name.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "A previous page's `nextCursor`, to fetch the next (older) page.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "take",
            "in": "query",
            "description": "Items per page, 1–25 (default 20).",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TransmissionCursorPage"
                }
              }
            }
          },
          "400": {
            "description": "The request isn't valid, for example a bad cursor or parameter value.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "The token is missing, expired or no longer valid, or the account can't use the API; see the problem's `detail`.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not found, or not visible to you.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests for your rate limit. Wait for `Retry-After` before trying again.",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Requests allowed in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the window resets, as a Unix time in seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error. Quote the problem's `correlationId` to support.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v2/meta": {
      "get": {
        "tags": [
          "Meta"
        ],
        "summary": "The API's name, version and status.",
        "description": "Needs no token and isn't rate-limited, so it also serves as a health check.",
        "operationId": "meta.getMeta",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Meta"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error. Quote the problem's `correlationId` to support.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v2/search/hashtags": {
      "get": {
        "tags": [
          "Search"
        ],
        "summary": "The hashtags that match a search term.",
        "description": "At most 10 results.",
        "operationId": "search.searchHashtags",
        "parameters": [
          {
            "name": "term",
            "in": "query",
            "description": "2 to 200 characters. A leading `#` is ignored.",
            "required": true,
            "schema": {
              "maxLength": 200,
              "minLength": 2,
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Hashtag"
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request isn't valid, for example a bad cursor or parameter value.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "The token is missing, expired or no longer valid, or the account can't use the API; see the problem's `detail`.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests for your rate limit. Wait for `Retry-After` before trying again.",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Requests allowed in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the window resets, as a Unix time in seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error. Quote the problem's `correlationId` to support.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v2/search/users": {
      "get": {
        "tags": [
          "Search"
        ],
        "summary": "The users whose username matches a search term.",
        "description": "At most 10 results. Accounts that aren't available are left out.",
        "operationId": "search.searchUsers",
        "parameters": [
          {
            "name": "term",
            "in": "query",
            "description": "2 to 200 characters.",
            "required": true,
            "schema": {
              "maxLength": 200,
              "minLength": 2,
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ProfileSummary"
                  }
                }
              }
            }
          },
          "400": {
            "description": "The request isn't valid, for example a bad cursor or parameter value.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "The token is missing, expired or no longer valid, or the account can't use the API; see the problem's `detail`.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests for your rate limit. Wait for `Retry-After` before trying again.",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Requests allowed in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the window resets, as a Unix time in seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error. Quote the problem's `correlationId` to support.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v2/sites/{siteName}": {
      "get": {
        "tags": [
          "Sites"
        ],
        "summary": "A Site's public profile.",
        "description": "A 404 when there's no such Site or it isn't available.",
        "operationId": "sites.getProfile",
        "parameters": [
          {
            "name": "siteName",
            "in": "path",
            "description": "The Site's name (its handle).",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SiteProfile"
                }
              }
            }
          },
          "401": {
            "description": "The token is missing, expired or no longer valid, or the account can't use the API; see the problem's `detail`.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not found, or not visible to you.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests for your rate limit. Wait for `Retry-After` before trying again.",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Requests allowed in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the window resets, as a Unix time in seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error. Quote the problem's `correlationId` to support.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v2/sites/{siteName}/catalog": {
      "get": {
        "tags": [
          "Catalog"
        ],
        "summary": "A Site's catalog home: its categories plus featured and recent products.",
        "description": "A 404 when the Site or its catalog isn't available.",
        "operationId": "catalog.getHome",
        "parameters": [
          {
            "name": "siteName",
            "in": "path",
            "description": "The Site's name (its handle).",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CatalogHome"
                }
              }
            }
          },
          "401": {
            "description": "The token is missing, expired or no longer valid, or the account can't use the API; see the problem's `detail`.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not found, or not visible to you.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests for your rate limit. Wait for `Retry-After` before trying again.",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Requests allowed in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the window resets, as a Unix time in seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error. Quote the problem's `correlationId` to support.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v2/sites/{siteName}/catalog/categories/{categoryId}": {
      "get": {
        "tags": [
          "Catalog"
        ],
        "summary": "A page of the products in one category of a Site's catalog.",
        "description": "A 404 when the Site, its catalog or the category isn't available, or the page is past the last one.",
        "operationId": "catalog.getCategory",
        "parameters": [
          {
            "name": "siteName",
            "in": "path",
            "description": "The Site's name (its handle).",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "categoryId",
            "in": "path",
            "description": "The category's id.",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "The page number, from 1. Pages hold 30 products, up to 34 pages (a higher number is read as 34).",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CatalogCategoryPage"
                }
              }
            }
          },
          "400": {
            "description": "The request isn't valid, for example a bad cursor or parameter value.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "The token is missing, expired or no longer valid, or the account can't use the API; see the problem's `detail`.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not found, or not visible to you.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests for your rate limit. Wait for `Retry-After` before trying again.",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Requests allowed in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the window resets, as a Unix time in seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error. Quote the problem's `correlationId` to support.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v2/sites/{siteName}/catalog/products/{productId}": {
      "get": {
        "tags": [
          "Catalog"
        ],
        "summary": "One product in a Site's catalog.",
        "description": "A 404 when the product isn't in this Site's catalog.",
        "operationId": "catalog.getProduct",
        "parameters": [
          {
            "name": "siteName",
            "in": "path",
            "description": "The Site's name (its handle).",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "productId",
            "in": "path",
            "description": "The product's id.",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductDetail"
                }
              }
            }
          },
          "401": {
            "description": "The token is missing, expired or no longer valid, or the account can't use the API; see the problem's `detail`.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not found, or not visible to you.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests for your rate limit. Wait for `Retry-After` before trying again.",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Requests allowed in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the window resets, as a Unix time in seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error. Quote the problem's `correlationId` to support.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v2/sites/{siteName}/events": {
      "get": {
        "tags": [
          "Events"
        ],
        "summary": "A page of a Site's events in one year.",
        "description": "One year at a time, never all years: use `/events/years` to find the years that have events. Ordered by start date. A year without events gives an empty page. A 404 when there's no such Site or it isn't available.",
        "operationId": "events.listEvents",
        "parameters": [
          {
            "name": "siteName",
            "in": "path",
            "description": "The Site's name (its handle).",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "year",
            "in": "query",
            "description": "The year. Without it: the current year, or, if the current year has none, the latest year that has events (which can be a future year).",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "The page number, from 1 (at most 1000).",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "description": "Items per page, 1–100 (default 20).",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventSummaryOffsetPage"
                }
              }
            }
          },
          "400": {
            "description": "The request isn't valid, for example a bad cursor or parameter value.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "The token is missing, expired or no longer valid, or the account can't use the API; see the problem's `detail`.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not found, or not visible to you.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests for your rate limit. Wait for `Retry-After` before trying again.",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Requests allowed in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the window resets, as a Unix time in seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error. Quote the problem's `correlationId` to support.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v2/sites/{siteName}/events/years": {
      "get": {
        "tags": [
          "Events"
        ],
        "summary": "The years in which a Site has events.",
        "description": "A 404 when there's no such Site or it isn't available.",
        "operationId": "events.listYears",
        "parameters": [
          {
            "name": "siteName",
            "in": "path",
            "description": "The Site's name (its handle).",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "integer",
                    "format": "int32"
                  }
                }
              }
            }
          },
          "401": {
            "description": "The token is missing, expired or no longer valid, or the account can't use the API; see the problem's `detail`.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not found, or not visible to you.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests for your rate limit. Wait for `Retry-After` before trying again.",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Requests allowed in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the window resets, as a Unix time in seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error. Quote the problem's `correlationId` to support.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v2/sites/{siteName}/events/{eventId}": {
      "get": {
        "tags": [
          "Events"
        ],
        "summary": "One of a Site's events.",
        "description": "A 404 when the event doesn't exist or isn't this Site's.",
        "operationId": "events.getEvent",
        "parameters": [
          {
            "name": "siteName",
            "in": "path",
            "description": "The Site's name (its handle).",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "eventId",
            "in": "path",
            "description": "The event's id.",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Event"
                }
              }
            }
          },
          "401": {
            "description": "The token is missing, expired or no longer valid, or the account can't use the API; see the problem's `detail`.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not found, or not visible to you.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests for your rate limit. Wait for `Retry-After` before trying again.",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Requests allowed in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the window resets, as a Unix time in seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error. Quote the problem's `correlationId` to support.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v2/sites/{siteName}/transmissions": {
      "get": {
        "tags": [
          "Sites"
        ],
        "summary": "A Site's transmissions, newest first.",
        "description": "Originals, responses and relays. Page back with `cursor`, or poll for new transmissions with `newerThan`. A 404 when there's no such Site or it isn't available.",
        "operationId": "sites.listTransmissions",
        "parameters": [
          {
            "name": "siteName",
            "in": "path",
            "description": "The Site's name (its handle).",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "A previous page's `nextCursor`, to fetch the next (older) page.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "newerThan",
            "in": "query",
            "description": "A previous response's `newestCursor`, to fetch the new transmissions since then (polling). Not with `cursor`.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "take",
            "in": "query",
            "description": "Items per page, 1–25 (default 20).",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "includeRelays",
            "in": "query",
            "description": "Include relays (default true).",
            "schema": {
              "type": "boolean",
              "default": true
            }
          },
          {
            "name": "includeHubTransmissions",
            "in": "query",
            "description": "Your own Site's timeline only (with the Site's key): include its hub transmissions (default false). On any other timeline it's a 403.",
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TransmissionCursorPage"
                }
              }
            }
          },
          "400": {
            "description": "The request isn't valid, for example a bad cursor or parameter value.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "The token is missing, expired or no longer valid, or the account can't use the API; see the problem's `detail`.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Not allowed for you, for example hub transmissions on someone else's timeline.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not found, or not visible to you.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests for your rate limit. Wait for `Retry-After` before trying again.",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Requests allowed in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the window resets, as a Unix time in seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error. Quote the problem's `correlationId` to support.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v2/transmissions/{transmissionId}": {
      "get": {
        "tags": [
          "Transmissions"
        ],
        "summary": "One transmission.",
        "description": "A 404 when it doesn't exist or you can't see it, for example in a private hub you aren't an approved member of.",
        "operationId": "transmissions.getTransmission",
        "parameters": [
          {
            "name": "transmissionId",
            "in": "path",
            "description": "The transmission's id.",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Transmission"
                }
              }
            }
          },
          "401": {
            "description": "The token is missing, expired or no longer valid, or the account can't use the API; see the problem's `detail`.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not found, or not visible to you.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests for your rate limit. Wait for `Retry-After` before trying again.",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Requests allowed in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the window resets, as a Unix time in seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error. Quote the problem's `correlationId` to support.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v2/users/{username}": {
      "get": {
        "tags": [
          "Users"
        ],
        "summary": "A user's public profile.",
        "description": "A 404 when there's no such user or the account isn't available.",
        "operationId": "users.getProfile",
        "parameters": [
          {
            "name": "username",
            "in": "path",
            "description": "The user's username.",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserProfile"
                }
              }
            }
          },
          "401": {
            "description": "The token is missing, expired or no longer valid, or the account can't use the API; see the problem's `detail`.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not found, or not visible to you.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests for your rate limit. Wait for `Retry-After` before trying again.",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Requests allowed in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the window resets, as a Unix time in seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error. Quote the problem's `correlationId` to support.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v2/users/{username}/followers": {
      "get": {
        "tags": [
          "Users"
        ],
        "summary": "A page of the accounts that follow a user.",
        "description": "A 404 when there's no such user or the account isn't available.",
        "operationId": "users.listFollowers",
        "parameters": [
          {
            "name": "username",
            "in": "path",
            "description": "The user's username.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "The page number, from 1 (at most 1000).",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "description": "Items per page, 1–100 (default 20).",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProfileSummaryOffsetPage"
                }
              }
            }
          },
          "400": {
            "description": "The request isn't valid, for example a bad cursor or parameter value.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "The token is missing, expired or no longer valid, or the account can't use the API; see the problem's `detail`.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not found, or not visible to you.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests for your rate limit. Wait for `Retry-After` before trying again.",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Requests allowed in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the window resets, as a Unix time in seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error. Quote the problem's `correlationId` to support.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v2/users/{username}/following": {
      "get": {
        "tags": [
          "Users"
        ],
        "summary": "A page of the accounts a user follows.",
        "description": "A 404 when there's no such user or the account isn't available.",
        "operationId": "users.listFollowing",
        "parameters": [
          {
            "name": "username",
            "in": "path",
            "description": "The user's username.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "The page number, from 1 (at most 1000).",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "description": "Items per page, 1–100 (default 20).",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProfileSummaryOffsetPage"
                }
              }
            }
          },
          "400": {
            "description": "The request isn't valid, for example a bad cursor or parameter value.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "The token is missing, expired or no longer valid, or the account can't use the API; see the problem's `detail`.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not found, or not visible to you.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests for your rate limit. Wait for `Retry-After` before trying again.",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Requests allowed in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the window resets, as a Unix time in seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error. Quote the problem's `correlationId` to support.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    },
    "/v2/users/{username}/transmissions": {
      "get": {
        "tags": [
          "Users"
        ],
        "summary": "A user's transmissions, newest first.",
        "description": "Originals, responses and relays. Hub transmissions are left out unless you ask for them on your own timeline. Page back with `cursor`, or poll for new transmissions with `newerThan`. A pinned transmission stays in date order; its `pinned` flag is set. A 404 when there's no such user or the account isn't available.",
        "operationId": "users.listTransmissions",
        "parameters": [
          {
            "name": "username",
            "in": "path",
            "description": "The user's username.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "description": "A previous page's `nextCursor`, to fetch the next (older) page.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "newerThan",
            "in": "query",
            "description": "A previous response's `newestCursor`, to fetch the new transmissions since then (polling). Not with `cursor`.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "take",
            "in": "query",
            "description": "Items per page, 1–25 (default 20).",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "includeRelays",
            "in": "query",
            "description": "Include relays (default true).",
            "schema": {
              "type": "boolean",
              "default": true
            }
          },
          {
            "name": "includeHubTransmissions",
            "in": "query",
            "description": "Your own timeline only: include your hub transmissions (default false). On anyone else's timeline it's a 403.",
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TransmissionCursorPage"
                }
              }
            }
          },
          "400": {
            "description": "The request isn't valid, for example a bad cursor or parameter value.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "401": {
            "description": "The token is missing, expired or no longer valid, or the account can't use the API; see the problem's `detail`.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "403": {
            "description": "Not allowed for you, for example hub transmissions on someone else's timeline.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Not found, or not visible to you.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests for your rate limit. Wait for `Retry-After` before trying again.",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Limit": {
                "description": "Requests allowed in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests left in the window.",
                "schema": {
                  "type": "integer"
                }
              },
              "X-RateLimit-Reset": {
                "description": "When the window resets, as a Unix time in seconds.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error. Quote the problem's `correlationId` to support.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "AnimatedMedia": {
        "required": [
          "url",
          "width",
          "height"
        ],
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "The GIF's `https` URL."
          },
          "width": {
            "type": "integer",
            "description": "The GIF's width in pixels.",
            "format": "int32"
          },
          "height": {
            "type": "integer",
            "description": "The GIF's height in pixels.",
            "format": "int32"
          }
        },
        "description": "An animated GIF attached to a transmission."
      },
      "CatalogCategory": {
        "required": [
          "categoryId",
          "url",
          "title",
          "productCount"
        ],
        "type": "object",
        "properties": {
          "categoryId": {
            "type": "string",
            "description": "The category's id.",
            "format": "uuid",
            "example": "8e9f0a1b-2c3d-4e5f-8a6b-7c8d9e0f1a2b"
          },
          "url": {
            "type": "string",
            "description": "The category's page in the Site's catalog on Blazot, or an empty string in the rare case the Site's name can't form a catalog page address.",
            "example": "https://blazot.com/site/examplesite/catalog/category/8e9f0a1b-2c3d-4e5f-8a6b-7c8d9e0f1a2b/apparel"
          },
          "title": {
            "type": "string",
            "description": "The category's title, as plain text.",
            "example": "Apparel"
          },
          "productCount": {
            "type": "integer",
            "description": "How many products the public can see in the category.",
            "format": "int32"
          }
        },
        "description": "A category in a Site's catalog."
      },
      "CatalogCategoryPage": {
        "required": [
          "category",
          "products",
          "paging"
        ],
        "type": "object",
        "properties": {
          "category": {
            "description": "The category.",
            "$ref": "#/components/schemas/CatalogCategory"
          },
          "products": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Product"
            },
            "description": "This page of the category's products, in the Site's order: up to 30, or an empty list."
          },
          "paging": {
            "description": "Where this page is in the list, and whether there's another.",
            "$ref": "#/components/schemas/OffsetPaging"
          }
        },
        "description": "A page of one catalog category: `{ category, products, paging }`. Unlike the other lists, which are `{ data, paging }`, the items are in `products`, next to the category they belong to."
      },
      "CatalogHome": {
        "required": [
          "url",
          "site",
          "categories",
          "featured",
          "recent"
        ],
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "The catalog's page on Blazot, or an empty string in the rare case the Site's name can't form a catalog page address.",
            "example": "https://blazot.com/site/examplesite/catalog"
          },
          "site": {
            "description": "The Site the catalog belongs to.",
            "$ref": "#/components/schemas/CatalogSite"
          },
          "categories": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CatalogCategory"
            },
            "description": "The catalog's categories, in the Site's order, including ones with no products."
          },
          "featured": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Product"
            },
            "description": "The products the Site features, up to 6, most recently featured first."
          },
          "recent": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Product"
            },
            "description": "The newest products, up to 6, newest first. Products already in `featured` are left out."
          }
        },
        "description": "A Site's catalog home page: the Site, its categories, and its featured and recent products."
      },
      "CatalogSite": {
        "required": [
          "siteName",
          "url",
          "displayName",
          "catalogLabel",
          "profileImageUrl"
        ],
        "type": "object",
        "properties": {
          "siteName": {
            "type": "string",
            "description": "The Site's name: its handle, as in `/v2/sites/{siteName}`.",
            "example": "examplesite"
          },
          "url": {
            "type": "string",
            "description": "The Site's profile page on Blazot.",
            "example": "https://blazot.com/examplesite"
          },
          "displayName": {
            "type": "string",
            "description": "The name the Site shows, as plain text.",
            "example": "Example Site"
          },
          "catalogLabel": {
            "type": "string",
            "description": "What the Site calls its catalog, for use as its heading: `Catalog`, `Products`, `Shop` or `Inventory`.",
            "example": "Shop"
          },
          "profileImageUrl": {
            "type": "string",
            "description": "The URL of the Site's profile image, or an empty string when it has none.",
            "example": "https://cdn-img.blazot.com/sitecontainer/7c9e6679-7425-40de-944b-e07fc1f90ae7.jpg"
          }
        },
        "description": "The Site a catalog belongs to."
      },
      "ClassifiedAd": {
        "required": [
          "adId",
          "url",
          "categoryId",
          "title",
          "summary",
          "details",
          "owner",
          "price",
          "priceRangeTop",
          "priceRangeBottom",
          "salePending",
          "sold",
          "acceptsTrades",
          "listingType",
          "rentalPeriod",
          "streetAddress1",
          "streetAddress2",
          "city",
          "stateProvince",
          "postalZipCode",
          "countryCode",
          "images",
          "schemaKey",
          "dateCreated",
          "expires"
        ],
        "type": "object",
        "properties": {
          "adId": {
            "type": "string",
            "description": "The ad's id, as in `/v2/classifieds/ads/{adId}`.",
            "format": "uuid",
            "example": "0f1e2d3c-4b5a-4968-8776-a5b4c3d2e1f0"
          },
          "url": {
            "type": "string",
            "description": "The ad's page on Blazot.",
            "example": "https://blazot.com/classifieds/0f1e2d3c-4b5a-4968-8776-a5b4c3d2e1f0/2015-compact-sedan-one-owner"
          },
          "categoryId": {
            "type": "string",
            "description": "The id of the ad's category (a bottom-level one).",
            "format": "uuid",
            "example": "7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d"
          },
          "title": {
            "type": "string",
            "description": "The ad's title, as plain text.",
            "example": "2015 compact sedan, one owner"
          },
          "summary": {
            "type": "string",
            "description": "A short summary of the ad, as plain text, or an empty string."
          },
          "details": {
            "type": "string",
            "description": "The ad's full description, as plain text."
          },
          "owner": {
            "description": "Who listed the ad: a user, or a Site for an ad listed from its catalog.",
            "$ref": "#/components/schemas/ProfileSummary"
          },
          "price": {
            "type": [
              "null",
              "number"
            ],
            "description": "The asking price, or null when the ad gives none. No currency is given with it. An ad shows either a price or a range (`priceRangeBottom` to `priceRangeTop`); if both are set, Blazot shows the price.",
            "format": "double",
            "example": 450
          },
          "priceRangeTop": {
            "type": [
              "null",
              "number"
            ],
            "description": "The top of the price range, or null when the ad has no range. Set together with `priceRangeBottom`.",
            "format": "double"
          },
          "priceRangeBottom": {
            "type": [
              "null",
              "number"
            ],
            "description": "The bottom of the price range, or null when the ad has no range. Set together with `priceRangeTop`.",
            "format": "double"
          },
          "salePending": {
            "type": "boolean",
            "description": "Whether the owner has marked a sale as pending."
          },
          "sold": {
            "type": "boolean",
            "description": "Whether the owner has marked the item as sold. Sold ads are still listed."
          },
          "acceptsTrades": {
            "type": "boolean",
            "description": "Whether the owner will also consider trades."
          },
          "listingType": {
            "type": [
              "null",
              "string"
            ],
            "description": "The kind of listing: `ForSale`, `Rent`, `Wanted`, `Offering` (offering a job or service), `Seeking` (looking for one) or `Other`.",
            "example": "ForSale"
          },
          "rentalPeriod": {
            "type": [
              "null",
              "string"
            ],
            "description": "For a `Rent` listing, what period the price is for: `Hour`, `Day`, `Week`, `Month` or `Year`. Null when it isn't given.",
            "example": "Month"
          },
          "streetAddress1": {
            "type": "string",
            "description": "The first line of the street address, or an empty string."
          },
          "streetAddress2": {
            "type": "string",
            "description": "The second line of the street address, or an empty string."
          },
          "city": {
            "type": "string",
            "description": "The city."
          },
          "stateProvince": {
            "type": "string",
            "description": "The state, province or region."
          },
          "postalZipCode": {
            "type": "string",
            "description": "The ZIP or postal code."
          },
          "countryCode": {
            "type": "string",
            "description": "The country code, such as `US`.",
            "example": "US"
          },
          "images": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ClassifiedImage"
            },
            "description": "The ad's images, in display order, or an empty list. In a category's list, an ad listed from a Site's catalog has only its first image; fetch the ad for all of them."
          },
          "schemaKey": {
            "type": [
              "null",
              "string"
            ],
            "description": "The key of the set of extra listing fields the ad's category uses, such as `automobiles` or `real-estate-house`; null when the category uses only the basic fields. Those extra fields aren't in this API.",
            "example": "automobiles"
          },
          "dateCreated": {
            "type": "string",
            "description": "When the ad was listed (UTC).",
            "format": "date-time"
          },
          "expires": {
            "type": "string",
            "description": "When the ad expires (UTC). Expired ads are left out of category lists but can still be fetched by id.",
            "format": "date-time"
          }
        },
        "description": "A classified ad."
      },
      "ClassifiedAdCursorPage": {
        "required": [
          "data",
          "paging"
        ],
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ClassifiedAd"
            },
            "description": "This page's items, newest first, or an empty list."
          },
          "paging": {
            "description": "How to fetch the next page, and whether there is one.",
            "$ref": "#/components/schemas/CursorPaging"
          }
        },
        "description": "A page of a cursor-paged list: `data` plus its `paging`."
      },
      "ClassifiedCategory": {
        "required": [
          "categoryId",
          "url",
          "parentCategoryId",
          "title",
          "description",
          "isBottomLevel",
          "adCount",
          "schemaKey"
        ],
        "type": "object",
        "properties": {
          "categoryId": {
            "type": "string",
            "description": "The category's id.",
            "format": "uuid",
            "example": "7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d"
          },
          "url": {
            "type": "string",
            "description": "The category's page on Blazot.",
            "example": "https://blazot.com/classifieds/category/7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d/cars-and-trucks"
          },
          "parentCategoryId": {
            "type": [
              "null",
              "string"
            ],
            "description": "The id of the category this one is under, or null for a top-level category.",
            "format": "uuid"
          },
          "title": {
            "type": "string",
            "description": "The category's title, as plain text.",
            "example": "Cars and Trucks"
          },
          "description": {
            "type": "string",
            "description": "The category's description, as plain text, or an empty string."
          },
          "isBottomLevel": {
            "type": "boolean",
            "description": "True for a bottom-level category, which holds ads directly; false for one that holds other categories."
          },
          "adCount": {
            "type": "integer",
            "description": "The number of ads the category's ad list shows. For a category with subcategories, the total across every bottom-level category under it.",
            "format": "int32"
          },
          "schemaKey": {
            "type": [
              "null",
              "string"
            ],
            "description": "For a bottom-level category, the key of the set of extra listing fields its ads use, such as `automobiles`; null when they use only the basic fields.",
            "example": "automobiles"
          }
        },
        "description": "A classifieds category. Categories are nested: ads are filed in the bottom-level ones."
      },
      "ClassifiedImage": {
        "required": [
          "imageUrl",
          "width",
          "height"
        ],
        "type": "object",
        "properties": {
          "imageUrl": {
            "type": "string",
            "description": "The image's URL.",
            "example": "https://cdn-img.blazot.com/sitecontainer/7c9e6679-7425-40de-944b-e07fc1f90ae7.jpg"
          },
          "width": {
            "type": "integer",
            "description": "The image's width in pixels.",
            "format": "int32"
          },
          "height": {
            "type": "integer",
            "description": "The image's height in pixels.",
            "format": "int32"
          }
        },
        "description": "An image in a classified ad."
      },
      "CursorPaging": {
        "required": [
          "nextCursor",
          "hasMore",
          "newestCursor"
        ],
        "type": "object",
        "properties": {
          "nextCursor": {
            "type": [
              "null",
              "string"
            ],
            "description": "Pass as `cursor` to fetch the next (older) page. Null when there are no more results, and always null on a `newerThan` poll.",
            "example": "NjM5MTMyNTE2MDAwMDAwMDAwOjhmMTRlNDVmY2VlYTRjMmE5YjNkMWU2ZjVhN2MyZDkw"
          },
          "hasMore": {
            "type": "boolean",
            "description": "Whether more results exist. On a page: older ones, at `nextCursor`. On a `newerThan` poll: newer ones. A poll returns the oldest of the new transmissions (still listed newest first), so poll again with `newestCursor` at once until this is false."
          },
          "newestCursor": {
            "type": [
              "null",
              "string"
            ],
            "description": "Pass as `newerThan` to fetch the new transmissions since then (polling). Given on the newest page, even an empty one, and on polls; null on a `cursor` page and on feeds without polling. Every page, polls included, lists transmissions newest first. Polls only return transmissions at least a minute old, so one on the newest page can come back in a later poll: store transmissions by `transmissionId` and let the later copy replace the earlier. Polling doesn't report edits or deletions; re-read the pages you hold to pick those up.",
            "example": "NjM5MTMyNTE2MDAwMDAwMDAwOjhmMTRlNDVmY2VlYTRjMmE5YjNkMWU2ZjVhN2MyZDkw"
          }
        },
        "description": "The paging details of a cursor-paged list. The cursors are opaque: pass them back exactly as given and don't build or change them."
      },
      "Emoticon": {
        "required": [
          "name",
          "emote",
          "categoryId",
          "sortOrder"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The emoticon's name, which Blazot uses as its label."
          },
          "emote": {
            "type": "string",
            "description": "The emoticon itself, as Unicode text.",
            "example": "\uD83D\uDE00"
          },
          "categoryId": {
            "type": "integer",
            "description": "The id of the group the emoticon belongs to in the picker. Emoticons with the same id belong together; the groups' names aren't in this API.",
            "format": "int32"
          },
          "sortOrder": {
            "type": "integer",
            "description": "The emoticon's place within its group, lowest first.",
            "format": "int32"
          }
        },
        "description": "An emoticon from the set Blazot offers in its emoticon picker."
      },
      "Event": {
        "required": [
          "eventId",
          "siteId",
          "siteName",
          "url",
          "title",
          "subTitle",
          "image",
          "dateCreated",
          "dateStart",
          "dateEnd",
          "summary",
          "details",
          "hasResults",
          "results",
          "websiteLink",
          "streetAddress1",
          "streetAddress2",
          "streetAddress3",
          "city",
          "stateProvince",
          "postalZipCode",
          "countryCode"
        ],
        "type": "object",
        "properties": {
          "eventId": {
            "type": "string",
            "description": "The event's id.",
            "format": "uuid",
            "example": "4d5e6f7a-8b9c-4d0e-9f1a-2b3c4d5e6f7a"
          },
          "siteId": {
            "type": "string",
            "description": "The id of the Site the event belongs to.",
            "format": "uuid",
            "example": "2b3c4d5e-6f7a-4b8c-9d0e-1f2a3b4c5d6e"
          },
          "siteName": {
            "type": "string",
            "description": "The name (handle) of the Site the event belongs to, as in `/v2/sites/{siteName}`.",
            "example": "examplesite"
          },
          "url": {
            "type": "string",
            "description": "The event's page on Blazot.",
            "example": "https://blazot.com/site/examplesite/events/4d5e6f7a-8b9c-4d0e-9f1a-2b3c4d5e6f7a"
          },
          "title": {
            "type": "string",
            "description": "The event's title, as plain text.",
            "example": "Summer Night Series: Round 3"
          },
          "subTitle": {
            "type": "string",
            "description": "The event's subtitle, as plain text, or an empty string."
          },
          "image": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/EventImage"
              }
            ],
            "description": "The event's image, or null when it has none."
          },
          "dateCreated": {
            "type": "string",
            "description": "When the event was created (UTC).",
            "format": "date-time"
          },
          "dateStart": {
            "type": "string",
            "description": "When the event starts, in the Site's local time: ISO 8601 with no offset (for example `2026-05-01T17:00:00`), so don't convert it.",
            "example": "2026-05-01T17:00:00"
          },
          "dateEnd": {
            "type": [
              "null",
              "string"
            ],
            "description": "When the event ends, in the Site's local time (ISO 8601 with no offset), or null when it has no end.",
            "example": "2026-05-01T22:00:00"
          },
          "summary": {
            "type": "string",
            "description": "A short description of the event, as plain text, or an empty string."
          },
          "details": {
            "type": "string",
            "description": "The event's full description, as plain text, or an empty string."
          },
          "hasResults": {
            "type": "boolean",
            "description": "Whether the Site has given results for the event, in `results`."
          },
          "results": {
            "type": "string",
            "description": "The event's results, as plain text, or an empty string when there are none."
          },
          "websiteLink": {
            "type": "string",
            "description": "A website link for the event (an `http` or `https` URL), or an empty string when there's none or the stored link isn't an `http` or `https` URL."
          },
          "streetAddress1": {
            "type": "string",
            "description": "The first line of the street address, or an empty string."
          },
          "streetAddress2": {
            "type": "string",
            "description": "The second line of the street address, or an empty string."
          },
          "streetAddress3": {
            "type": "string",
            "description": "The third line of the street address, or an empty string."
          },
          "city": {
            "type": "string",
            "description": "The city or town, or an empty string."
          },
          "stateProvince": {
            "type": "string",
            "description": "The state, province or region, or an empty string."
          },
          "postalZipCode": {
            "type": "string",
            "description": "The ZIP or postal code, or an empty string."
          },
          "countryCode": {
            "type": "string",
            "description": "The two-letter country code, such as `US`, or an empty string.",
            "example": "US"
          }
        },
        "description": "A Site's event. `dateCreated` is a UTC time. `dateStart` and `dateEnd` are the local times the Site entered, shown the same to every viewer, so they have no time zone: don't convert them. `dateEnd` is null when the event has no end, and the image is null when it has none."
      },
      "EventImage": {
        "required": [
          "imageUrl",
          "width",
          "height"
        ],
        "type": "object",
        "properties": {
          "imageUrl": {
            "type": "string",
            "description": "The image's URL.",
            "example": "https://cdn-img.blazot.com/sitecontainer/7c9e6679-7425-40de-944b-e07fc1f90ae7.jpg"
          },
          "width": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The image's width in pixels, or null when it isn't known.",
            "format": "int32"
          },
          "height": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The image's height in pixels, or null when it isn't known.",
            "format": "int32"
          }
        },
        "description": "An event's image."
      },
      "EventSummary": {
        "required": [
          "eventId",
          "siteId",
          "siteName",
          "url",
          "title",
          "subTitle",
          "imageUrl",
          "dateStart",
          "dateEnd",
          "summary",
          "hasResults",
          "websiteLink",
          "streetAddress1",
          "streetAddress2",
          "streetAddress3",
          "city",
          "stateProvince",
          "postalZipCode",
          "countryCode"
        ],
        "type": "object",
        "properties": {
          "eventId": {
            "type": "string",
            "description": "The event's id.",
            "format": "uuid",
            "example": "4d5e6f7a-8b9c-4d0e-9f1a-2b3c4d5e6f7a"
          },
          "siteId": {
            "type": "string",
            "description": "The id of the Site the event belongs to.",
            "format": "uuid",
            "example": "2b3c4d5e-6f7a-4b8c-9d0e-1f2a3b4c5d6e"
          },
          "siteName": {
            "type": "string",
            "description": "The name (handle) of the Site the event belongs to, as in `/v2/sites/{siteName}`.",
            "example": "examplesite"
          },
          "url": {
            "type": "string",
            "description": "The event's page on Blazot.",
            "example": "https://blazot.com/site/examplesite/events/4d5e6f7a-8b9c-4d0e-9f1a-2b3c4d5e6f7a"
          },
          "title": {
            "type": "string",
            "description": "The event's title, as plain text.",
            "example": "Summer Night Series: Round 3"
          },
          "subTitle": {
            "type": "string",
            "description": "The event's subtitle, as plain text, or an empty string."
          },
          "imageUrl": {
            "type": [
              "null",
              "string"
            ],
            "description": "The URL of the event's image, or null when it has none. (Its size is given only on the event itself.)",
            "example": "https://cdn-img.blazot.com/sitecontainer/7c9e6679-7425-40de-944b-e07fc1f90ae7.jpg"
          },
          "dateStart": {
            "type": "string",
            "description": "When the event starts, in the Site's local time: ISO 8601 with no offset (for example `2026-05-01T17:00:00`), so don't convert it.",
            "example": "2026-05-01T17:00:00"
          },
          "dateEnd": {
            "type": [
              "null",
              "string"
            ],
            "description": "When the event ends, in the Site's local time (ISO 8601 with no offset), or null when it has no end.",
            "example": "2026-05-01T22:00:00"
          },
          "summary": {
            "type": "string",
            "description": "A short description of the event, as plain text, or an empty string."
          },
          "hasResults": {
            "type": "boolean",
            "description": "Whether the Site has given results for the event. Fetch the event for the results themselves."
          },
          "websiteLink": {
            "type": "string",
            "description": "A website link for the event (an `http` or `https` URL), or an empty string when there's none or the stored link isn't an `http` or `https` URL."
          },
          "streetAddress1": {
            "type": "string",
            "description": "The first line of the street address, or an empty string."
          },
          "streetAddress2": {
            "type": "string",
            "description": "The second line of the street address, or an empty string."
          },
          "streetAddress3": {
            "type": "string",
            "description": "The third line of the street address, or an empty string."
          },
          "city": {
            "type": "string",
            "description": "The city or town, or an empty string."
          },
          "stateProvince": {
            "type": "string",
            "description": "The state, province or region, or an empty string."
          },
          "postalZipCode": {
            "type": "string",
            "description": "The ZIP or postal code, or an empty string."
          },
          "countryCode": {
            "type": "string",
            "description": "The two-letter country code, such as `US`, or an empty string.",
            "example": "US"
          }
        },
        "description": "An event in a list; fetch the event itself for its details. `dateStart` and `dateEnd` are the local times the Site entered, with no time zone: don't convert them."
      },
      "EventSummaryOffsetPage": {
        "required": [
          "data",
          "paging"
        ],
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EventSummary"
            },
            "description": "This page's items, or an empty list."
          },
          "paging": {
            "description": "Which page this is, and whether there's another.",
            "$ref": "#/components/schemas/OffsetPaging"
          }
        },
        "description": "A page of a page-numbered list: `data` plus its `paging`. While `hasMore` is true, ask for the next page with `page` + 1."
      },
      "Hashtag": {
        "required": [
          "tag"
        ],
        "type": "object",
        "properties": {
          "tag": {
            "type": "string",
            "description": "The hashtag's text, without the leading `#`.",
            "example": "trailrunning"
          }
        },
        "description": "A hashtag that matches a search. Its transmissions are at `/v2/hashtags/{tag}/transmissions`."
      },
      "Hub": {
        "required": [
          "hubId",
          "hubCategoryId",
          "hubName",
          "url",
          "displayName",
          "description",
          "imageUrl",
          "coverImageUrl",
          "showImageBorder",
          "dateCreated",
          "isPrivate",
          "requiresMemberApproval",
          "memberCount",
          "viewerIsMember",
          "viewerIsApprovedMember",
          "admins"
        ],
        "type": "object",
        "properties": {
          "hubId": {
            "type": "string",
            "description": "The hub's id.",
            "format": "uuid",
            "example": "6a7b8c9d-0e1f-4a2b-8c3d-4e5f6a7b8c9d"
          },
          "hubCategoryId": {
            "type": "string",
            "description": "The id of the hub category the hub is in.",
            "format": "uuid"
          },
          "hubName": {
            "type": "string",
            "description": "The hub's name: its handle in the API (`/v2/hubs/{hubName}`) and on Blazot (`blazot.com/hubs/{hubName}`). Show `displayName` to people instead.",
            "example": "5c1e9f2a7b3d4e6f8a0b1c2d3e4f5a6b"
          },
          "url": {
            "type": "string",
            "description": "The hub's page on Blazot.",
            "example": "https://blazot.com/hubs/5c1e9f2a7b3d4e6f8a0b1c2d3e4f5a6b"
          },
          "displayName": {
            "type": "string",
            "description": "The hub's title as it's shown to people, as plain text.",
            "example": "Trail Running"
          },
          "description": {
            "type": "string",
            "description": "The hub's description, as plain text, or an empty string."
          },
          "imageUrl": {
            "type": "string",
            "description": "The URL of the hub's image, or an empty string when it has none.",
            "example": "https://cdn-img.blazot.com/sitecontainer/7c9e6679-7425-40de-944b-e07fc1f90ae7.jpg"
          },
          "coverImageUrl": {
            "type": "string",
            "description": "The URL of the hub's cover image, or an empty string when it has none.",
            "example": "https://cdn-img.blazot.com/sitecontainer/0b6d3a2e-5f1c-4b8e-9a7d-2c4e6f8a1b3d.jpg"
          },
          "showImageBorder": {
            "type": "boolean",
            "description": "A display hint: whether Blazot draws a border around the hub's image."
          },
          "dateCreated": {
            "type": "string",
            "description": "When the hub was created (UTC).",
            "format": "date-time"
          },
          "isPrivate": {
            "type": "boolean",
            "description": "Whether the hub is private: only its approved members can see its transmissions."
          },
          "requiresMemberApproval": {
            "type": "boolean",
            "description": "Whether a request to join has to be approved by the hub before the person becomes an approved member."
          },
          "memberCount": {
            "type": "integer",
            "description": "How many approved members the hub has.",
            "format": "int32"
          },
          "viewerIsMember": {
            "type": "boolean",
            "description": "True when you're a member of this hub or have asked to join (a request still waiting for approval counts)."
          },
          "viewerIsApprovedMember": {
            "type": "boolean",
            "description": "True when your membership is approved, so you can see a private hub's content."
          },
          "admins": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ProfileSummary"
            },
            "description": "The hub's admins."
          }
        },
        "description": "A hub. Image URLs are an empty string when the hub has no image."
      },
      "HubCategory": {
        "required": [
          "hubCategoryId",
          "parentCategoryId",
          "categoryName",
          "hubCount"
        ],
        "type": "object",
        "properties": {
          "hubCategoryId": {
            "type": "string",
            "description": "The category's id.",
            "format": "uuid",
            "example": "1c2d3e4f-5a6b-4c7d-8e9f-0a1b2c3d4e5f"
          },
          "parentCategoryId": {
            "type": [
              "null",
              "string"
            ],
            "description": "The id of the category this one is under, or null for a top-level category.",
            "format": "uuid"
          },
          "categoryName": {
            "type": "string",
            "description": "The category's name, as plain text.",
            "example": "Outdoors"
          },
          "hubCount": {
            "type": "integer",
            "description": "How many available hubs are filed directly in this category (hubs in categories under it aren't counted).",
            "format": "int32"
          }
        },
        "description": "A hub category. Categories can be nested: a top-level category has no `parentCategoryId`."
      },
      "HubSummary": {
        "required": [
          "hubId",
          "hubCategoryId",
          "hubName",
          "url",
          "displayName",
          "description",
          "imageUrl",
          "isPrivate",
          "requiresMemberApproval",
          "memberCount"
        ],
        "type": "object",
        "properties": {
          "hubId": {
            "type": "string",
            "description": "The hub's id.",
            "format": "uuid",
            "example": "6a7b8c9d-0e1f-4a2b-8c3d-4e5f6a7b8c9d"
          },
          "hubCategoryId": {
            "type": "string",
            "description": "The id of the hub category the hub is in.",
            "format": "uuid"
          },
          "hubName": {
            "type": "string",
            "description": "The hub's name: its handle in the API (`/v2/hubs/{hubName}`) and on Blazot (`blazot.com/hubs/{hubName}`). Show `displayName` to people instead.",
            "example": "5c1e9f2a7b3d4e6f8a0b1c2d3e4f5a6b"
          },
          "url": {
            "type": "string",
            "description": "The hub's page on Blazot.",
            "example": "https://blazot.com/hubs/5c1e9f2a7b3d4e6f8a0b1c2d3e4f5a6b"
          },
          "displayName": {
            "type": "string",
            "description": "The hub's title as it's shown to people, as plain text.",
            "example": "Trail Running"
          },
          "description": {
            "type": "string",
            "description": "The hub's description, as plain text, or an empty string."
          },
          "imageUrl": {
            "type": "string",
            "description": "The URL of the hub's image, or an empty string when it has none.",
            "example": "https://cdn-img.blazot.com/sitecontainer/7c9e6679-7425-40de-944b-e07fc1f90ae7.jpg"
          },
          "isPrivate": {
            "type": "boolean",
            "description": "Whether the hub is private: only its approved members can see its transmissions."
          },
          "requiresMemberApproval": {
            "type": "boolean",
            "description": "Whether a request to join has to be approved by the hub before the person becomes an approved member."
          },
          "memberCount": {
            "type": "integer",
            "description": "How many approved members the hub has.",
            "format": "int32"
          }
        },
        "description": "A hub in a list, without its admins or your membership. Image URLs are an empty string when the hub has no image."
      },
      "HubSummaryOffsetPage": {
        "required": [
          "data",
          "paging"
        ],
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/HubSummary"
            },
            "description": "This page's items, or an empty list."
          },
          "paging": {
            "description": "Which page this is, and whether there's another.",
            "$ref": "#/components/schemas/OffsetPaging"
          }
        },
        "description": "A page of a page-numbered list: `data` plus its `paging`. While `hasMore` is true, ask for the next page with `page` + 1."
      },
      "Interactions": {
        "required": [
          "reactionCount",
          "responseCount",
          "relayCount"
        ],
        "type": "object",
        "properties": {
          "reactionCount": {
            "type": "integer",
            "description": "How many reactions it has.",
            "format": "int32"
          },
          "responseCount": {
            "type": "integer",
            "description": "How many responses it has.",
            "format": "int32"
          },
          "relayCount": {
            "type": "integer",
            "description": "How many times it has been relayed.",
            "format": "int32"
          }
        },
        "description": "A transmission's interaction counts."
      },
      "Meta": {
        "required": [
          "name",
          "version",
          "status"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The API's name."
          },
          "version": {
            "type": "string",
            "description": "The API version, for example `2.0`."
          },
          "status": {
            "type": "string",
            "description": "`ok` when the API is serving requests."
          }
        },
        "description": "The API's name, version and status."
      },
      "OffsetPaging": {
        "required": [
          "page",
          "pageSize",
          "hasMore"
        ],
        "type": "object",
        "properties": {
          "page": {
            "type": "integer",
            "description": "The page number served, from 1. A page number above the API's ceiling (1000; 34 for a catalog category) is lowered to it, so this can differ from the one you asked for. A page past the end of the list has an empty `data` (a catalog category answers 404).",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "description": "The most items a page holds, after any limit was applied to the size you asked for.",
            "format": "int32"
          },
          "hasMore": {
            "type": "boolean",
            "description": "Whether there's a next page. Always false on the last page the API serves (page 1000, or 34 for a catalog category), so paging through stops there."
          }
        },
        "description": "The paging details of a page-numbered list."
      },
      "Poll": {
        "required": [
          "choices",
          "totalVotes",
          "duration",
          "endTime"
        ],
        "type": "object",
        "properties": {
          "choices": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PollChoice"
            },
            "description": "The poll's choices."
          },
          "totalVotes": {
            "type": "integer",
            "description": "How many votes the poll has in all. Always shown.",
            "format": "int32"
          },
          "duration": {
            "pattern": "^-?(\\d+\\.)?\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,7})?$",
            "type": "string",
            "description": "How long the poll is open, as `[d.]hh:mm:ss`: for example `1.00:00:00` for one day or `06:30:00` for six and a half hours.",
            "example": "1.00:00:00"
          },
          "endTime": {
            "type": "string",
            "description": "When voting closes (UTC): the time the poll was created plus its `duration`.",
            "format": "date-time"
          }
        },
        "description": "A poll in a transmission. As on Blazot, each choice's count is shown once you've voted or the poll has ended; until then only the total is. A Site's key can't vote, so it sees the counts once the poll ends."
      },
      "PollChoice": {
        "required": [
          "choice",
          "voteCount",
          "isYourChoice"
        ],
        "type": "object",
        "properties": {
          "choice": {
            "type": "string",
            "description": "The choice's text, as plain text."
          },
          "voteCount": {
            "type": [
              "null",
              "integer"
            ],
            "description": "How many votes the choice has, or null while the poll is open and you haven't voted.",
            "format": "int32"
          },
          "isYourChoice": {
            "type": "boolean",
            "description": "You voted for this choice."
          }
        },
        "description": "One choice in a poll."
      },
      "Problem": {
        "required": [
          "type",
          "title",
          "status",
          "code",
          "correlationId"
        ],
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "A URI for the error kind: `https://api.blazot.com/problems/` followed by the `code`."
          },
          "title": {
            "type": "string",
            "description": "A short, human-readable summary of the error kind."
          },
          "status": {
            "type": "integer",
            "description": "The HTTP status code."
          },
          "detail": {
            "type": "string",
            "description": "What went wrong in this case, when there's more to say."
          },
          "instance": {
            "type": "string",
            "description": "The request path."
          },
          "correlationId": {
            "type": "string",
            "description": "Identifies this request in Blazot's logs."
          },
          "code": {
            "enum": [
              "validation",
              "unauthorized",
              "forbidden",
              "not-found",
              "conflict",
              "rate-limited",
              "server-error"
            ],
            "type": "string",
            "description": "The error kind, for matching in code."
          }
        },
        "description": "An error (RFC 9457 Problem Details). Match on `code`; quote `correlationId` when contacting support."
      },
      "Product": {
        "required": [
          "id",
          "url",
          "categoryId",
          "title",
          "description",
          "price",
          "currencyCode",
          "externalUrl",
          "media",
          "dateCreated"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The product's id, as in `/v2/sites/{siteName}/catalog/products/{productId}`.",
            "format": "uuid",
            "example": "5f6a7b8c-9d0e-4f1a-8b2c-3d4e5f6a7b8c"
          },
          "url": {
            "type": "string",
            "description": "The product's page on Blazot (`externalUrl` is the Site's own store), or an empty string in the rare case the Site's name can't form a catalog page address.",
            "example": "https://blazot.com/site/examplesite/catalog/5f6a7b8c-9d0e-4f1a-8b2c-3d4e5f6a7b8c/team-hoodie"
          },
          "categoryId": {
            "type": [
              "null",
              "string"
            ],
            "description": "The id of the catalog category the product is in, or null when it isn't in a category.",
            "format": "uuid",
            "example": "8e9f0a1b-2c3d-4e5f-8a6b-7c8d9e0f1a2b"
          },
          "title": {
            "type": "string",
            "description": "The product's title, as plain text.",
            "example": "Team Hoodie"
          },
          "description": {
            "type": [
              "null",
              "string"
            ],
            "description": "The product's description, as plain text, or null when it has none. Null in lists (the catalog home and category pages): fetch the product for it."
          },
          "price": {
            "type": [
              "null",
              "number"
            ],
            "description": "The price the Site shows for the product, in `currencyCode`, or null when it shows none. It's for display only: the price that counts is the one in the Site's store.",
            "format": "double",
            "example": 49.99
          },
          "currencyCode": {
            "type": [
              "null",
              "string"
            ],
            "description": "The ISO 4217 code of the price's currency, such as `USD` or `EUR`. Blazot defaults it to `USD`.",
            "example": "USD"
          },
          "externalUrl": {
            "type": "string",
            "description": "The product's page in the Site's own store, where it's bought. Blazot has no checkout. Always an `https` URL, or an empty string if the stored link isn't one. Empty in lists (the catalog home and category pages): fetch the product for it.",
            "example": "https://shop.example.com/products/team-hoodie"
          },
          "media": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ProductMedia"
            },
            "description": "The product's images, in display order (the first is the main image), or an empty list. In lists (the catalog home and category pages) only the main image: fetch the product for the rest."
          },
          "dateCreated": {
            "type": "string",
            "description": "When the product was added to the catalog (UTC).",
            "format": "date-time"
          }
        },
        "description": "A product in a Site's catalog. Blazot shows products and links to the Site's own store to buy them; it has no checkout."
      },
      "ProductDetail": {
        "required": [
          "site",
          "product"
        ],
        "type": "object",
        "properties": {
          "site": {
            "description": "The Site the product belongs to.",
            "$ref": "#/components/schemas/CatalogSite"
          },
          "product": {
            "description": "The product.",
            "$ref": "#/components/schemas/Product"
          }
        },
        "description": "One catalog product, with the Site it belongs to."
      },
      "ProductMedia": {
        "required": [
          "imageUrl",
          "mediaType",
          "width",
          "height",
          "description",
          "rank"
        ],
        "type": "object",
        "properties": {
          "imageUrl": {
            "type": "string",
            "description": "The image's URL.",
            "example": "https://cdn-img.blazot.com/sitecontainer/7c9e6679-7425-40de-944b-e07fc1f90ae7.jpg"
          },
          "mediaType": {
            "type": "string",
            "description": "The kind of media. Catalog products have images only, so this is `Image`.",
            "example": "Image"
          },
          "width": {
            "type": "integer",
            "description": "The image's width in pixels.",
            "format": "int32"
          },
          "height": {
            "type": "integer",
            "description": "The image's height in pixels.",
            "format": "int32"
          },
          "description": {
            "type": "string",
            "description": "The Site's caption for the image, also usable as its alt text, or an empty string."
          },
          "rank": {
            "type": "integer",
            "description": "The image's place in the product's display order, lowest first. `media` is already in this order, and its first image is the product's main one.",
            "format": "int32"
          }
        },
        "description": "An image of a catalog product."
      },
      "ProfileSummary": {
        "required": [
          "userName",
          "url",
          "displayName",
          "profileImageUrl",
          "verified",
          "isSubscriber",
          "subscriptionLevel"
        ],
        "type": "object",
        "properties": {
          "userName": {
            "type": "string",
            "description": "The account's handle: a user's username, or a Site's name when the account is a Site.",
            "example": "exampleuser"
          },
          "url": {
            "type": "string",
            "description": "The account's profile page on Blazot, or an empty string when the account has no handle.",
            "example": "https://blazot.com/exampleuser"
          },
          "displayName": {
            "type": "string",
            "description": "The name the account shows, as plain text.",
            "example": "Example User"
          },
          "profileImageUrl": {
            "type": "string",
            "description": "The URL of the account's profile image, or an empty string when it has none.",
            "example": "https://cdn-img.blazot.com/sitecontainer/7c9e6679-7425-40de-944b-e07fc1f90ae7.jpg"
          },
          "verified": {
            "type": "boolean",
            "description": "Whether Blazot has verified the account."
          },
          "isSubscriber": {
            "type": "boolean",
            "description": "Whether the account has a Blazot subscription."
          },
          "subscriptionLevel": {
            "type": "integer",
            "description": "The account's subscription level, from 0 (the entry plan) to 5 (the highest). It's also 0 when the account doesn't subscribe, so check `isSubscriber` to tell the two apart.",
            "format": "int32"
          }
        },
        "description": "A short profile of a user or Site, as given for authors, ad owners, followers, hub members and search results."
      },
      "ProfileSummaryOffsetPage": {
        "required": [
          "data",
          "paging"
        ],
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ProfileSummary"
            },
            "description": "This page's items, or an empty list."
          },
          "paging": {
            "description": "Which page this is, and whether there's another.",
            "$ref": "#/components/schemas/OffsetPaging"
          }
        },
        "description": "A page of a page-numbered list: `data` plus its `paging`. While `hasMore` is true, ask for the next page with `page` + 1."
      },
      "SiteAddress": {
        "required": [
          "streetAddress1",
          "streetAddress2",
          "city",
          "stateProvince",
          "postalZipCode",
          "country"
        ],
        "type": "object",
        "properties": {
          "streetAddress1": {
            "type": "string",
            "description": "The first line of the street address."
          },
          "streetAddress2": {
            "type": "string",
            "description": "The second line of the street address."
          },
          "city": {
            "type": "string",
            "description": "The city."
          },
          "stateProvince": {
            "type": "string",
            "description": "The state, province or region."
          },
          "postalZipCode": {
            "type": "string",
            "description": "The ZIP or postal code."
          },
          "country": {
            "type": "string",
            "description": "The country, as free text the Site typed (for example `United States`), so it isn't guaranteed to be a standard name or code."
          }
        },
        "description": "A Site's address, as the Site entered it. Each part is plain text, or an empty string when the Site left it out; at least one part is filled in."
      },
      "SiteProfile": {
        "required": [
          "siteName",
          "url",
          "displayName",
          "about",
          "profileImageUrl",
          "coverImageUrl",
          "verified",
          "isSubscriber",
          "subscriptionLevel",
          "dateJoined",
          "phone",
          "address",
          "hasCatalog"
        ],
        "type": "object",
        "properties": {
          "siteName": {
            "type": "string",
            "description": "The Site's name: its handle on Blazot (`blazot.com/{siteName}`) and in the API (`/v2/sites/{siteName}`).",
            "example": "examplesite"
          },
          "url": {
            "type": "string",
            "description": "The Site's profile page on Blazot.",
            "example": "https://blazot.com/examplesite"
          },
          "displayName": {
            "type": "string",
            "description": "The name the Site shows, as plain text.",
            "example": "Example Site"
          },
          "about": {
            "type": "string",
            "description": "The Site's description of itself, as plain text, or an empty string when it has none."
          },
          "profileImageUrl": {
            "type": "string",
            "description": "The URL of the Site's profile image, or an empty string when it has none.",
            "example": "https://cdn-img.blazot.com/sitecontainer/7c9e6679-7425-40de-944b-e07fc1f90ae7.jpg"
          },
          "coverImageUrl": {
            "type": "string",
            "description": "The URL of the Site's cover image, or an empty string when it has none.",
            "example": "https://cdn-img.blazot.com/sitecontainer/0b6d3a2e-5f1c-4b8e-9a7d-2c4e6f8a1b3d.jpg"
          },
          "verified": {
            "type": "boolean",
            "description": "Whether Blazot has verified the Site."
          },
          "isSubscriber": {
            "type": "boolean",
            "description": "Whether the Site has a Blazot subscription."
          },
          "subscriptionLevel": {
            "type": "integer",
            "description": "The Site's subscription level, from 0 (the entry plan) to 5 (the highest). It's also 0 when the Site doesn't subscribe, so check `isSubscriber` to tell the two apart.",
            "format": "int32"
          },
          "dateJoined": {
            "type": "string",
            "description": "When the Site was created (UTC).",
            "format": "date-time"
          },
          "phone": {
            "type": "string",
            "description": "The Site's phone number as the Site entered it, in no fixed format, or an empty string when it has none."
          },
          "address": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/SiteAddress"
              }
            ],
            "description": "The Site's address, or null when it has none."
          },
          "hasCatalog": {
            "type": "boolean",
            "description": "Whether the Site has a public catalog (`/v2/sites/{siteName}/catalog`)."
          }
        },
        "description": "A Site's public profile."
      },
      "Token": {
        "required": [
          "tokenType",
          "accessToken",
          "expiresIn"
        ],
        "type": "object",
        "properties": {
          "tokenType": {
            "type": "string",
            "description": "Always `bearer`: send the token in an `Authorization: Bearer` header."
          },
          "accessToken": {
            "type": "string",
            "description": "The token. Keep it secret: until it expires, it gives access as your account."
          },
          "expiresIn": {
            "type": "integer",
            "description": "How many seconds the token lasts from now. Reuse it until then.",
            "format": "int32"
          }
        },
        "description": "An access token for the API."
      },
      "Transmission": {
        "required": [
          "transmissionId",
          "url",
          "parentItemId",
          "dateTransmitted",
          "dateEdited",
          "body",
          "author",
          "media",
          "containsSensitiveMedia",
          "pinned",
          "webLink",
          "interactions",
          "poll",
          "relayedTransmission",
          "animatedMedia"
        ],
        "type": "object",
        "properties": {
          "transmissionId": {
            "type": "string",
            "description": "The transmission's id.",
            "format": "uuid",
            "example": "3f2b8c1e-9a4d-4e7b-8c6f-1d2e3a4b5c6d"
          },
          "url": {
            "type": "string",
            "description": "The transmission's page on Blazot. The API gives a video's cover image only, not the video, so link the cover to this page to play it.",
            "example": "https://blazot.com/transmission/3f2b8c1e-9a4d-4e7b-8c6f-1d2e3a4b5c6d"
          },
          "parentItemId": {
            "type": [
              "null",
              "string"
            ],
            "description": "The id of the item this one responds to, or null when it isn't a response. Today the parent is always a transmission (its `transmissionId`).",
            "format": "uuid",
            "example": "9d8c7b6a-5e4f-4a3b-9c2d-1e0f9a8b7c6d"
          },
          "dateTransmitted": {
            "type": "string",
            "description": "When the transmission was sent (UTC).",
            "format": "date-time"
          },
          "dateEdited": {
            "type": [
              "null",
              "string"
            ],
            "description": "When its text was last edited (UTC), or null when it has never been edited.",
            "format": "date-time"
          },
          "body": {
            "type": "string",
            "description": "The transmission's text, as plain text. It can be empty, for example on a relay without a comment or a transmission that is only media."
          },
          "author": {
            "description": "Who sent it: a user, or a Site (whose `userName` is then its Site name).",
            "$ref": "#/components/schemas/ProfileSummary"
          },
          "media": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TransmissionMedia"
            },
            "description": "The attached images and video cover, or an empty list. A video's cover comes first, followed by the images."
          },
          "containsSensitiveMedia": {
            "type": "boolean",
            "description": "The author marked the media as sensitive: show it only after the viewer chooses to, as Blazot does."
          },
          "pinned": {
            "type": "boolean",
            "description": "The author pinned it to their profile. Feeds stay in date order, so it isn't moved to the top."
          },
          "webLink": {
            "description": "The preview of a link in the transmission. Never null: when there's no link, every field is an empty string, so check `linkUrl`.",
            "$ref": "#/components/schemas/WebLink"
          },
          "interactions": {
            "description": "How many reactions, responses and relays it has.",
            "$ref": "#/components/schemas/Interactions"
          },
          "poll": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/Poll"
              }
            ],
            "description": "The transmission's poll, or null when it has none."
          },
          "relayedTransmission": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/Transmission"
              }
            ],
            "description": "For a relay, the transmission it relays. Null when this isn't a relay, and also when you can't see the original, for example because it was deleted, is hidden from you or is in a private hub you aren't an approved member of."
          },
          "animatedMedia": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/AnimatedMedia"
              }
            ],
            "description": "An animated GIF attached to the transmission, or null when it has none."
          }
        },
        "description": "A transmission. A relay carries the original in `relayedTransmission`, one level deep: the original's own `relayedTransmission` is always null."
      },
      "TransmissionCursorPage": {
        "required": [
          "data",
          "paging"
        ],
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Transmission"
            },
            "description": "This page's items, newest first, or an empty list."
          },
          "paging": {
            "description": "How to fetch the next page, and whether there is one.",
            "$ref": "#/components/schemas/CursorPaging"
          }
        },
        "description": "A page of a cursor-paged list: `data` plus its `paging`."
      },
      "TransmissionMedia": {
        "required": [
          "imageUrl",
          "imageWidth",
          "imageHeight",
          "videoCover",
          "videoWidth",
          "videoHeight"
        ],
        "type": "object",
        "properties": {
          "imageUrl": {
            "type": "string",
            "description": "The image's URL, or an empty string when this item is a video cover.",
            "example": "https://cdn-img.blazot.com/sitecontainer/7c9e6679-7425-40de-944b-e07fc1f90ae7.jpg"
          },
          "imageWidth": {
            "type": "integer",
            "description": "The image's width in pixels, or 0 for a video cover.",
            "format": "int32"
          },
          "imageHeight": {
            "type": "integer",
            "description": "The image's height in pixels, or 0 for a video cover.",
            "format": "int32"
          },
          "videoCover": {
            "type": "string",
            "description": "The URL of the video's cover image, or an empty string when this item is an image. The video itself plays on the transmission's `url`."
          },
          "videoWidth": {
            "type": "integer",
            "description": "The video's width in pixels, or 0 for an image.",
            "format": "int32"
          },
          "videoHeight": {
            "type": "integer",
            "description": "The video's height in pixels, or 0 for an image.",
            "format": "int32"
          }
        },
        "description": "One image or video cover attached to a transmission. An image has `imageUrl` set and an empty `videoCover`; a video cover has `videoCover` set and an empty `imageUrl`. The sizes of the kind that isn't set are 0."
      },
      "UserProfile": {
        "required": [
          "userName",
          "url",
          "displayName",
          "bio",
          "profileImageUrl",
          "coverImageUrl",
          "verified",
          "isSubscriber",
          "subscriptionLevel",
          "dateJoined"
        ],
        "type": "object",
        "properties": {
          "userName": {
            "type": "string",
            "description": "The user's username: their handle on Blazot and in the API (`/v2/users/{username}`).",
            "example": "exampleuser"
          },
          "url": {
            "type": "string",
            "description": "The user's profile page on Blazot.",
            "example": "https://blazot.com/exampleuser"
          },
          "displayName": {
            "type": "string",
            "description": "The name the user shows, as plain text.",
            "example": "Example User"
          },
          "bio": {
            "type": "string",
            "description": "The user's bio, as plain text, or an empty string when they haven't written one."
          },
          "profileImageUrl": {
            "type": "string",
            "description": "The URL of the user's profile image, or an empty string when they have none.",
            "example": "https://cdn-img.blazot.com/sitecontainer/7c9e6679-7425-40de-944b-e07fc1f90ae7.jpg"
          },
          "coverImageUrl": {
            "type": "string",
            "description": "The URL of the user's cover image, or an empty string when they have none.",
            "example": "https://cdn-img.blazot.com/sitecontainer/0b6d3a2e-5f1c-4b8e-9a7d-2c4e6f8a1b3d.jpg"
          },
          "verified": {
            "type": "boolean",
            "description": "Whether Blazot has verified the account."
          },
          "isSubscriber": {
            "type": "boolean",
            "description": "Whether the user has a Blazot subscription."
          },
          "subscriptionLevel": {
            "type": "integer",
            "description": "The user's subscription level, from 0 (the entry plan) to 5 (the highest). It's also 0 when the user doesn't subscribe, so check `isSubscriber` to tell the two apart.",
            "format": "int32"
          },
          "dateJoined": {
            "type": "string",
            "description": "When the account was created (UTC).",
            "format": "date-time"
          }
        },
        "description": "A user's public profile."
      },
      "WebLink": {
        "required": [
          "linkUrl",
          "imageUrl",
          "title",
          "description"
        ],
        "type": "object",
        "properties": {
          "linkUrl": {
            "type": "string",
            "description": "The link, as an `http` or `https` URL, or an empty string when there's no link.",
            "example": "https://example.com/article"
          },
          "imageUrl": {
            "type": "string",
            "description": "The URL of the preview image, or an empty string when the preview has none.",
            "example": "https://cdn-img.blazot.com/sitecontainer/5a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d.jpg"
          },
          "title": {
            "type": "string",
            "description": "The linked page's title, or an empty string."
          },
          "description": {
            "type": "string",
            "description": "The linked page's description, or an empty string."
          }
        },
        "description": "The preview Blazot made of a link in a transmission. Every field is an empty string when the transmission has no link."
      }
    },
    "securitySchemes": {
      "bearer": {
        "type": "http",
        "description": "An access token from `/v2/auth/token`, sent as `Authorization: Bearer {token}`.",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      },
      "apiKey": {
        "type": "apiKey",
        "description": "Your API key, from your account's or Site's settings. Only the token call takes it.",
        "name": "x-api-key",
        "in": "header"
      },
      "apiSecret": {
        "type": "apiKey",
        "description": "Your API key's secret. Only the token call takes it; never put it in a web page or an app.",
        "name": "x-secret-auth-key",
        "in": "header"
      }
    }
  },
  "tags": [
    {
      "name": "Authentication",
      "description": "Exchange your API key and secret for an access token."
    },
    {
      "name": "Users",
      "description": "Users' public profiles, followers, following and transmissions."
    },
    {
      "name": "Sites",
      "description": "Sites' public profiles and transmissions."
    },
    {
      "name": "Transmissions",
      "description": "A single transmission."
    },
    {
      "name": "Hashtags",
      "description": "The transmissions with a hashtag."
    },
    {
      "name": "Hubs",
      "description": "Hub categories, hubs, their members and their transmissions."
    },
    {
      "name": "Events",
      "description": "A Site's events."
    },
    {
      "name": "Catalog",
      "description": "A Site's catalog of products."
    },
    {
      "name": "Classifieds",
      "description": "Classified ads and their categories."
    },
    {
      "name": "Search",
      "description": "Search for users and hashtags."
    },
    {
      "name": "Emoticons",
      "description": "The emoticon set Blazot offers when writing a transmission."
    },
    {
      "name": "Meta",
      "description": "The API's name, version and status."
    }
  ]
}
