List site updates
Returns published posts about the service, pinned first and then newest. This is the editorial feed behind gunspec.io/updates: what is happening with the catalogue, the platform or the company, and why. /v1/changelog is the separate, narrower record of what shipped.
- 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.
- integerdefault
1Page number, from 1 to 10,000
- Range
- 1 – 10000
- Example
- integerdefault
20Updates per page
- Range
- 1 – 50
- Example
- string
Filter by what the post is about
- Accepts
- 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[]
- UpdateBlockType
The kind of block in a site update body. Each maps to a renderer on the website.
- string
The words, on a
paragraph,headingorquote. - string[]
The entries of a
list. - boolean
Whether a
listis numbered. - string
Who a
quoteis from. - string
The source of a
codeblock. - string
How to highlight a
codeblock. - 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
kindto tell them apart. - string
The line under a
figure. - 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
kindto tell them apart. - string
What the asset is:
silhouette,render,photo,schematic,model./v1/firearms/{id}/media/{selector}addresses an asset by this. - string
Where the picture is. Present when
kindisimage. - string
What the picture shows. Present when
kindisimage. - UpdateGlyphPattern
A character-field pattern an update may name in place of a photograph. The website draws it.
- string
Seeds the drawing. The same seed always draws the same field, so a post keeps its figure between loads.
- string[]
What the
wordspattern spells. Ignored by the others. - 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.
- number
Current page number
- number
Items per page
- number
Total matching records (Builder and above)
- 400
VALIDATION_ERROR - 429
RATE_LIMITED - 500
INTERNAL_ERROR
- 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.