Get Flag Usage

curl "https://nest.feather.mupeni.dev/v1/projects/proj_01hx.../flags/new-checkout/usage?environmentId=env_01hx...&from=2024-04-01&to=2024-04-07" \
  -H "Authorization: Bearer <server_key>"

{
  "flagKey": "new-checkout",
  "environmentId": "env_01hx...",
  "from": "2024-04-01",
  "to": "2024-04-07",
  "rows": [
    {
      "date": "2024-04-01",
      "totalEvaluations": 14823,
      "valueDistribution": { "true": 7200, "false": 7623 },
      "ruleMatchCount": 7200,
      "defaultCount": 7623,
      "errorCount": 0
    }
  ]
}

{
  "flagKey": "new-checkout",
  "environmentId": "env_01hx...",
  "from": "2024-03-27",
  "to": "2024-04-03",
  "clampedFrom": true,
  "rows": []
}

GET

projects

{projectId}

flags

{flagKey}

usage

curl "https://nest.feather.mupeni.dev/v1/projects/proj_01hx.../flags/new-checkout/usage?environmentId=env_01hx...&from=2024-04-01&to=2024-04-07" \
  -H "Authorization: Bearer <server_key>"

{
  "flagKey": "new-checkout",
  "environmentId": "env_01hx...",
  "from": "2024-04-01",
  "to": "2024-04-07",
  "rows": [
    {
      "date": "2024-04-01",
      "totalEvaluations": 14823,
      "valueDistribution": { "true": 7200, "false": 7623 },
      "ruleMatchCount": 7200,
      "defaultCount": 7623,
      "errorCount": 0
    }
  ]
}

{
  "flagKey": "new-checkout",
  "environmentId": "env_01hx...",
  "from": "2024-03-27",
  "to": "2024-04-03",
  "clampedFrom": true,
  "rows": []
}

Analytics are aggregated nightly by a background job. Data is not real-time. Retention: clamped to your plan’s analytics window (7 days on Free, 90 days on Pro/Enterprise).

Path parameters

string

required

string

required

Query parameters

string

required

The environment to query.

string

Start date in YYYY-MM-DD format. Defaults to 29 days ago.

string

End date in YYYY-MM-DD format. Defaults to today. Maximum range is 90 days.

Response

string

required

string

required

string

required

Effective start date after plan retention clamping. May differ from the requested from.

string

required

boolean

Present and true when the requested from was earlier than your plan’s retention window and was silently clamped. Absent when no clamping occurred.

UsageDay[]

required

One entry per day that had evaluations. Days with zero evaluations are omitted.

Each UsageDay:

Field	Type	Description
`date`	string	`YYYY-MM-DD`
`totalEvaluations`	number
`valueDistribution`	`Record<string, number>`	Value → count map
`ruleMatchCount`	number	Evaluations resolved by a rule
`defaultCount`	number	Evaluations resolved by `defaultValue`
`errorCount`	number	Evaluations that returned `ERROR` reason

curl "https://nest.feather.mupeni.dev/v1/projects/proj_01hx.../flags/new-checkout/usage?environmentId=env_01hx...&from=2024-04-01&to=2024-04-07" \
  -H "Authorization: Bearer <server_key>"

{
  "flagKey": "new-checkout",
  "environmentId": "env_01hx...",
  "from": "2024-04-01",
  "to": "2024-04-07",
  "rows": [
    {
      "date": "2024-04-01",
      "totalEvaluations": 14823,
      "valueDistribution": { "true": 7200, "false": 7623 },
      "ruleMatchCount": 7200,
      "defaultCount": 7623,
      "errorCount": 0
    }
  ]
}

{
  "flagKey": "new-checkout",
  "environmentId": "env_01hx...",
  "from": "2024-03-27",
  "to": "2024-04-03",
  "clampedFrom": true,
  "rows": []
}

List Audit Log Trigger Sync

Getting Started

Concepts

Management API

Delivery API

Path parameters

Query parameters

Response

​Path parameters

​Query parameters

​Response

Path parameters

Query parameters

Response