Environments-3
For instructions on how to authenticate to use this endpoint, see API overview.
Endpoints
Retrieve environments batch exports logs
Path parameters
- idstring
A UUID string identifying this batch export.
 - project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
 
Request
GET  /api /environments /:project_id /batch_exports /:id /logsexport POSTHOG_PERSONAL_API_KEY=[your personal api key]curl \-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \<ph_app_host>/api/environments/:project_id/batch_exports/:id/logs/
Response
Status 200 No response body
Retrieve environments batch exports logs
Path parameters
- idstring
A UUID string identifying this batch export.
 - project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
 
Request
GET  /api /environments /:project_id /batch_exports /:id /logsexport POSTHOG_PERSONAL_API_KEY=[your personal api key]curl \-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \<ph_app_host>/api/environments/:project_id/batch_exports/:id/logs/
Response
Status 200 No response body
Create environments batch exports pause
Pause a BatchExport.
Required API key scopes
batch_export:writePath parameters
- idstring
A UUID string identifying this batch export.
 - project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
 
Request parameters
- namestring
A human-readable name for this BatchExport.
 - model
Which model this BatchExport is exporting.
events- Eventspersons- Personssessions- Sessions
 - destination
 - interval
 - pausedboolean
Whether this BatchExport is paused or not.
 - last_paused_atstring
The timestamp at which this BatchExport was last paused.
 - start_atstring
Time before which any Batch Export runs won't be triggered.
 - end_atstring
Time after which any Batch Export runs won't be triggered.
 - hogql_querystring
 - filters
 
Request
POST  /api /environments /:project_id /batch_exports /:id /pauseexport 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/environments/:project_id/batch_exports/:id/pause/\-d name="string",\-d destination=undefined,\-d interval=undefined
Response
Status 200 No response body
Create environments batch exports pause
Pause a BatchExport.
Required API key scopes
batch_export:writePath parameters
- idstring
A UUID string identifying this batch export.
 - project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
 
Request parameters
- namestring
A human-readable name for this BatchExport.
 - model
Which model this BatchExport is exporting.
events- Eventspersons- Personssessions- Sessions
 - destination
 - interval
 - pausedboolean
Whether this BatchExport is paused or not.
 - last_paused_atstring
The timestamp at which this BatchExport was last paused.
 - start_atstring
Time before which any Batch Export runs won't be triggered.
 - end_atstring
Time after which any Batch Export runs won't be triggered.
 - hogql_querystring
 - filters
 
Request
POST  /api /environments /:project_id /batch_exports /:id /pauseexport 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/environments/:project_id/batch_exports/:id/pause/\-d name="string",\-d destination=undefined,\-d interval=undefined
Response
Status 200 No response body
Create environments batch exports run test step
Required API key scopes
INTERNALPath parameters
- idstring
A UUID string identifying this batch export.
 - project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
 
Request parameters
- namestring
A human-readable name for this BatchExport.
 - model
Which model this BatchExport is exporting.
events- Eventspersons- Personssessions- Sessions
 - destination
 - interval
 - pausedboolean
Whether this BatchExport is paused or not.
 - last_paused_atstring
The timestamp at which this BatchExport was last paused.
 - start_atstring
Time before which any Batch Export runs won't be triggered.
 - end_atstring
Time after which any Batch Export runs won't be triggered.
 - hogql_querystring
 - filters
 
Request
POST  /api /environments /:project_id /batch_exports /:id /run_test_stepexport 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/environments/:project_id/batch_exports/:id/run_test_step/\-d name="string",\-d destination=undefined,\-d interval=undefined
Response
Status 200 No response body
Create environments batch exports run test step
Required API key scopes
INTERNALPath parameters
- idstring
A UUID string identifying this batch export.
 - project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
 
Request parameters
- namestring
A human-readable name for this BatchExport.
 - model
Which model this BatchExport is exporting.
events- Eventspersons- Personssessions- Sessions
 - destination
 - interval
 - pausedboolean
Whether this BatchExport is paused or not.
 - last_paused_atstring
The timestamp at which this BatchExport was last paused.
 - start_atstring
Time before which any Batch Export runs won't be triggered.
 - end_atstring
Time after which any Batch Export runs won't be triggered.
 - hogql_querystring
 - filters
 
Request
POST  /api /environments /:project_id /batch_exports /:id /run_test_stepexport 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/environments/:project_id/batch_exports/:id/run_test_step/\-d name="string",\-d destination=undefined,\-d interval=undefined
Response
Status 200 No response body
Create environments batch exports unpause
Unpause a BatchExport.
Required API key scopes
batch_export:writePath parameters
- idstring
A UUID string identifying this batch export.
 - project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
 
Request parameters
- namestring
A human-readable name for this BatchExport.
 - model
Which model this BatchExport is exporting.
events- Eventspersons- Personssessions- Sessions
 - destination
 - interval
 - pausedboolean
Whether this BatchExport is paused or not.
 - last_paused_atstring
The timestamp at which this BatchExport was last paused.
 - start_atstring
Time before which any Batch Export runs won't be triggered.
 - end_atstring
Time after which any Batch Export runs won't be triggered.
 - hogql_querystring
 - filters
 
Request
POST  /api /environments /:project_id /batch_exports /:id /unpauseexport 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/environments/:project_id/batch_exports/:id/unpause/\-d name="string",\-d destination=undefined,\-d interval=undefined
Response
Status 200 No response body
Create environments batch exports unpause
Unpause a BatchExport.
Required API key scopes
batch_export:writePath parameters
- idstring
A UUID string identifying this batch export.
 - project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
 
Request parameters
- namestring
A human-readable name for this BatchExport.
 - model
Which model this BatchExport is exporting.
events- Eventspersons- Personssessions- Sessions
 - destination
 - interval
 - pausedboolean
Whether this BatchExport is paused or not.
 - last_paused_atstring
The timestamp at which this BatchExport was last paused.
 - start_atstring
Time before which any Batch Export runs won't be triggered.
 - end_atstring
Time after which any Batch Export runs won't be triggered.
 - hogql_querystring
 - filters
 
Request
POST  /api /environments /:project_id /batch_exports /:id /unpauseexport 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/environments/:project_id/batch_exports/:id/unpause/\-d name="string",\-d destination=undefined,\-d interval=undefined
Response
Status 200 No response body
Create environments batch exports run test step new
Required API key scopes
INTERNALPath parameters
- project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
 
Request parameters
- namestring
A human-readable name for this BatchExport.
 - model
Which model this BatchExport is exporting.
events- Eventspersons- Personssessions- Sessions
 - destination
 - interval
 - pausedboolean
Whether this BatchExport is paused or not.
 - last_paused_atstring
The timestamp at which this BatchExport was last paused.
 - start_atstring
Time before which any Batch Export runs won't be triggered.
 - end_atstring
Time after which any Batch Export runs won't be triggered.
 - hogql_querystring
 - filters
 
Request
POST  /api /environments /:project_id /batch_exports /run_test_step_newexport 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/environments/:project_id/batch_exports/run_test_step_new/\-d name="string",\-d destination=undefined,\-d interval=undefined
Response
Status 200 No response body
Create environments batch exports run test step new
Required API key scopes
INTERNALPath parameters
- project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
 
Request parameters
- namestring
A human-readable name for this BatchExport.
 - model
Which model this BatchExport is exporting.
events- Eventspersons- Personssessions- Sessions
 - destination
 - interval
 - pausedboolean
Whether this BatchExport is paused or not.
 - last_paused_atstring
The timestamp at which this BatchExport was last paused.
 - start_atstring
Time before which any Batch Export runs won't be triggered.
 - end_atstring
Time after which any Batch Export runs won't be triggered.
 - hogql_querystring
 - filters
 
Request
POST  /api /environments /:project_id /batch_exports /run_test_step_newexport 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/environments/:project_id/batch_exports/run_test_step_new/\-d name="string",\-d destination=undefined,\-d interval=undefined
Response
Status 200 No response body
Retrieve environments batch exports test
Required API key scopes
INTERNALPath parameters
- project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
 
Request
GET  /api /environments /:project_id /batch_exports /testexport POSTHOG_PERSONAL_API_KEY=[your personal api key]curl \-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \<ph_app_host>/api/environments/:project_id/batch_exports/test/
Response
Status 200 No response body
Retrieve environments batch exports test
Required API key scopes
INTERNALPath parameters
- project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
 
Request
GET  /api /environments /:project_id /batch_exports /testexport POSTHOG_PERSONAL_API_KEY=[your personal api key]curl \-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \<ph_app_host>/api/environments/:project_id/batch_exports/test/
Response
Status 200 No response body
List all environments dashboards
Required API key scopes
dashboard:readPath parameters
- project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
 
Query parameters
- limitinteger
Number of results to return per page.
 - offsetinteger
The initial index from which to return the results.
 
Response
Request
GET  /api /environments /:project_id /dashboardsexport POSTHOG_PERSONAL_API_KEY=[your personal api key]curl \-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \<ph_app_host>/api/environments/:project_id/dashboards/
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": [{"id": 0,"name": "string","description": "string","pinned": true,"created_at": "2019-08-24T14:15:22Z","created_by": {"id": 0,"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f","distinct_id": "string","first_name": "string","last_name": "string","email": "user@example.com","is_email_verified": true,"hedgehog_config": {"property1": null,"property2": null},"role_at_organization": "engineering"},"last_accessed_at": "2019-08-24T14:15:22Z","is_shared": true,"deleted": true,"creation_mode": "default","tags": [null],"restriction_level": 21,"effective_restriction_level": 21,"effective_privilege_level": 21,"user_access_level": "string","access_control_version": "string","last_refresh": "2019-08-24T14:15:22Z"}]}
List all environments dashboards
Required API key scopes
dashboard:readPath parameters
- project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
 
Query parameters
- limitinteger
Number of results to return per page.
 - offsetinteger
The initial index from which to return the results.
 
Response
Request
GET  /api /environments /:project_id /dashboardsexport POSTHOG_PERSONAL_API_KEY=[your personal api key]curl \-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \<ph_app_host>/api/environments/:project_id/dashboards/
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": [{"id": 0,"name": "string","description": "string","pinned": true,"created_at": "2019-08-24T14:15:22Z","created_by": {"id": 0,"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f","distinct_id": "string","first_name": "string","last_name": "string","email": "user@example.com","is_email_verified": true,"hedgehog_config": {"property1": null,"property2": null},"role_at_organization": "engineering"},"last_accessed_at": "2019-08-24T14:15:22Z","is_shared": true,"deleted": true,"creation_mode": "default","tags": [null],"restriction_level": 21,"effective_restriction_level": 21,"effective_privilege_level": 21,"user_access_level": "string","access_control_version": "string","last_refresh": "2019-08-24T14:15:22Z"}]}
Create environments dashboards
Required API key scopes
dashboard:writePath parameters
- project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
 
Request parameters
- namestring
 - descriptionstring
 - pinnedboolean
 - deletedboolean
 - use_templatestring
 - use_dashboardinteger
 - delete_insightsbooleanDefault:
false - breakdown_colors
 - data_color_theme_idinteger
 - tagsarray
 - restriction_level
 - _create_in_folderstring
 - last_refreshstring
 
Response
Request
POST  /api /environments /:project_id /dashboardsexport 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/environments/:project_id/dashboards/\-d name="string"
Response
Status 201
{"id": 0,"name": "string","description": "string","pinned": true,"created_at": "2019-08-24T14:15:22Z","created_by": {"id": 0,"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f","distinct_id": "string","first_name": "string","last_name": "string","email": "user@example.com","is_email_verified": true,"hedgehog_config": {"property1": null,"property2": null},"role_at_organization": "engineering"},"is_shared": true,"deleted": true,"creation_mode": "default","use_template": "string","use_dashboard": 0,"delete_insights": false,"filters": {"property1": null,"property2": null},"variables": {"property1": null,"property2": null},"breakdown_colors": null,"data_color_theme_id": 0,"tags": [null],"tiles": [{"property1": null,"property2": null}],"restriction_level": 21,"effective_restriction_level": 21,"effective_privilege_level": 21,"user_access_level": "string","access_control_version": "string","_create_in_folder": "string","last_refresh": "2019-08-24T14:15:22Z"}
Create environments dashboards
Required API key scopes
dashboard:writePath parameters
- project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
 
Request parameters
- namestring
 - descriptionstring
 - pinnedboolean
 - deletedboolean
 - use_templatestring
 - use_dashboardinteger
 - delete_insightsbooleanDefault:
false - breakdown_colors
 - data_color_theme_idinteger
 - tagsarray
 - restriction_level
 - _create_in_folderstring
 - last_refreshstring
 
Response
Request
POST  /api /environments /:project_id /dashboardsexport 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/environments/:project_id/dashboards/\-d name="string"
Response
Status 201
{"id": 0,"name": "string","description": "string","pinned": true,"created_at": "2019-08-24T14:15:22Z","created_by": {"id": 0,"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f","distinct_id": "string","first_name": "string","last_name": "string","email": "user@example.com","is_email_verified": true,"hedgehog_config": {"property1": null,"property2": null},"role_at_organization": "engineering"},"is_shared": true,"deleted": true,"creation_mode": "default","use_template": "string","use_dashboard": 0,"delete_insights": false,"filters": {"property1": null,"property2": null},"variables": {"property1": null,"property2": null},"breakdown_colors": null,"data_color_theme_id": 0,"tags": [null],"tiles": [{"property1": null,"property2": null}],"restriction_level": 21,"effective_restriction_level": 21,"effective_privilege_level": 21,"user_access_level": "string","access_control_version": "string","_create_in_folder": "string","last_refresh": "2019-08-24T14:15:22Z"}
List all environments dashboards collaborators
Required API key scopes
dashboard:readPath parameters
- dashboard_idinteger
 - project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
 
Request
GET  /api /environments /:project_id /dashboards /:dashboard_id /collaboratorsexport POSTHOG_PERSONAL_API_KEY=[your personal api key]curl \-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \<ph_app_host>/api/environments/:project_id/dashboards/:dashboard_id/collaborators/
Response
Status 200
{"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08","dashboard_id": 0,"user": {"id": 0,"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f","distinct_id": "string","first_name": "string","last_name": "string","email": "user@example.com","is_email_verified": true,"hedgehog_config": {"property1": null,"property2": null},"role_at_organization": "engineering"},"level": 21,"added_at": "2019-08-24T14:15:22Z","updated_at": "2019-08-24T14:15:22Z","user_uuid": "7c4d2d7d-8620-4fb3-967a-4a621082cf1f"}
List all environments dashboards collaborators
Required API key scopes
dashboard:readPath parameters
- dashboard_idinteger
 - project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
 
Request
GET  /api /environments /:project_id /dashboards /:dashboard_id /collaboratorsexport POSTHOG_PERSONAL_API_KEY=[your personal api key]curl \-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \<ph_app_host>/api/environments/:project_id/dashboards/:dashboard_id/collaborators/
Response
Status 200
{"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08","dashboard_id": 0,"user": {"id": 0,"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f","distinct_id": "string","first_name": "string","last_name": "string","email": "user@example.com","is_email_verified": true,"hedgehog_config": {"property1": null,"property2": null},"role_at_organization": "engineering"},"level": 21,"added_at": "2019-08-24T14:15:22Z","updated_at": "2019-08-24T14:15:22Z","user_uuid": "7c4d2d7d-8620-4fb3-967a-4a621082cf1f"}
Create environments dashboards collaborators
Required API key scopes
dashboard:writePath parameters
- dashboard_idinteger
 - project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
 
Request parameters
- level
 - user_uuidstring
 
Response
Request
POST  /api /environments /:project_id /dashboards /:dashboard_id /collaboratorsexport 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/environments/:project_id/dashboards/:dashboard_id/collaborators/\-d level=undefined,\-d user_uuid="string"
Response
Status 201
{"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08","dashboard_id": 0,"user": {"id": 0,"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f","distinct_id": "string","first_name": "string","last_name": "string","email": "user@example.com","is_email_verified": true,"hedgehog_config": {"property1": null,"property2": null},"role_at_organization": "engineering"},"level": 21,"added_at": "2019-08-24T14:15:22Z","updated_at": "2019-08-24T14:15:22Z","user_uuid": "7c4d2d7d-8620-4fb3-967a-4a621082cf1f"}
Create environments dashboards collaborators
Required API key scopes
dashboard:writePath parameters
- dashboard_idinteger
 - project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
 
Request parameters
- level
 - user_uuidstring
 
Response
Request
POST  /api /environments /:project_id /dashboards /:dashboard_id /collaboratorsexport 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/environments/:project_id/dashboards/:dashboard_id/collaborators/\-d level=undefined,\-d user_uuid="string"
Response
Status 201
{"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08","dashboard_id": 0,"user": {"id": 0,"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f","distinct_id": "string","first_name": "string","last_name": "string","email": "user@example.com","is_email_verified": true,"hedgehog_config": {"property1": null,"property2": null},"role_at_organization": "engineering"},"level": 21,"added_at": "2019-08-24T14:15:22Z","updated_at": "2019-08-24T14:15:22Z","user_uuid": "7c4d2d7d-8620-4fb3-967a-4a621082cf1f"}