Returns a list of projects in your organization.
To get your organization ID, use the /api/organizations/@current
endpoint or check the endpoint directly on US Cloud or EU Cloud.
For instructions on how to authenticate to use this endpoint, see API overview.
Projects for the current organization.
Returns a list of projects in your organization.
To get your organization ID, use the /api/organizations/@current
endpoint or check the endpoint directly on US Cloud or EU Cloud.
project:read
Number of results to return per page.
The initial index from which to return the results.
GET
/api /organizations /:organization_id /projects
export POSTHOG_PERSONAL_API_KEY=[your personal api key]curl \-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \<ph_app_host>/api/organizations/:organization_id/projects/
{"count": 123,"next": "http://api.example.org/accounts/?offset=400&limit=100","previous": "http://api.example.org/accounts/?offset=200&limit=100","results": [{"id": 0,"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f","organization": "452c1a86-a0af-475b-b03f-724878b0f387","api_token": "string","name": "string","completed_snippet_onboarding": true,"has_completed_onboarding_for": null,"ingested_event": true,"is_demo": true,"timezone": "Africa/Abidjan","access_control": true}]}
In most cases, we recommend using a single project across your product, but if you want to programmatically create multiple projects, this is the endpoint for you.
To get your organization ID, use the /api/organizations/@current
endpoint or check the endpoint directly on US Cloud or EU Cloud.
project:write
POST
/api /organizations /:organization_id /projects
export POSTHOG_PERSONAL_API_KEY=[your personal api key]curl-H 'Content-Type: application/json'\-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \<ph_app_host>/api/organizations/:organization_id/projects/\-d organization="string"
{"id": 0,"organization": "452c1a86-a0af-475b-b03f-724878b0f387","name": "string","product_description": "string","created_at": "2019-08-24T14:15:22Z","effective_membership_level": 1,"has_group_types": true,"live_events_token": "string","updated_at": "2019-08-24T14:15:22Z","uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f","api_token": "string","app_urls": ["string"],"slack_incoming_webhook": "string","anonymize_ips": true,"completed_snippet_onboarding": true,"ingested_event": true,"test_account_filters": null,"test_account_filters_default_checked": true,"path_cleaning_filters": null,"is_demo": true,"timezone": "Africa/Abidjan","data_attributes": null,"person_display_name_properties": ["string"],"correlation_config": null,"autocapture_opt_out": true,"autocapture_exceptions_opt_in": true,"autocapture_web_vitals_opt_in": true,"autocapture_web_vitals_allowed_metrics": null,"autocapture_exceptions_errors_to_ignore": null,"capture_console_log_opt_in": true,"capture_performance_opt_in": true,"session_recording_opt_in": true,"session_recording_sample_rate": "string","session_recording_minimum_duration_milliseconds": 15000,"session_recording_linked_flag": null,"session_recording_network_payload_capture_config": null,"session_replay_config": null,"survey_config": null,"access_control": true,"week_start_day": 0,"primary_dashboard": 0,"live_events_columns": ["string"],"recording_domains": ["string"],"person_on_events_querying_enabled": "string","inject_web_apps": true,"extra_settings": null,"modifiers": null,"default_modifiers": "string","has_completed_onboarding_for": null,"surveys_opt_in": true,"heatmaps_opt_in": true,"product_intents": "string"}
project:read
A unique value identifying this project.
GET
/api /organizations /:organization_id /projects /:id
export POSTHOG_PERSONAL_API_KEY=[your personal api key]curl \-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \<ph_app_host>/api/organizations/:organization_id/projects/:id/
{"id": 0,"organization": "452c1a86-a0af-475b-b03f-724878b0f387","name": "string","product_description": "string","created_at": "2019-08-24T14:15:22Z","effective_membership_level": 1,"has_group_types": true,"live_events_token": "string","updated_at": "2019-08-24T14:15:22Z","uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f","api_token": "string","app_urls": ["string"],"slack_incoming_webhook": "string","anonymize_ips": true,"completed_snippet_onboarding": true,"ingested_event": true,"test_account_filters": null,"test_account_filters_default_checked": true,"path_cleaning_filters": null,"is_demo": true,"timezone": "Africa/Abidjan","data_attributes": null,"person_display_name_properties": ["string"],"correlation_config": null,"autocapture_opt_out": true,"autocapture_exceptions_opt_in": true,"autocapture_web_vitals_opt_in": true,"autocapture_web_vitals_allowed_metrics": null,"autocapture_exceptions_errors_to_ignore": null,"capture_console_log_opt_in": true,"capture_performance_opt_in": true,"session_recording_opt_in": true,"session_recording_sample_rate": "string","session_recording_minimum_duration_milliseconds": 15000,"session_recording_linked_flag": null,"session_recording_network_payload_capture_config": null,"session_replay_config": null,"survey_config": null,"access_control": true,"week_start_day": 0,"primary_dashboard": 0,"live_events_columns": ["string"],"recording_domains": ["string"],"person_on_events_querying_enabled": "string","inject_web_apps": true,"extra_settings": null,"modifiers": null,"default_modifiers": "string","has_completed_onboarding_for": null,"surveys_opt_in": true,"heatmaps_opt_in": true,"product_intents": "string"}
project:write
A unique value identifying this project.
PATCH
/api /organizations /:organization_id /projects /:id
export POSTHOG_PERSONAL_API_KEY=[your personal api key]curl -X PATCH \-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \<ph_app_host>/api/organizations/:organization_id/projects/:id/\-d organization="string"
{"id": 0,"organization": "452c1a86-a0af-475b-b03f-724878b0f387","name": "string","product_description": "string","created_at": "2019-08-24T14:15:22Z","effective_membership_level": 1,"has_group_types": true,"live_events_token": "string","updated_at": "2019-08-24T14:15:22Z","uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f","api_token": "string","app_urls": ["string"],"slack_incoming_webhook": "string","anonymize_ips": true,"completed_snippet_onboarding": true,"ingested_event": true,"test_account_filters": null,"test_account_filters_default_checked": true,"path_cleaning_filters": null,"is_demo": true,"timezone": "Africa/Abidjan","data_attributes": null,"person_display_name_properties": ["string"],"correlation_config": null,"autocapture_opt_out": true,"autocapture_exceptions_opt_in": true,"autocapture_web_vitals_opt_in": true,"autocapture_web_vitals_allowed_metrics": null,"autocapture_exceptions_errors_to_ignore": null,"capture_console_log_opt_in": true,"capture_performance_opt_in": true,"session_recording_opt_in": true,"session_recording_sample_rate": "string","session_recording_minimum_duration_milliseconds": 15000,"session_recording_linked_flag": null,"session_recording_network_payload_capture_config": null,"session_replay_config": null,"survey_config": null,"access_control": true,"week_start_day": 0,"primary_dashboard": 0,"live_events_columns": ["string"],"recording_domains": ["string"],"person_on_events_querying_enabled": "string","inject_web_apps": true,"extra_settings": null,"modifiers": null,"default_modifiers": "string","has_completed_onboarding_for": null,"surveys_opt_in": true,"heatmaps_opt_in": true,"product_intents": "string"}
project:write
A unique value identifying this project.
DELETE
/api /organizations /:organization_id /projects /:id
export POSTHOG_PERSONAL_API_KEY=[your personal api key]curl -X DELETE \-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \<ph_app_host>/api/organizations/:organization_id/projects/:id/
A unique value identifying this project.
GET
/api /organizations /:organization_id /projects /:id /activity
export POSTHOG_PERSONAL_API_KEY=[your personal api key]curl \-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \<ph_app_host>/api/organizations/:organization_id/projects/:id/activity/
{"id": 0,"organization": "452c1a86-a0af-475b-b03f-724878b0f387","name": "string","product_description": "string","created_at": "2019-08-24T14:15:22Z","effective_membership_level": 1,"has_group_types": true,"live_events_token": "string","updated_at": "2019-08-24T14:15:22Z","uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f","api_token": "string","app_urls": ["string"],"slack_incoming_webhook": "string","anonymize_ips": true,"completed_snippet_onboarding": true,"ingested_event": true,"test_account_filters": null,"test_account_filters_default_checked": true,"path_cleaning_filters": null,"is_demo": true,"timezone": "Africa/Abidjan","data_attributes": null,"person_display_name_properties": ["string"],"correlation_config": null,"autocapture_opt_out": true,"autocapture_exceptions_opt_in": true,"autocapture_web_vitals_opt_in": true,"autocapture_web_vitals_allowed_metrics": null,"autocapture_exceptions_errors_to_ignore": null,"capture_console_log_opt_in": true,"capture_performance_opt_in": true,"session_recording_opt_in": true,"session_recording_sample_rate": "string","session_recording_minimum_duration_milliseconds": 15000,"session_recording_linked_flag": null,"session_recording_network_payload_capture_config": null,"session_replay_config": null,"survey_config": null,"access_control": true,"week_start_day": 0,"primary_dashboard": 0,"live_events_columns": ["string"],"recording_domains": ["string"],"person_on_events_querying_enabled": "string","inject_web_apps": true,"extra_settings": null,"modifiers": null,"default_modifiers": "string","has_completed_onboarding_for": null,"surveys_opt_in": true,"heatmaps_opt_in": true,"product_intents": "string"}
A unique value identifying this project.
PATCH
/api /organizations /:organization_id /projects /:id /add_product_intent
export POSTHOG_PERSONAL_API_KEY=[your personal api key]curl -X PATCH \-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \<ph_app_host>/api/organizations/:organization_id/projects/:id/add_product_intent/\-d organization="string"
{"id": 0,"organization": "452c1a86-a0af-475b-b03f-724878b0f387","name": "string","product_description": "string","created_at": "2019-08-24T14:15:22Z","effective_membership_level": 1,"has_group_types": true,"live_events_token": "string","updated_at": "2019-08-24T14:15:22Z","uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f","api_token": "string","app_urls": ["string"],"slack_incoming_webhook": "string","anonymize_ips": true,"completed_snippet_onboarding": true,"ingested_event": true,"test_account_filters": null,"test_account_filters_default_checked": true,"path_cleaning_filters": null,"is_demo": true,"timezone": "Africa/Abidjan","data_attributes": null,"person_display_name_properties": ["string"],"correlation_config": null,"autocapture_opt_out": true,"autocapture_exceptions_opt_in": true,"autocapture_web_vitals_opt_in": true,"autocapture_web_vitals_allowed_metrics": null,"autocapture_exceptions_errors_to_ignore": null,"capture_console_log_opt_in": true,"capture_performance_opt_in": true,"session_recording_opt_in": true,"session_recording_sample_rate": "string","session_recording_minimum_duration_milliseconds": 15000,"session_recording_linked_flag": null,"session_recording_network_payload_capture_config": null,"session_replay_config": null,"survey_config": null,"access_control": true,"week_start_day": 0,"primary_dashboard": 0,"live_events_columns": ["string"],"recording_domains": ["string"],"person_on_events_querying_enabled": "string","inject_web_apps": true,"extra_settings": null,"modifiers": null,"default_modifiers": "string","has_completed_onboarding_for": null,"surveys_opt_in": true,"heatmaps_opt_in": true,"product_intents": "string"}
A unique value identifying this project.
PATCH
/api /organizations /:organization_id /projects /:id /complete_product_onboarding
export POSTHOG_PERSONAL_API_KEY=[your personal api key]curl -X PATCH \-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \<ph_app_host>/api/organizations/:organization_id/projects/:id/complete_product_onboarding/\-d organization="string"
{"id": 0,"organization": "452c1a86-a0af-475b-b03f-724878b0f387","name": "string","product_description": "string","created_at": "2019-08-24T14:15:22Z","effective_membership_level": 1,"has_group_types": true,"live_events_token": "string","updated_at": "2019-08-24T14:15:22Z","uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f","api_token": "string","app_urls": ["string"],"slack_incoming_webhook": "string","anonymize_ips": true,"completed_snippet_onboarding": true,"ingested_event": true,"test_account_filters": null,"test_account_filters_default_checked": true,"path_cleaning_filters": null,"is_demo": true,"timezone": "Africa/Abidjan","data_attributes": null,"person_display_name_properties": ["string"],"correlation_config": null,"autocapture_opt_out": true,"autocapture_exceptions_opt_in": true,"autocapture_web_vitals_opt_in": true,"autocapture_web_vitals_allowed_metrics": null,"autocapture_exceptions_errors_to_ignore": null,"capture_console_log_opt_in": true,"capture_performance_opt_in": true,"session_recording_opt_in": true,"session_recording_sample_rate": "string","session_recording_minimum_duration_milliseconds": 15000,"session_recording_linked_flag": null,"session_recording_network_payload_capture_config": null,"session_replay_config": null,"survey_config": null,"access_control": true,"week_start_day": 0,"primary_dashboard": 0,"live_events_columns": ["string"],"recording_domains": ["string"],"person_on_events_querying_enabled": "string","inject_web_apps": true,"extra_settings": null,"modifiers": null,"default_modifiers": "string","has_completed_onboarding_for": null,"surveys_opt_in": true,"heatmaps_opt_in": true,"product_intents": "string"}
A unique value identifying this project.
GET
/api /organizations /:organization_id /projects /:id /is_generating_demo_data
export POSTHOG_PERSONAL_API_KEY=[your personal api key]curl \-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \<ph_app_host>/api/organizations/:organization_id/projects/:id/is_generating_demo_data/
{"id": 0,"organization": "452c1a86-a0af-475b-b03f-724878b0f387","name": "string","product_description": "string","created_at": "2019-08-24T14:15:22Z","effective_membership_level": 1,"has_group_types": true,"live_events_token": "string","updated_at": "2019-08-24T14:15:22Z","uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f","api_token": "string","app_urls": ["string"],"slack_incoming_webhook": "string","anonymize_ips": true,"completed_snippet_onboarding": true,"ingested_event": true,"test_account_filters": null,"test_account_filters_default_checked": true,"path_cleaning_filters": null,"is_demo": true,"timezone": "Africa/Abidjan","data_attributes": null,"person_display_name_properties": ["string"],"correlation_config": null,"autocapture_opt_out": true,"autocapture_exceptions_opt_in": true,"autocapture_web_vitals_opt_in": true,"autocapture_web_vitals_allowed_metrics": null,"autocapture_exceptions_errors_to_ignore": null,"capture_console_log_opt_in": true,"capture_performance_opt_in": true,"session_recording_opt_in": true,"session_recording_sample_rate": "string","session_recording_minimum_duration_milliseconds": 15000,"session_recording_linked_flag": null,"session_recording_network_payload_capture_config": null,"session_replay_config": null,"survey_config": null,"access_control": true,"week_start_day": 0,"primary_dashboard": 0,"live_events_columns": ["string"],"recording_domains": ["string"],"person_on_events_querying_enabled": "string","inject_web_apps": true,"extra_settings": null,"modifiers": null,"default_modifiers": "string","has_completed_onboarding_for": null,"surveys_opt_in": true,"heatmaps_opt_in": true,"product_intents": "string"}
A unique value identifying this project.
PATCH
/api /organizations /:organization_id /projects /:id /reset_token
export POSTHOG_PERSONAL_API_KEY=[your personal api key]curl -X PATCH \-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \<ph_app_host>/api/organizations/:organization_id/projects/:id/reset_token/\-d organization="string"
{"id": 0,"organization": "452c1a86-a0af-475b-b03f-724878b0f387","name": "string","product_description": "string","created_at": "2019-08-24T14:15:22Z","effective_membership_level": 1,"has_group_types": true,"live_events_token": "string","updated_at": "2019-08-24T14:15:22Z","uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f","api_token": "string","app_urls": ["string"],"slack_incoming_webhook": "string","anonymize_ips": true,"completed_snippet_onboarding": true,"ingested_event": true,"test_account_filters": null,"test_account_filters_default_checked": true,"path_cleaning_filters": null,"is_demo": true,"timezone": "Africa/Abidjan","data_attributes": null,"person_display_name_properties": ["string"],"correlation_config": null,"autocapture_opt_out": true,"autocapture_exceptions_opt_in": true,"autocapture_web_vitals_opt_in": true,"autocapture_web_vitals_allowed_metrics": null,"autocapture_exceptions_errors_to_ignore": null,"capture_console_log_opt_in": true,"capture_performance_opt_in": true,"session_recording_opt_in": true,"session_recording_sample_rate": "string","session_recording_minimum_duration_milliseconds": 15000,"session_recording_linked_flag": null,"session_recording_network_payload_capture_config": null,"session_replay_config": null,"survey_config": null,"access_control": true,"week_start_day": 0,"primary_dashboard": 0,"live_events_columns": ["string"],"recording_domains": ["string"],"person_on_events_querying_enabled": "string","inject_web_apps": true,"extra_settings": null,"modifiers": null,"default_modifiers": "string","has_completed_onboarding_for": null,"surveys_opt_in": true,"heatmaps_opt_in": true,"product_intents": "string"}