Groups types
For instructions on how to authenticate to use this endpoint, see API overview.
Endpoints
List all groups types
Required API key scopes
group:read
Path 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 /projects /:project_id /groups_types
export POSTHOG_PERSONAL_API_KEY=[your personal api key]curl \-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \<ph_app_host>/api/projects/:project_id/groups_types/
Response
Status 200
{"group_type": "string","group_type_index": 0,"name_singular": "string","name_plural": "string","detail_dashboard": 0,"default_columns": ["string"],"created_at": "2019-08-24T14:15:22Z"}
Delete groups types
Required API key scopes
group:write
Path parameters
- group_type_indexinteger
- 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
DELETE
/api /projects /:project_id /groups_types /:group_type_index
export POSTHOG_PERSONAL_API_KEY=[your personal api key]curl -X DELETE \-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \<ph_app_host>/api/projects/:project_id/groups_types/:group_type_index/
Response
Status 204 No response body
List all groups types metrics
Required API key scopes
group:read
Path parameters
- group_type_indexinteger
- 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 /projects /:project_id /groups_types /:group_type_index /metrics
export POSTHOG_PERSONAL_API_KEY=[your personal api key]curl \-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \<ph_app_host>/api/projects/:project_id/groups_types/:group_type_index/metrics/
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": "497f6eca-6276-4993-bfeb-53cbbbba6f08","name": "string","format": "numeric","interval": -2147483648,"display": "number","filters": null}]}
Create groups types metrics
Required API key scopes
group:write
Path parameters
- group_type_indexinteger
- 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
- format
- intervalinteger
In days
- display
- filters
Response
Request
POST
/api /projects /:project_id /groups_types /:group_type_index /metrics
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/projects/:project_id/groups_types/:group_type_index/metrics/\-d name="string",\-d filters=undefined
Response
Status 201
{"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08","name": "string","format": "numeric","interval": -2147483648,"display": "number","filters": null}
Retrieve groups types metrics
Required API key scopes
group:read
Path parameters
- group_type_indexinteger
- idstring
A UUID string identifying this group usage metric.
- 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/.
Response
Request
GET
/api /projects /:project_id /groups_types /:group_type_index /metrics /:id
export POSTHOG_PERSONAL_API_KEY=[your personal api key]curl \-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \<ph_app_host>/api/projects/:project_id/groups_types/:group_type_index/metrics/:id/
Response
Status 200
{"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08","name": "string","format": "numeric","interval": -2147483648,"display": "number","filters": null}
Update groups types metrics
Required API key scopes
group:write
Path parameters
- group_type_indexinteger
- idstring
A UUID string identifying this group usage metric.
- 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
- format
- intervalinteger
In days
- display
- filters
Response
Request
PATCH
/api /projects /:project_id /groups_types /:group_type_index /metrics /:id
export POSTHOG_PERSONAL_API_KEY=[your personal api key]curl -X PATCH \-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \<ph_app_host>/api/projects/:project_id/groups_types/:group_type_index/metrics/:id/\-d name="string"
Response
Status 200
{"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08","name": "string","format": "numeric","interval": -2147483648,"display": "number","filters": null}
Delete groups types metrics
Required API key scopes
group:write
Path parameters
- group_type_indexinteger
- idstring
A UUID string identifying this group usage metric.
- 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
DELETE
/api /projects /:project_id /groups_types /:group_type_index /metrics /:id
export POSTHOG_PERSONAL_API_KEY=[your personal api key]curl -X DELETE \-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \<ph_app_host>/api/projects/:project_id/groups_types/:group_type_index/metrics/:id/
Response
Status 204 No response body
Update groups types update metadata
Path 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
- name_singularstring
- name_pluralstring
- detail_dashboardinteger
- default_columnsarray
- created_atstring
Request
PATCH
/api /projects /:project_id /groups_types /update_metadata
export POSTHOG_PERSONAL_API_KEY=[your personal api key]curl -X PATCH \-H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \<ph_app_host>/api/projects/:project_id/groups_types/update_metadata/\-d group_type="string"