Users
For instructions on how to authenticate to use this endpoint, see API overview.
Endpoints
List all users
Required API key scopes
user:read
Query parameters
- is_staffboolean
- limitinteger
Number of results to return per page.
- offsetinteger
The initial index from which to return the results.
Response
Request
GET
/api /users
export POSTHOG_PERSONAL_API_KEY=[your personal api key]curl \-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \<ph_app_host>/api/users/
Response
Status 200
{"count": 123,"next": "http://api.example.org/accounts/?offset=400&limit=100","previous": "http://api.example.org/accounts/?offset=200&limit=100","results": [{"date_joined": "2019-08-24T14:15:22Z","uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f","distinct_id": "string","first_name": "string","last_name": "string","email": "user@example.com","pending_email": "user@example.com","is_email_verified": true,"notification_settings": {"property1": null,"property2": null},"anonymize_data": true,"toolbar_mode": "disabled","has_password": true,"is_staff": true,"is_impersonated": true,"is_impersonated_until": "string","sensitive_session_expires_at": "string","team": {"id": 0,"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f","organization": "452c1a86-a0af-475b-b03f-724878b0f387","project_id": -9223372036854776000,"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},"organization": {"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08","name": "string","slug": "string","logo_media_id": "a5d9f2f1-d934-4d2e-bebe-4b3cdcd08a33","created_at": "2019-08-24T14:15:22Z","updated_at": "2019-08-24T14:15:22Z","membership_level": 1,"plugins_access_level": 0,"teams": [{"property1": null,"property2": null}],"projects": [{"property1": null,"property2": null}],"available_product_features": [null],"is_member_join_email_enabled": true,"metadata": "string","customer_id": "string","enforce_2fa": true,"member_count": "string","is_ai_data_processing_approved": true},"organizations": [{"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08","name": "string","slug": "string","logo_media_id": "a5d9f2f1-d934-4d2e-bebe-4b3cdcd08a33","membership_level": 1}],"set_current_organization": "string","set_current_team": "string","password": "string","current_password": "string","events_column_config": null,"is_2fa_enabled": true,"has_social_auth": true,"has_seen_product_intro_for": null,"scene_personalisation": [{"scene": "string","dashboard": 0}],"theme_mode": "light","hedgehog_config": null,"role_at_organization": "engineering"}]}
List all users
Required API key scopes
user:read
Query parameters
- is_staffboolean
- limitinteger
Number of results to return per page.
- offsetinteger
The initial index from which to return the results.
Response
Request
GET
/api /users
export POSTHOG_PERSONAL_API_KEY=[your personal api key]curl \-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \<ph_app_host>/api/users/
Response
Status 200
{"count": 123,"next": "http://api.example.org/accounts/?offset=400&limit=100","previous": "http://api.example.org/accounts/?offset=200&limit=100","results": [{"date_joined": "2019-08-24T14:15:22Z","uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f","distinct_id": "string","first_name": "string","last_name": "string","email": "user@example.com","pending_email": "user@example.com","is_email_verified": true,"notification_settings": {"property1": null,"property2": null},"anonymize_data": true,"toolbar_mode": "disabled","has_password": true,"is_staff": true,"is_impersonated": true,"is_impersonated_until": "string","sensitive_session_expires_at": "string","team": {"id": 0,"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f","organization": "452c1a86-a0af-475b-b03f-724878b0f387","project_id": -9223372036854776000,"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},"organization": {"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08","name": "string","slug": "string","logo_media_id": "a5d9f2f1-d934-4d2e-bebe-4b3cdcd08a33","created_at": "2019-08-24T14:15:22Z","updated_at": "2019-08-24T14:15:22Z","membership_level": 1,"plugins_access_level": 0,"teams": [{"property1": null,"property2": null}],"projects": [{"property1": null,"property2": null}],"available_product_features": [null],"is_member_join_email_enabled": true,"metadata": "string","customer_id": "string","enforce_2fa": true,"member_count": "string","is_ai_data_processing_approved": true},"organizations": [{"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08","name": "string","slug": "string","logo_media_id": "a5d9f2f1-d934-4d2e-bebe-4b3cdcd08a33","membership_level": 1}],"set_current_organization": "string","set_current_team": "string","password": "string","current_password": "string","events_column_config": null,"is_2fa_enabled": true,"has_social_auth": true,"has_seen_product_intro_for": null,"scene_personalisation": [{"scene": "string","dashboard": 0}],"theme_mode": "light","hedgehog_config": null,"role_at_organization": "engineering"}]}
Retrieve users
Required API key scopes
user:read
Path parameters
- uuidstring
Response
Request
GET
/api /users /:uuid
export POSTHOG_PERSONAL_API_KEY=[your personal api key]curl \-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \<ph_app_host>/api/users/:uuid/
Response
Status 200
{"date_joined": "2019-08-24T14:15:22Z","uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f","distinct_id": "string","first_name": "string","last_name": "string","email": "user@example.com","pending_email": "user@example.com","is_email_verified": true,"notification_settings": {"property1": null,"property2": null},"anonymize_data": true,"toolbar_mode": "disabled","has_password": true,"is_staff": true,"is_impersonated": true,"is_impersonated_until": "string","sensitive_session_expires_at": "string","team": {"id": 0,"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f","organization": "452c1a86-a0af-475b-b03f-724878b0f387","project_id": -9223372036854776000,"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},"organization": {"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08","name": "string","slug": "string","logo_media_id": "a5d9f2f1-d934-4d2e-bebe-4b3cdcd08a33","created_at": "2019-08-24T14:15:22Z","updated_at": "2019-08-24T14:15:22Z","membership_level": 1,"plugins_access_level": 0,"teams": [{"property1": null,"property2": null}],"projects": [{"property1": null,"property2": null}],"available_product_features": [null],"is_member_join_email_enabled": true,"metadata": "string","customer_id": "string","enforce_2fa": true,"member_count": "string","is_ai_data_processing_approved": true},"organizations": [{"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08","name": "string","slug": "string","logo_media_id": "a5d9f2f1-d934-4d2e-bebe-4b3cdcd08a33","membership_level": 1}],"set_current_organization": "string","set_current_team": "string","password": "string","current_password": "string","events_column_config": null,"is_2fa_enabled": true,"has_social_auth": true,"has_seen_product_intro_for": null,"scene_personalisation": [{"scene": "string","dashboard": 0}],"theme_mode": "light","hedgehog_config": null,"role_at_organization": "engineering"}
Retrieve users
Required API key scopes
user:read
Path parameters
- uuidstring
Response
Request
GET
/api /users /:uuid
export POSTHOG_PERSONAL_API_KEY=[your personal api key]curl \-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \<ph_app_host>/api/users/:uuid/
Response
Status 200
{"date_joined": "2019-08-24T14:15:22Z","uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f","distinct_id": "string","first_name": "string","last_name": "string","email": "user@example.com","pending_email": "user@example.com","is_email_verified": true,"notification_settings": {"property1": null,"property2": null},"anonymize_data": true,"toolbar_mode": "disabled","has_password": true,"is_staff": true,"is_impersonated": true,"is_impersonated_until": "string","sensitive_session_expires_at": "string","team": {"id": 0,"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f","organization": "452c1a86-a0af-475b-b03f-724878b0f387","project_id": -9223372036854776000,"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},"organization": {"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08","name": "string","slug": "string","logo_media_id": "a5d9f2f1-d934-4d2e-bebe-4b3cdcd08a33","created_at": "2019-08-24T14:15:22Z","updated_at": "2019-08-24T14:15:22Z","membership_level": 1,"plugins_access_level": 0,"teams": [{"property1": null,"property2": null}],"projects": [{"property1": null,"property2": null}],"available_product_features": [null],"is_member_join_email_enabled": true,"metadata": "string","customer_id": "string","enforce_2fa": true,"member_count": "string","is_ai_data_processing_approved": true},"organizations": [{"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08","name": "string","slug": "string","logo_media_id": "a5d9f2f1-d934-4d2e-bebe-4b3cdcd08a33","membership_level": 1}],"set_current_organization": "string","set_current_team": "string","password": "string","current_password": "string","events_column_config": null,"is_2fa_enabled": true,"has_social_auth": true,"has_seen_product_intro_for": null,"scene_personalisation": [{"scene": "string","dashboard": 0}],"theme_mode": "light","hedgehog_config": null,"role_at_organization": "engineering"}
Update users
Required API key scopes
user:write
Path parameters
- uuidstring
Request parameters
- first_namestring
- last_namestring
- emailstring
- notification_settingsobject
- anonymize_databoolean
- toolbar_mode
- is_staffboolean
Designates whether the user can log into this admin site.
- set_current_organizationstring
- set_current_teamstring
- passwordstring
- current_passwordstring
- events_column_config
- has_seen_product_intro_for
- theme_mode
- hedgehog_config
- role_at_organization
Response
Request
PATCH
/api /users /:uuid
export POSTHOG_PERSONAL_API_KEY=[your personal api key]curl -X PATCH \-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \<ph_app_host>/api/users/:uuid/\-d date_joined="string"
Response
Status 200
{"date_joined": "2019-08-24T14:15:22Z","uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f","distinct_id": "string","first_name": "string","last_name": "string","email": "user@example.com","pending_email": "user@example.com","is_email_verified": true,"notification_settings": {"property1": null,"property2": null},"anonymize_data": true,"toolbar_mode": "disabled","has_password": true,"is_staff": true,"is_impersonated": true,"is_impersonated_until": "string","sensitive_session_expires_at": "string","team": {"id": 0,"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f","organization": "452c1a86-a0af-475b-b03f-724878b0f387","project_id": -9223372036854776000,"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},"organization": {"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08","name": "string","slug": "string","logo_media_id": "a5d9f2f1-d934-4d2e-bebe-4b3cdcd08a33","created_at": "2019-08-24T14:15:22Z","updated_at": "2019-08-24T14:15:22Z","membership_level": 1,"plugins_access_level": 0,"teams": [{"property1": null,"property2": null}],"projects": [{"property1": null,"property2": null}],"available_product_features": [null],"is_member_join_email_enabled": true,"metadata": "string","customer_id": "string","enforce_2fa": true,"member_count": "string","is_ai_data_processing_approved": true},"organizations": [{"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08","name": "string","slug": "string","logo_media_id": "a5d9f2f1-d934-4d2e-bebe-4b3cdcd08a33","membership_level": 1}],"set_current_organization": "string","set_current_team": "string","password": "string","current_password": "string","events_column_config": null,"is_2fa_enabled": true,"has_social_auth": true,"has_seen_product_intro_for": null,"scene_personalisation": [{"scene": "string","dashboard": 0}],"theme_mode": "light","hedgehog_config": null,"role_at_organization": "engineering"}
Update users
Required API key scopes
user:write
Path parameters
- uuidstring
Request parameters
- first_namestring
- last_namestring
- emailstring
- notification_settingsobject
- anonymize_databoolean
- toolbar_mode
- is_staffboolean
Designates whether the user can log into this admin site.
- set_current_organizationstring
- set_current_teamstring
- passwordstring
- current_passwordstring
- events_column_config
- has_seen_product_intro_for
- theme_mode
- hedgehog_config
- role_at_organization
Response
Request
PATCH
/api /users /:uuid
export POSTHOG_PERSONAL_API_KEY=[your personal api key]curl -X PATCH \-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \<ph_app_host>/api/users/:uuid/\-d date_joined="string"
Response
Status 200
{"date_joined": "2019-08-24T14:15:22Z","uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f","distinct_id": "string","first_name": "string","last_name": "string","email": "user@example.com","pending_email": "user@example.com","is_email_verified": true,"notification_settings": {"property1": null,"property2": null},"anonymize_data": true,"toolbar_mode": "disabled","has_password": true,"is_staff": true,"is_impersonated": true,"is_impersonated_until": "string","sensitive_session_expires_at": "string","team": {"id": 0,"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f","organization": "452c1a86-a0af-475b-b03f-724878b0f387","project_id": -9223372036854776000,"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},"organization": {"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08","name": "string","slug": "string","logo_media_id": "a5d9f2f1-d934-4d2e-bebe-4b3cdcd08a33","created_at": "2019-08-24T14:15:22Z","updated_at": "2019-08-24T14:15:22Z","membership_level": 1,"plugins_access_level": 0,"teams": [{"property1": null,"property2": null}],"projects": [{"property1": null,"property2": null}],"available_product_features": [null],"is_member_join_email_enabled": true,"metadata": "string","customer_id": "string","enforce_2fa": true,"member_count": "string","is_ai_data_processing_approved": true},"organizations": [{"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08","name": "string","slug": "string","logo_media_id": "a5d9f2f1-d934-4d2e-bebe-4b3cdcd08a33","membership_level": 1}],"set_current_organization": "string","set_current_team": "string","password": "string","current_password": "string","events_column_config": null,"is_2fa_enabled": true,"has_social_auth": true,"has_seen_product_intro_for": null,"scene_personalisation": [{"scene": "string","dashboard": 0}],"theme_mode": "light","hedgehog_config": null,"role_at_organization": "engineering"}
Retrieve users hedgehog config
Path parameters
- uuidstring
Request
GET
/api /users /:uuid /hedgehog_config
export POSTHOG_PERSONAL_API_KEY=[your personal api key]curl \-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \<ph_app_host>/api/users/:uuid/hedgehog_config/
Response
Status 200 No response body
Retrieve users hedgehog config
Path parameters
- uuidstring
Request
GET
/api /users /:uuid /hedgehog_config
export POSTHOG_PERSONAL_API_KEY=[your personal api key]curl \-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \<ph_app_host>/api/users/:uuid/hedgehog_config/
Response
Status 200 No response body
Update users hedgehog config
Path parameters
- uuidstring
Request parameters
- first_namestring
- last_namestring
- emailstring
- notification_settingsobject
- anonymize_databoolean
- toolbar_mode
- is_staffboolean
Designates whether the user can log into this admin site.
- set_current_organizationstring
- set_current_teamstring
- passwordstring
- current_passwordstring
- events_column_config
- has_seen_product_intro_for
- theme_mode
- hedgehog_config
- role_at_organization
Request
PATCH
/api /users /:uuid /hedgehog_config
export POSTHOG_PERSONAL_API_KEY=[your personal api key]curl -X PATCH \-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \<ph_app_host>/api/users/:uuid/hedgehog_config/\-d date_joined="string"
Response
Status 200 No response body
Update users hedgehog config
Path parameters
- uuidstring
Request parameters
- first_namestring
- last_namestring
- emailstring
- notification_settingsobject
- anonymize_databoolean
- toolbar_mode
- is_staffboolean
Designates whether the user can log into this admin site.
- set_current_organizationstring
- set_current_teamstring
- passwordstring
- current_passwordstring
- events_column_config
- has_seen_product_intro_for
- theme_mode
- hedgehog_config
- role_at_organization
Request
PATCH
/api /users /:uuid /hedgehog_config
export POSTHOG_PERSONAL_API_KEY=[your personal api key]curl -X PATCH \-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \<ph_app_host>/api/users/:uuid/hedgehog_config/\-d date_joined="string"
Response
Status 200 No response body
Create users scene personalisation
Path parameters
- uuidstring
Request parameters
- first_namestring
- last_namestring
- emailstring
- notification_settingsobject
- anonymize_databoolean
- toolbar_mode
- is_staffboolean
Designates whether the user can log into this admin site.
- set_current_organizationstring
- set_current_teamstring
- passwordstring
- current_passwordstring
- events_column_config
- has_seen_product_intro_for
- theme_mode
- hedgehog_config
- role_at_organization
Request
POST
/api /users /:uuid /scene_personalisation
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/users/:uuid/scene_personalisation/\-d email="string",\-d password="string"
Response
Status 200 No response body
Create users scene personalisation
Path parameters
- uuidstring
Request parameters
- first_namestring
- last_namestring
- emailstring
- notification_settingsobject
- anonymize_databoolean
- toolbar_mode
- is_staffboolean
Designates whether the user can log into this admin site.
- set_current_organizationstring
- set_current_teamstring
- passwordstring
- current_passwordstring
- events_column_config
- has_seen_product_intro_for
- theme_mode
- hedgehog_config
- role_at_organization
Request
POST
/api /users /:uuid /scene_personalisation
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/users/:uuid/scene_personalisation/\-d email="string",\-d password="string"
Response
Status 200 No response body
Retrieve users start 2fa setup
Path parameters
- uuidstring
Request
GET
/api /users /:uuid /start_2fa_setup
export POSTHOG_PERSONAL_API_KEY=[your personal api key]curl \-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \<ph_app_host>/api/users/:uuid/start_2fa_setup/
Response
Status 200 No response body
Retrieve users start 2fa setup
Path parameters
- uuidstring
Request
GET
/api /users /:uuid /start_2fa_setup
export POSTHOG_PERSONAL_API_KEY=[your personal api key]curl \-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \<ph_app_host>/api/users/:uuid/start_2fa_setup/
Response
Status 200 No response body
Create users two factor backup codes
Generate new backup codes, invalidating any existing ones
Path parameters
- uuidstring
Request parameters
- first_namestring
- last_namestring
- emailstring
- notification_settingsobject
- anonymize_databoolean
- toolbar_mode
- is_staffboolean
Designates whether the user can log into this admin site.
- set_current_organizationstring
- set_current_teamstring
- passwordstring
- current_passwordstring
- events_column_config
- has_seen_product_intro_for
- theme_mode
- hedgehog_config
- role_at_organization
Request
POST
/api /users /:uuid /two_factor_backup_codes
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/users/:uuid/two_factor_backup_codes/\-d email="string",\-d password="string"
Response
Status 200 No response body
Create users two factor backup codes
Generate new backup codes, invalidating any existing ones
Path parameters
- uuidstring
Request parameters
- first_namestring
- last_namestring
- emailstring
- notification_settingsobject
- anonymize_databoolean
- toolbar_mode
- is_staffboolean
Designates whether the user can log into this admin site.
- set_current_organizationstring
- set_current_teamstring
- passwordstring
- current_passwordstring
- events_column_config
- has_seen_product_intro_for
- theme_mode
- hedgehog_config
- role_at_organization
Request
POST
/api /users /:uuid /two_factor_backup_codes
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/users/:uuid/two_factor_backup_codes/\-d email="string",\-d password="string"
Response
Status 200 No response body
Create users two factor disable
Disable 2FA and remove all related devices
Path parameters
- uuidstring
Request parameters
- first_namestring
- last_namestring
- emailstring
- notification_settingsobject
- anonymize_databoolean
- toolbar_mode
- is_staffboolean
Designates whether the user can log into this admin site.
- set_current_organizationstring
- set_current_teamstring
- passwordstring
- current_passwordstring
- events_column_config
- has_seen_product_intro_for
- theme_mode
- hedgehog_config
- role_at_organization
Request
POST
/api /users /:uuid /two_factor_disable
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/users/:uuid/two_factor_disable/\-d email="string",\-d password="string"
Response
Status 200 No response body
Create users two factor disable
Disable 2FA and remove all related devices
Path parameters
- uuidstring
Request parameters
- first_namestring
- last_namestring
- emailstring
- notification_settingsobject
- anonymize_databoolean
- toolbar_mode
- is_staffboolean
Designates whether the user can log into this admin site.
- set_current_organizationstring
- set_current_teamstring
- passwordstring
- current_passwordstring
- events_column_config
- has_seen_product_intro_for
- theme_mode
- hedgehog_config
- role_at_organization
Request
POST
/api /users /:uuid /two_factor_disable
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/users/:uuid/two_factor_disable/\-d email="string",\-d password="string"