How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

PostHog feature_flags API

The feature_flags API from PostHog — 19 operation(s) for feature_flags.

PostHog feature_flags API is one of 139 APIs that PostHog publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

Tagged areas include Feature Flags. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a getting-started guide, authentication docs, and an AsyncAPI specification.

This API exposes 23 operations across 19 paths, and defines 52 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against a single base URL, https://app.posthog.com/api.

23 operations 19 paths 52 schemas 1 DELETE12 GET1 PATCH8 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://app.posthog.com/api
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

PostHog feature_flags API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (PersonalAPIKeyAuth).

Paths & Operations 23

Across 19 paths, the API surfaces 23 operations — 1 DELETE, 12 GET, 1 PATCH, 8 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

feature_flags 23
GET
/api/projects/{project_id}/feature_flags/
Create, read, update and delete feature flags. [See docs](https://posthog.com/docs/feature-flags) for more information on feature flags. If you're looking to use feature flags on your application, yo…
feature_flags_list 11 params → 200
POST
/api/projects/{project_id}/feature_flags/
Create, read, update and delete feature flags. [See docs](https://posthog.com/docs/feature-flags) for more information on feature flags. If you're looking to use feature flags on your application, yo…
feature_flags_create 1 param body → 201
GET
/api/projects/{project_id}/feature_flags/{id}/
Create, read, update and delete feature flags. [See docs](https://posthog.com/docs/feature-flags) for more information on feature flags. If you're looking to use feature flags on your application, yo…
feature_flags_retrieve 2 params → 200
PUT
/api/projects/{project_id}/feature_flags/{id}/
Create, read, update and delete feature flags. [See docs](https://posthog.com/docs/feature-flags) for more information on feature flags. If you're looking to use feature flags on your application, yo…
feature_flags_update 2 params body → 200
PATCH
/api/projects/{project_id}/feature_flags/{id}/
Create, read, update and delete feature flags. [See docs](https://posthog.com/docs/feature-flags) for more information on feature flags. If you're looking to use feature flags on your application, yo…
feature_flags_partial_update 2 params body → 200
DELETE
/api/projects/{project_id}/feature_flags/{id}/
Hard delete of this model is not allowed. Use a patch API call to set "deleted" to true
feature_flags_destroy 2 params → 405
GET
/api/projects/{project_id}/feature_flags/{id}/activity/
Create, read, update and delete feature flags. [See docs](https://posthog.com/docs/feature-flags) for more information on feature flags. If you're looking to use feature flags on your application, yo…
feature_flags_activity_retrieve 4 params → 200404
POST
/api/projects/{project_id}/feature_flags/{id}/create_static_cohort_for_flag/
Create, read, update and delete feature flags. [See docs](https://posthog.com/docs/feature-flags) for more information on feature flags. If you're looking to use feature flags on your application, yo…
feature_flags_create_static_cohort_for_flag_create 2 params body → 200
POST
/api/projects/{project_id}/feature_flags/{id}/dashboard/
Create, read, update and delete feature flags. [See docs](https://posthog.com/docs/feature-flags) for more information on feature flags. If you're looking to use feature flags on your application, yo…
feature_flags_dashboard_create 2 params body → 200
GET
/api/projects/{project_id}/feature_flags/{id}/dependent_flags/
Get other active flags that depend on this flag.
feature_flags_dependent_flags_list 2 params → 200
POST
/api/projects/{project_id}/feature_flags/{id}/enrich_usage_dashboard/
Create, read, update and delete feature flags. [See docs](https://posthog.com/docs/feature-flags) for more information on feature flags. If you're looking to use feature flags on your application, yo…
feature_flags_enrich_usage_dashboard_create 2 params body → 200
GET
/api/projects/{project_id}/feature_flags/{id}/remote_config/
Create, read, update and delete feature flags. [See docs](https://posthog.com/docs/feature-flags) for more information on feature flags. If you're looking to use feature flags on your application, yo…
feature_flags_remote_config_retrieve 2 params → 200
GET
/api/projects/{project_id}/feature_flags/{id}/status/
Create, read, update and delete feature flags. [See docs](https://posthog.com/docs/feature-flags) for more information on feature flags. If you're looking to use feature flags on your application, yo…
feature_flags_status_retrieve 2 params → 200
GET
/api/projects/{project_id}/feature_flags/{id}/versions/{version_number}/
Create, read, update and delete feature flags. [See docs](https://posthog.com/docs/feature-flags) for more information on feature flags. If you're looking to use feature flags on your application, yo…
feature_flags_versions_retrieve 3 params → 200400404422
GET
/api/projects/{project_id}/feature_flags/activity/
Create, read, update and delete feature flags. [See docs](https://posthog.com/docs/feature-flags) for more information on feature flags. If you're looking to use feature flags on your application, yo…
feature_flags_all_activity_retrieve 3 params → 200
POST
/api/projects/{project_id}/feature_flags/bulk_delete/
Bulk delete feature flags by filter criteria or explicit IDs. Accepts either: - {"filters": {...}} - Same filter params as list endpoint (search, active, type, etc.) - {"ids": [...]} - Explicit list…
feature_flags_bulk_delete_create 1 param body → 200
POST
/api/projects/{project_id}/feature_flags/bulk_keys/
Get feature flag keys by IDs. Accepts a list of feature flag IDs and returns a mapping of ID to key.
feature_flags_bulk_keys_create 1 param body → 200
POST
/api/projects/{project_id}/feature_flags/bulk_update_tags/
Bulk update tags on multiple objects. Accepts: - {"ids": [...], "action": "add"|"remove"|"set", "tags": ["tag1", "tag2"]} Actions: - "add": Add tags to existing tags on each object - "remove": Remove…
feature_flags_bulk_update_tags_create 1 param body → 200
GET
/api/projects/{project_id}/feature_flags/evaluation_reasons/
Create, read, update and delete feature flags. [See docs](https://posthog.com/docs/feature-flags) for more information on feature flags. If you're looking to use feature flags on your application, yo…
feature_flags_evaluation_reasons_retrieve 3 params → 200
GET
/api/projects/{project_id}/feature_flags/local_evaluation/
Create, read, update and delete feature flags. [See docs](https://posthog.com/docs/feature-flags) for more information on feature flags. If you're looking to use feature flags on your application, yo…
feature_flags_local_evaluation_retrieve 2 params → 200402500
GET
/api/projects/{project_id}/feature_flags/matching_ids/
Get IDs of all feature flags matching the current filters. Uses the same filtering logic as the list endpoint. Returns only IDs that the user has permission to edit.
feature_flags_matching_ids_retrieve 1 param → 200
GET
/api/projects/{project_id}/feature_flags/my_flags/
Create, read, update and delete feature flags. [See docs](https://posthog.com/docs/feature-flags) for more information on feature flags. If you're looking to use feature flags on your application, yo…
feature_flags_my_flags_retrieve 2 params → 200
POST
/api/projects/{project_id}/feature_flags/user_blast_radius/
Create, read, update and delete feature flags. [See docs](https://posthog.com/docs/feature-flags) for more information on feature flags. If you're looking to use feature flags on your application, yo…
feature_flags_user_blast_radius_create 1 param body → 200

Schemas 52

The contract defines 52 schemas that model the data the API accepts and returns. The most detailed are FeatureFlag (35 properties), FeatureFlagVersionResponse (21 properties), MinimalFeatureFlag (13 properties), UserBasic (9 properties). Each schema is shown below with its type and property counts.

NullEnum
FeatureFlagMultivariateSchema
object
1 property 1 required
FeatureFlagVersionResponse
object
Feature flag state at a given version plus reconstruction metadata.
21 properties 7 required
FeatureFlagFilterPropertyFlagEvaluatesSchemaOperatorEnum
string
flagevaluatesto - flagevaluatesto
Trigger
object
3 properties 3 required
BulkUpdateTagsResponse
object
2 properties 2 required
BulkUpdateTagsError
object
2 properties 2 required
FeatureFlagFiltersSchema
object
6 properties
PropertyGroupTypeEnum
string
cohort - cohort person - person group - group
DateOperatorEnum
string
isdateexact - isdateexact isdatebefore - isdatebefore isdateafter - isdateafter
Merge
object
3 properties 3 required
ActionEnum
string
add - add remove - remove set - set
FeatureFlagFilterPropertyFlagEvaluatesSchemaTypeEnum
string
flag - flag
FeatureFlagFilterPropertySemverSchema
object
6 properties 3 required
BulkUpdateTagsRequest
object
3 properties 3 required
UserBlastRadiusResponse
object
2 properties 2 required
Change
object
5 properties 5 required
FeatureFlagConditionGroupSchema
object
4 properties
MinimalFeatureFlag
object
13 properties 4 required
ActivityLogEntry
object
7 properties 6 required
Detail
object
7 properties 4 required
FeatureFlagFilterPropertyCohortInSchemaOperatorEnum
string
in - in notin - notin
ExistenceOperatorEnum
string
isset - isset isnotset - isnotset
UserBlastRadiusRequest
object
2 properties 1 required
PatchedFeatureFlagPartialUpdateRequestSchema
object
6 properties
PaginatedFeatureFlagList
object
4 properties 2 required
FeatureFlagFilterPropertyCohortInSchema
object
6 properties 4 required
FeatureFlag
object
Serializer mixin that handles tags for objects.
35 properties 14 required
BucketingIdentifierEnum
string
distinctid - User ID (default) deviceid - Device ID
FeatureFlagStatusResponse
object
2 properties 2 required
DependentFlag
object
3 properties 3 required
FeatureFlagFilterPropertyExistsSchema
object
6 properties 2 required
FeatureFlagCreateRequestSchema
object
6 properties
FeatureFlagFilterPropertyGenericSchemaOperatorEnum
string
exact - exact isnot - isnot icontains - icontains noticontains - noticontains regex - regex notregex - notregex gt - gt gte - gte lt - lt lte - lte
LocalEvaluationResponse
object
3 properties 3 required
MyFlagsResponse
object
2 properties 2 required
BulkUpdateTagsItem
object
2 properties 2 required
FeatureFlagMultivariateVariantSchema
object
3 properties 2 required
UserBasic
object
9 properties 4 required
FeatureFlagFilterPropertyMultiContainsSchema
object
6 properties 3 required
FeatureFlagFilterPropertyCohortInSchemaTypeEnum
string
cohort - cohort
BlankEnum
RoleAtOrganizationEnum
string
engineering - Engineering data - Data product - Product Management founder - Founder leadership - Leadership marketing - Marketing sales - Sales / Success othe…
FeatureFlagFilterPropertyFlagEvaluatesSchema
object
6 properties 4 required
FeatureFlagFilterPropertyMultiContainsSchemaOperatorEnum
string
icontainsmulti - icontainsmulti noticontainsmulti - noticontainsmulti
FeatureFlagFilterPropertyGenericSchema
object
6 properties 3 required
EvaluationRuntimeEnum
string
server - Server client - Client all - All
FeatureFlagFilterPropertySchema
ActivityLogPaginatedResponse
object
Response shape for paginated activity log endpoints.
4 properties 4 required
FeatureFlagFilterPropertySemverSchemaOperatorEnum
string
semvergt - semvergt semvergte - semvergte semverlt - semverlt semverlte - semverlte semvereq - semvereq semverneq - semverneq semvertilde - semvertilde semverc…
FeatureFlagFilterPropertyDateSchema
object
6 properties 3 required
FeatureFlagCreationContextEnum
string
featureflags - featureflags experiments - experiments surveys - surveys earlyaccessfeatures - earlyaccessfeatures webexperiments - webexperiments producttours…

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

posthog-feature-flags-api-openapi.yml Raw ↑

Other APIs PostHog publishes across the network.

PostHog Capture API
PostHog Query API
PostHog Persons API
PostHog Feature Flags API
PostHog Experiments API
PostHog Insights API
PostHog Cohorts API
PostHog Annotations API
PostHog actions API
PostHog activity_log API
PostHog activity_logs API
PostHog advanced_activity_logs API
Where this information came from

This is an independent, third-party profile of PostHog feature_flags API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.