List feature flags (internal)

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://docs.usehearsay.com/mcp

Standard setup for AI tools providing an mcp.json file

{
  "integrations MCP server": {
    "url": "https://docs.usehearsay.com/mcp"
  }
}

GET /admin/feature-flags

Access token

Lists every feature flag this build defines plus any leftover rows, unpaginated. status says whether a flag has its database row (SEEDED), is still waiting on its seed migration (UNSEEDED, reads as off) or is a leftover from a retired flag (ORPHANED). Super admin only.

Responses

200 application/json
Hide response attributes Show response attributes object
- data object Required
  
  Hide data attributes Show data attributes object
  
  flags array[object] Required
  
  Hide flags attributes Show flags attributes object
  
  key string Required
  
  The flag key, e.g. "clio-integration"
  
  enabled boolean Required
  
  Effective value. An UNSEEDED flag reads false because no row exists.
  
  description string | null Required
  
  status string Required
  
  SEEDED = defined in code and backed by a row; UNSEEDED = defined in code, no row yet (toggling creates it); ORPHANED = a leftover row this build no longer defines, so it cannot be toggled. Derived at read time, never stored.
  
  Values are SEEDED, UNSEEDED, or ORPHANED.
  
  updatedAt string(date-time) | null Required
  
  updatedByEmail string | null Required
  
  Admin who last toggled the flag. Null on rows a seed migration created and no one has changed since.
  
  total number Required
  
  Number of flags returned
- statusCode number Required
- timestamp string(date-time) Required

GET /admin/feature-flags

curl \
 --request GET 'http://api.example.com/admin/feature-flags' \
 --header "Authorization: Bearer $ACCESS_TOKEN"

Response examples (200)

{
  "data": {
    "flags": [
      {
        "key": "clio-integration",
        "enabled": true,
        "description": "Turns on the Clio integration",
        "status": "SEEDED",
        "updatedAt": "2026-01-15T10:15:00.000Z",
        "updatedByEmail": "admin@example.com"
      }
    ],
    "total": 24
  },
  "statusCode": 200,
  "timestamp": "2026-01-15T10:15:00.000Z"
}