Organizations
For instructions on how to authenticate to use this endpoint, see API overview.
Endpoints
GET | |
GET | |
GET | |
GET | |
GET | |
PATCH | |
POST | |
POST | |
PATCH | |
GET | |
POST | |
DELETE | |
GET | |
PATCH | |
POST | |
DELETE | |
GET | |
GET | |
PATCH |
Retrieve organizations projects access control members
Every organization member's access in this project. For the project and for each resource type, the response gives the member's own rule and the level that is enforced. It also says where the enforced level comes from: the member's rule, a role's rule, the project default, or full access as an organization admin. Pass member_id for one member.
Required API key scopes
access_control:readPath parameters
- idinteger
Query parameters
- member_idstring
Response
Example request
GET /api /organizations /:organization_id /projects /:id /access_control_membersExample response
Status 200
Retrieve organizations projects access control role objects
Object rules configured for a role: the single objects the role's members are granted or denied, regardless of the resource-level rules.
Required API key scopes
access_control:readPath parameters
- idinteger
Query parameters
- role_idstring
Response
Example request
GET /api /organizations /:organization_id /projects /:id /access_control_role_objectsExample response
Status 200
Retrieve organizations projects access control role properties
Property rules configured for a role: the person and event properties the role's members can read, read and write, or not see.
Required API key scopes
access_control:readPath parameters
- idinteger
Query parameters
- role_idstring
Response
Example request
GET /api /organizations /:organization_id /projects /:id /access_control_role_propertiesExample response
Status 200
Retrieve organizations projects access control roles
Every role's resolved access to this project and to each resource type in it: the role's own rule, the level that is enforced, and the rule the enforced level comes from. Pass role_id for one role.
Required API key scopes
access_control:readPath parameters
- idinteger
Query parameters
- role_idstring
Response
Example request
GET /api /organizations /:organization_id /projects /:id /access_control_rolesExample response
Status 200
Retrieve organizations projects activity
Projects for the current organization.
Path parameters
- idinteger
Response
Example request
GET /api /organizations /:organization_id /projects /:id /activityExample response
Status 200
Update organizations projects add product intent
Projects for the current organization.
Required API key scopes
project:readPath parameters
- idinteger
Request parameters
- namestring
- logo_media_idstring | null
- product_descriptionstring | null
- tagsarray
- app_urlsarray
- anonymize_ipsboolean
- completed_snippet_onboardingboolean
- test_account_filters
- test_account_filters_default_checkedboolean | null
- path_cleaning_filters
- is_demoboolean
- timezone
- data_attributes
- person_display_name_propertiesarray | null
- autocapture_opt_outboolean | null
- autocapture_exceptions_opt_inboolean | null
- autocapture_web_vitals_opt_inboolean | null
- autocapture_web_vitals_allowed_metrics
- autocapture_exceptions_errors_to_ignore
- capture_console_log_opt_inboolean | null
- capture_performance_opt_inboolean | null
- session_recording_opt_inboolean
- session_recording_sample_ratestring | null
- session_recording_minimum_duration_millisecondsinteger | null
- session_recording_linked_flag
- session_recording_network_payload_capture_config
- session_recording_masking_config
- session_recording_url_trigger_configarray | null
- session_recording_url_blocklist_configarray | null
- session_recording_event_trigger_configarray | null
- session_recording_trigger_match_type_configstring | null
- session_recording_trigger_groups
- session_recording_retention_period
- session_replay_config
- survey_config
- access_controlboolean
- week_start_day
- primary_dashboardinteger | null
- home_tab_dashboardinteger | null
- live_events_columnsarray | null
- recording_domainsarray | null
- inject_web_appsboolean | null
- extra_settings
- modifiers
- has_completed_onboarding_for
- surveys_opt_inboolean | null
- heatmaps_opt_inboolean | null
- flags_persistence_defaultboolean | null
- receive_org_level_activity_logsboolean | null
- business_model
- conversations_enabledboolean | null
- conversations_settingsobject | null
- logs_settings
- proactive_tasks_enabledboolean | null
- revenue_analytics_config
- marketing_analytics_config
- customer_analytics_config
- workflows_config
- feature_flag_policy_config
- base_currency
- capture_dead_clicksboolean | null
- cookieless_server_hash_mode
- human_friendly_comparison_periodsboolean | null
- feature_flag_confirmation_enabledboolean | null
- feature_flag_confirmation_messagestring | null
- default_evaluation_contexts_enabledboolean | null
- require_evaluation_contextsboolean | null
- default_data_themeinteger | null
- onboarding_tasks
- web_analytics_pre_aggregated_tables_enabledboolean | null
Response
Example request
PATCH /api /organizations /:organization_id /projects /:id /add_product_intentExample response
Status 200
Create organizations projects cancel deletion
Cancel a scheduled project deletion and restore access to the project.
Path parameters
- idinteger
Response
Example request
POST /api /organizations /:organization_id /projects /:id /cancel-deletionExample response
Status 200
Create organizations projects change organization
Projects for the current organization.
Path parameters
- idinteger
Request parameters
- namestring
- logo_media_idstring | null
- product_descriptionstring | null
- tagsarray
- app_urlsarray
- anonymize_ipsboolean
- completed_snippet_onboardingboolean
- test_account_filters
- test_account_filters_default_checkedboolean | null
- path_cleaning_filters
- is_demoboolean
- timezone
- data_attributes
- person_display_name_propertiesarray | null
- autocapture_opt_outboolean | null
- autocapture_exceptions_opt_inboolean | null
- autocapture_web_vitals_opt_inboolean | null
- autocapture_web_vitals_allowed_metrics
- autocapture_exceptions_errors_to_ignore
- capture_console_log_opt_inboolean | null
- capture_performance_opt_inboolean | null
- session_recording_opt_inboolean
- session_recording_sample_ratestring | null
- session_recording_minimum_duration_millisecondsinteger | null
- session_recording_linked_flag
- session_recording_network_payload_capture_config
- session_recording_masking_config
- session_recording_url_trigger_configarray | null
- session_recording_url_blocklist_configarray | null
- session_recording_event_trigger_configarray | null
- session_recording_trigger_match_type_configstring | null
- session_recording_trigger_groups
- session_recording_retention_period
- session_replay_config
- survey_config
- access_controlboolean
- week_start_day
- primary_dashboardinteger | null
- home_tab_dashboardinteger | null
- live_events_columnsarray | null
- recording_domainsarray | null
- inject_web_appsboolean | null
- extra_settings
- modifiers
- has_completed_onboarding_for
- surveys_opt_inboolean | null
- heatmaps_opt_inboolean | null
- flags_persistence_defaultboolean | null
- receive_org_level_activity_logsboolean | null
- business_model
- conversations_enabledboolean | null
- conversations_settingsobject | null
- logs_settings
- proactive_tasks_enabledboolean | null
- revenue_analytics_config
- marketing_analytics_config
- customer_analytics_config
- workflows_config
- feature_flag_policy_config
- base_currency
- capture_dead_clicksboolean | null
- cookieless_server_hash_mode
- human_friendly_comparison_periodsboolean | null
- feature_flag_confirmation_enabledboolean | null
- feature_flag_confirmation_messagestring | null
- default_evaluation_contexts_enabledboolean | null
- require_evaluation_contextsboolean | null
- default_data_themeinteger | null
- onboarding_tasks
- web_analytics_pre_aggregated_tables_enabledboolean | null
Response
Example request
POST /api /organizations /:organization_id /projects /:id /change_organizationExample response
Status 200
Update organizations projects complete product onboarding
Projects for the current organization.
Required API key scopes
project:readPath parameters
- idinteger
Request parameters
- namestring
- logo_media_idstring | null
- product_descriptionstring | null
- tagsarray
- app_urlsarray
- anonymize_ipsboolean
- completed_snippet_onboardingboolean
- test_account_filters
- test_account_filters_default_checkedboolean | null
- path_cleaning_filters
- is_demoboolean
- timezone
- data_attributes
- person_display_name_propertiesarray | null
- autocapture_opt_outboolean | null
- autocapture_exceptions_opt_inboolean | null
- autocapture_web_vitals_opt_inboolean | null
- autocapture_web_vitals_allowed_metrics
- autocapture_exceptions_errors_to_ignore
- capture_console_log_opt_inboolean | null
- capture_performance_opt_inboolean | null
- session_recording_opt_inboolean
- session_recording_sample_ratestring | null
- session_recording_minimum_duration_millisecondsinteger | null
- session_recording_linked_flag
- session_recording_network_payload_capture_config
- session_recording_masking_config
- session_recording_url_trigger_configarray | null
- session_recording_url_blocklist_configarray | null
- session_recording_event_trigger_configarray | null
- session_recording_trigger_match_type_configstring | null
- session_recording_trigger_groups
- session_recording_retention_period
- session_replay_config
- survey_config
- access_controlboolean
- week_start_day
- primary_dashboardinteger | null
- home_tab_dashboardinteger | null
- live_events_columnsarray | null
- recording_domainsarray | null
- inject_web_appsboolean | null
- extra_settings
- modifiers
- has_completed_onboarding_for
- surveys_opt_inboolean | null
- heatmaps_opt_inboolean | null
- flags_persistence_defaultboolean | null
- receive_org_level_activity_logsboolean | null
- business_model
- conversations_enabledboolean | null
- conversations_settingsobject | null
- logs_settings
- proactive_tasks_enabledboolean | null
- revenue_analytics_config
- marketing_analytics_config
- customer_analytics_config
- workflows_config
- feature_flag_policy_config
- base_currency
- capture_dead_clicksboolean | null
- cookieless_server_hash_mode
- human_friendly_comparison_periodsboolean | null
- feature_flag_confirmation_enabledboolean | null
- feature_flag_confirmation_messagestring | null
- default_evaluation_contexts_enabledboolean | null
- require_evaluation_contextsboolean | null
- default_data_themeinteger | null
- onboarding_tasks
- web_analytics_pre_aggregated_tables_enabledboolean | null
Response
Example request
PATCH /api /organizations /:organization_id /projects /:id /complete_product_onboardingExample response
Status 200
Retrieve organizations projects default evaluation contexts
Manage default evaluation contexts for a project. Members can read; writing requires project admin, matching the admin-only settings UI.
Path parameters
- idinteger
Response
Example request
GET /api /organizations /:organization_id /projects /:id /default_evaluation_contextsExample response
Status 200
Create organizations projects default evaluation contexts
Manage default evaluation contexts for a project. Members can read; writing requires project admin, matching the admin-only settings UI.
Path parameters
- idinteger
Request parameters
- namestring
- logo_media_idstring | null
- product_descriptionstring | null
- tagsarray
- app_urlsarray
- anonymize_ipsboolean
- completed_snippet_onboardingboolean
- test_account_filters
- test_account_filters_default_checkedboolean | null
- path_cleaning_filters
- is_demoboolean
- timezone
- data_attributes
- person_display_name_propertiesarray | null
- autocapture_opt_outboolean | null
- autocapture_exceptions_opt_inboolean | null
- autocapture_web_vitals_opt_inboolean | null
- autocapture_web_vitals_allowed_metrics
- autocapture_exceptions_errors_to_ignore
- capture_console_log_opt_inboolean | null
- capture_performance_opt_inboolean | null
- session_recording_opt_inboolean
- session_recording_sample_ratestring | null
- session_recording_minimum_duration_millisecondsinteger | null
- session_recording_linked_flag
- session_recording_network_payload_capture_config
- session_recording_masking_config
- session_recording_url_trigger_configarray | null
- session_recording_url_blocklist_configarray | null
- session_recording_event_trigger_configarray | null
- session_recording_trigger_match_type_configstring | null
- session_recording_trigger_groups
- session_recording_retention_period
- session_replay_config
- survey_config
- access_controlboolean
- week_start_day
- primary_dashboardinteger | null
- home_tab_dashboardinteger | null
- live_events_columnsarray | null
- recording_domainsarray | null
- inject_web_appsboolean | null
- extra_settings
- modifiers
- has_completed_onboarding_for
- surveys_opt_inboolean | null
- heatmaps_opt_inboolean | null
- flags_persistence_defaultboolean | null
- receive_org_level_activity_logsboolean | null
- business_model
- conversations_enabledboolean | null
- conversations_settingsobject | null
- logs_settings
- proactive_tasks_enabledboolean | null
- revenue_analytics_config
- marketing_analytics_config
- customer_analytics_config
- workflows_config
- feature_flag_policy_config
- base_currency
- capture_dead_clicksboolean | null
- cookieless_server_hash_mode
- human_friendly_comparison_periodsboolean | null
- feature_flag_confirmation_enabledboolean | null
- feature_flag_confirmation_messagestring | null
- default_evaluation_contexts_enabledboolean | null
- require_evaluation_contextsboolean | null
- default_data_themeinteger | null
- onboarding_tasks
- web_analytics_pre_aggregated_tables_enabledboolean | null
Response
Example request
POST /api /organizations /:organization_id /projects /:id /default_evaluation_contextsExample response
Status 200
Delete organizations projects default evaluation contexts
Manage default evaluation contexts for a project. Members can read; writing requires project admin, matching the admin-only settings UI.
Path parameters
- idinteger
Example request
DELETE /api /organizations /:organization_id /projects /:id /default_evaluation_contextsExample response
Status 204 No response body
Retrieve organizations projects default release conditions
Manage default release conditions for new feature flags in this project. Members can read; writing requires project admin, matching the admin-only settings UI.
Path parameters
- idinteger
Response
Example request
GET /api /organizations /:organization_id /projects /:id /default_release_conditionsExample response
Status 200
Update organizations projects delete secret token backup
Projects for the current organization.
Path parameters
- idinteger
Request parameters
- namestring
- logo_media_idstring | null
- product_descriptionstring | null
- tagsarray
- app_urlsarray
- anonymize_ipsboolean
- completed_snippet_onboardingboolean
- test_account_filters
- test_account_filters_default_checkedboolean | null
- path_cleaning_filters
- is_demoboolean
- timezone
- data_attributes
- person_display_name_propertiesarray | null
- autocapture_opt_outboolean | null
- autocapture_exceptions_opt_inboolean | null
- autocapture_web_vitals_opt_inboolean | null
- autocapture_web_vitals_allowed_metrics
- autocapture_exceptions_errors_to_ignore
- capture_console_log_opt_inboolean | null
- capture_performance_opt_inboolean | null
- session_recording_opt_inboolean
- session_recording_sample_ratestring | null
- session_recording_minimum_duration_millisecondsinteger | null
- session_recording_linked_flag
- session_recording_network_payload_capture_config
- session_recording_masking_config
- session_recording_url_trigger_configarray | null
- session_recording_url_blocklist_configarray | null
- session_recording_event_trigger_configarray | null
- session_recording_trigger_match_type_configstring | null
- session_recording_trigger_groups
- session_recording_retention_period
- session_replay_config
- survey_config
- access_controlboolean
- week_start_day
- primary_dashboardinteger | null
- home_tab_dashboardinteger | null
- live_events_columnsarray | null
- recording_domainsarray | null
- inject_web_appsboolean | null
- extra_settings
- modifiers
- has_completed_onboarding_for
- surveys_opt_inboolean | null
- heatmaps_opt_inboolean | null
- flags_persistence_defaultboolean | null
- receive_org_level_activity_logsboolean | null
- business_model
- conversations_enabledboolean | null
- conversations_settingsobject | null
- logs_settings
- proactive_tasks_enabledboolean | null
- revenue_analytics_config
- marketing_analytics_config
- customer_analytics_config
- workflows_config
- feature_flag_policy_config
- base_currency
- capture_dead_clicksboolean | null
- cookieless_server_hash_mode
- human_friendly_comparison_periodsboolean | null
- feature_flag_confirmation_enabledboolean | null
- feature_flag_confirmation_messagestring | null
- default_evaluation_contexts_enabledboolean | null
- require_evaluation_contextsboolean | null
- default_data_themeinteger | null
- onboarding_tasks
- web_analytics_pre_aggregated_tables_enabledboolean | null
Response
Example request
PATCH /api /organizations /:organization_id /projects /:id /delete_secret_token_backupExample response
Status 200
Create organizations projects evaluation context suggestions
Hide an evaluation context name from the flag editor's suggestion list, or restore it.
POST hides the name; DELETE restores it. The underlying context row and any flags already using it are never modified — this only controls what gets suggested.
Path parameters
- idinteger
Request parameters
- context_namestring
Response
Example request
POST /api /organizations /:organization_id /projects /:id /evaluation_context_suggestionsExample response
Status 200
Delete organizations projects evaluation context suggestions
Hide an evaluation context name from the flag editor's suggestion list, or restore it.
POST hides the name; DELETE restores it. The underlying context row and any flags already using it are never modified — this only controls what gets suggested.
Path parameters
- idinteger
Query parameters
- context_namestring
Response
Example request
DELETE /api /organizations /:organization_id /projects /:id /evaluation_context_suggestionsExample response
Status 200
List all organizations projects event ingestion restrictions
Projects for the current organization.
Required API key scopes
project:readPath parameters
- idinteger
Query parameters
- searchstring
Example request
GET /api /organizations /:organization_id /projects /:id /event_ingestion_restrictionsExample response
Status 200
Retrieve organizations projects experiments config
Manage experiment configuration for this project.
Path parameters
- idinteger
Response
Example request
GET /api /organizations /:organization_id /projects /:id /experiments_configExample response
Status 200
Update organizations projects experiments config
Manage experiment configuration for this project.
Path parameters
- idinteger
Request parameters
- namestring
- logo_media_idstring | null
- product_descriptionstring | null
- tagsarray
- app_urlsarray
- anonymize_ipsboolean
- completed_snippet_onboardingboolean
- test_account_filters
- test_account_filters_default_checkedboolean | null
- path_cleaning_filters
- is_demoboolean
- timezone
- data_attributes
- person_display_name_propertiesarray | null
- autocapture_opt_outboolean | null
- autocapture_exceptions_opt_inboolean | null
- autocapture_web_vitals_opt_inboolean | null
- autocapture_web_vitals_allowed_metrics
- autocapture_exceptions_errors_to_ignore
- capture_console_log_opt_inboolean | null
- capture_performance_opt_inboolean | null
- session_recording_opt_inboolean
- session_recording_sample_ratestring | null
- session_recording_minimum_duration_millisecondsinteger | null
- session_recording_linked_flag
- session_recording_network_payload_capture_config
- session_recording_masking_config
- session_recording_url_trigger_configarray | null
- session_recording_url_blocklist_configarray | null
- session_recording_event_trigger_configarray | null
- session_recording_trigger_match_type_configstring | null
- session_recording_trigger_groups
- session_recording_retention_period
- session_replay_config
- survey_config
- access_controlboolean
- week_start_day
- primary_dashboardinteger | null
- home_tab_dashboardinteger | null
- live_events_columnsarray | null
- recording_domainsarray | null
- inject_web_appsboolean | null
- extra_settings
- modifiers
- has_completed_onboarding_for
- surveys_opt_inboolean | null
- heatmaps_opt_inboolean | null
- flags_persistence_defaultboolean | null
- receive_org_level_activity_logsboolean | null
- business_model
- conversations_enabledboolean | null
- conversations_settingsobject | null
- logs_settings
- proactive_tasks_enabledboolean | null
- revenue_analytics_config
- marketing_analytics_config
- customer_analytics_config
- workflows_config
- feature_flag_policy_config
- base_currency
- capture_dead_clicksboolean | null
- cookieless_server_hash_mode
- human_friendly_comparison_periodsboolean | null
- feature_flag_confirmation_enabledboolean | null
- feature_flag_confirmation_messagestring | null
- default_evaluation_contexts_enabledboolean | null
- require_evaluation_contextsboolean | null
- default_data_themeinteger | null
- onboarding_tasks
- web_analytics_pre_aggregated_tables_enabledboolean | null
Response
Example request
PATCH /api /organizations /:organization_id /projects /:id /experiments_config










