Entity Inspector

The Entity Inspector lets you see exactly what a specific user (or entity) would experience when your flags are evaluated. Enter a user key and optional attributes, and the inspector shows the evaluation result for every flag in the selected environment.

Accessing Entity Inspector

Navigate to Entity Inspector in the sidebar.

How It Works

1. Select an environment — Choose the environment to evaluate against (e.g., production)
2. Enter entity details:
   • Entity Key — The unique identifier for the user (the key field in your SDK's evaluation context)
   • Attributes — JSON object of user attributes (e.g., {"plan": "enterprise", "country": "US"})
3. Click Inspect — The server evaluates every active flag for this entity and returns the results

Results Table

The inspector displays a table with one row per flag:

Column	Description
Flag Key	The flag identifier
Value	The value this entity would receive
Reason	Why this value was returned (e.g., TARGETED, ROLLOUT, DISABLED, FALLTHROUGH)
Individually Targeted	Whether the entity matched a specific targeting rule (vs. percentage rollout or default)

Understanding Reasons

Reason	Meaning
TARGETED	The entity matched a targeting rule's conditions
ROLLOUT	The entity fell within the percentage rollout bucket
FALLTHROUGH	No rules matched; the default value was returned
DISABLED	The flag is disabled in this environment
VARIANT	The entity was assigned an A/B experiment variant
MUTUALLY_EXCLUDED	The entity lost the mutual exclusion contest
PREREQUISITE_FAILED	A prerequisite flag was not met

API Equivalent

curl -X POST "http://localhost:8080/v1/projects/$PROJECT_ID/environments/$ENV_ID/inspect-entity" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "entity_key": "user-42",
    "attributes": {
      "plan": "enterprise",
      "country": "US",
      "email": "alice@example.com"
    }
  }'

Use Cases

• Customer support — "What does user X see?" Quickly diagnose flag-related issues without reading code
• QA testing — Verify that targeting rules evaluate correctly for specific test users
• Pre-launch checks — Confirm that a new flag targets the right users before enabling in production
• Debugging — Understand why a specific user is or isn't seeing a feature

Permissions

Requires owner, admin, or developer role to inspect entities.