FeatureGate

Fetch runtime snapshot

Returns active typed flags and ordered targeting rule groups for the project environment bound to the runtime key. Supports ETag revalidation with If-None-Match.

GEThttps://api.featuregate.dev/v1/snapshot
Authenticate with a server runtime key in the Authorization header.runtime:snapshot

This endpoint takes no parameters.

Request
sh
curl -X GET https://api.featuregate.dev/v1/snapshot \
  -H "Authorization: Bearer fg_sk_test_0123456789abcdef0123456789abcdef0123456789abcdef"

Returns

snapshotobjectrequired
versionstringrequired

Opaque snapshot version used to build ETags.

Length: 1+

projectIdstringrequired

Project bound to the runtime key.

Length: 1+

environmentobjectrequired

Environment bound to the runtime key.

flagsobject[]required
Example response · 200
json
{
  "snapshot": {
    "version": "snapshot_version_example",
    "projectId": "project_example",
    "environment": {
      "id": "env_example",
      "key": "production",
      "name": "Production"
    },
    "flags": []
  }
}

Responses

200A cacheable runtime snapshot for local SDK evaluation.
304The caller's cached snapshot is still current.
400Validation failed.
401Authentication failed.
403The key is not allowed to access this resource.
429Rate limit exceeded.
500Unexpected server error.