ConfigList versions

List versions

Version history, newest first. Only the 3 most recent versions are kept; version numbers keep counting up, so a number is never reused.

curl -X GET "https://mythic-analytics.gulp.workers.dev/client/v1/config/versions?location_id=example_string&limit=50&before=42" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "success": true,
  "data": [
    {
      "version": 5,
      "source": "auto",
      "name": "John Doe",
      "notes": "example_string",
      "created_by": "example_string",
      "restored_from": 42,
      "created_at": "2024-12-25T10:00:00Z"
    }
  ],
  "retention": 3,
  "next_before": 42
}
GET
/client/v1/config/versions
GET
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

Agency key (ak_) or location secret key (sk_). Writes require an agency key. Keys are server-side credentials — this surface serves no CORS headers on purpose. Scoped keys (mcp_) are accepted too and need the tags, snippets or transformers family the route belongs to. See Using an mcp_ key over HTTP.

Agency key (ak_) or location secret key (sk_). Writes require an agency key. Keys are server-side credentials — this surface serves no CORS headers on purpose. Scoped keys (mcp_) are accepted too and need the tags, snippets or transformers family the route belongs to. See Using an mcp_ key over HTTP.
query
location_idstring

Location to scope to. Required for ak_ keys (or send the X-Location-Id header); ignored for sk_.

query
limitinteger
Min: 1 • Max: 200
query
beforeinteger

Return versions older than this number. Pass the previous page's next_before.

Min: 1
Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. Agency key (ak_) or location secret key (sk_). Writes require an agency key. Keys are server-side credentials — this surface serves no CORS headers on purpose. Scoped keys (mcp_) are accepted too and need the tags, snippets or transformers family the route belongs to. See Using an mcp_ key over HTTP.

Query Parameters

location_idstring

Location to scope to. Required for ak_ keys (or send the X-Location-Id header); ignored for sk_.

beforeinteger

Return versions older than this number. Pass the previous page's next_before.

Responses

successboolean
dataarray
retentioninteger

How many of the most recent versions are kept. Older ones are deleted.

next_beforeinteger