GunSpec

Content

Public, key-free reads for GunSpec editorial content: blog posts and the product changelog. Both return only published entries and support pagination and category filtering. Use them to embed news, release notes, or articles directly in your own app.

Optional AuthExplorer+

Get a site update

Returns one published post, with its body blocks.

GET/v1/updates/{id}

Explorer+

  • stringheader

    Optional. Without a key this endpoint answers under the public policy; a key raises your limits and unlocks plan-gated fields. Authorization: Bearer <key> is accepted in its place.

  • stringrequired

    The update slug

    Accepts
    a lowercase slug: letters, digits and hyphens
    Example

application/json

  • object

    The response payload.

  • SiteUpdate

    A dated post about the service: what is happening with the catalogue, the platform or the company, and why. Distinct from /v1/changelog, which records what shipped, and from a site notice, which is one line of chrome.

  • string

    The slug, and the URL: gunspec.io/updates/{id}.

  • string
  • string
  • UpdateKind

    What a site update is about: the catalogue, the platform, a policy, the company, or an incident.

  • UpdateBlock[]
  • UpdateFigure

    The figure beside an update. Either a picture, or a character-field pattern the website draws itself: most posts have no photograph, and a named drawing is the honest alternative to a stock image. Read kind to tell them apart.

  • string | null

    The day the post is dated, as YYYY-MM-DD. A later edit does not re-date it.

  • integer

    Held at the top of the list regardless of date.

  • 400VALIDATION_ERRORValidation error
  • 404NOT_FOUNDResource not found
  • 429RATE_LIMITEDRate limit exceeded
  • 500INTERNAL_ERRORUnexpected server error

Full rate limits

Minimum tier
Explorer+
Monthly quota
200/mo
Rate limit
10/min
Daily cap
50

Figures shown are for this endpoint's minimum tier. Higher tiers raise every limit.