Create metric group | LaunchDarkly

1 import requests 2 3 url = "https://app.launchdarkly.com/api/v2/projects/projectKey/metric-groups" 4 5 payload = { 6 "name": "My metric group", 7 "kind": "funnel", 8 "maintainerId": "569fdeadbeef1644facecafe", 9 "tags": ["ops"], 10 "metrics": [ 11 { 12 "key": "metric-key-123abc", 13 "nameInGroup": "Step 1" 14 } 15 ] 16 } 17 headers = { 18 "Authorization": "<apiKey>", 19 "Content-Type": "application/json" 20 } 21 22 response = requests.post(url, json=payload, headers=headers) 23 24 print(response.json())

1 { 2 "_id": "bc3e5be1-02d2-40c7-9926-26d0aacd7aab", 3 "key": "metric-group-key-123abc", 4 "name": "My metric group", 5 "kind": "funnel", 6 "_links": { 7 "parent": { 8 "href": "/api/v2/projects/my-project", 9 "type": "application/json" 10 }, 11 "self": { 12 "href": "/api/v2/projects/my-project/metric-groups/my-metric-group", 13 "type": "application/json" 14 } 15 }, 16 "tags": [ 17 "ops" 18 ], 19 "_creationDate": 1000000, 20 "_lastModified": 1000000, 21 "maintainer": { 22 "member": { 23 "_links": { 24 "self": { 25 "href": "/api/v2/members/569f183514f4432160000007", 26 "type": "application/json" 27 } 28 }, 29 "_id": "569f183514f4432160000007", 30 "role": "admin", 31 "email": "ariel@acme.com", 32 "firstName": "Ariel", 33 "lastName": "Flores" 34 }, 35 "team": { 36 "customRoleKeys": [ 37 "access-to-test-projects" 38 ], 39 "key": "team-key-123abc", 40 "name": "QA Team", 41 "_links": { 42 "key": {} 43 } 44 } 45 }, 46 "metrics": [ 47 { 48 "key": "metric-key-123abc", 49 "name": "Example metric", 50 "kind": "pageview", 51 "_links": { 52 "self": { 53 "href": "/api/v2/metrics/my-project/my-metric", 54 "type": "application/json" 55 } 56 }, 57 "_versionId": "version-id-123abc", 58 "isNumeric": true, 59 "unitAggregationType": "sum", 60 "eventKey": "event-key-123abc", 61 "nameInGroup": "Step 1", 62 "randomizationUnits": [ 63 "user" 64 ] 65 } 66 ], 67 "_version": 1, 68 "description": "Description of the metric group", 69 "_access": { 70 "denied": [ 71 { 72 "action": "action", 73 "reason": { 74 "effect": "allow" 75 } 76 } 77 ], 78 "allowed": [ 79 { 80 "action": "action", 81 "reason": { 82 "effect": "allow" 83 } 84 } 85 ] 86 }, 87 "experiments": [ 88 { 89 "key": "experiment-key-123abc", 90 "name": "Example experiment", 91 "environmentId": "1234a56b7c89d012345e678f", 92 "environmentKey": "production", 93 "creationDate": 1000000, 94 "_links": { 95 "parent": { 96 "href": "/api/v2/projects/my-project/environments/my-environment", 97 "type": "application/json" 98 }, 99 "self": { 100 "href": "/api/v2/projects/my-project/environments/my-environment/experiments/example-experiment", 101 "type": "application/json" 102 } 103 }, 104 "archivedDate": 1000000 105 } 106 ], 107 "experimentCount": 0, 108 "activeExperimentCount": 0, 109 "activeGuardedRolloutCount": 0, 110 "totalConnectionsCount": 0, 111 "totalActiveConnectionsCount": 0 112 }

Create a new metric group in the specified project

Authentication

Authorizationstring

API Key authentication via header

Path parameters

projectKeystringRequired

The project key

Request

This endpoint expects an object.

namestringRequired

A human-friendly name for the metric group

kindenumRequired

The type of the metric group

Allowed values:

maintainerIdstringRequired

The ID of the member who maintains this metric group

tagslist of stringsRequired

Tags for the metric group

metricslist of objectsRequired

An ordered list of the metrics in this metric group

keystringOptional

A unique key to reference the metric group

descriptionstringOptional

Description of the metric group

Response

Metric group response

_idstring

The ID of this metric group

keystring

A unique key to reference the metric group

namestring

A human-friendly name for the metric group

kindenum

The type of the metric group

Allowed values:

_linksmap from strings to objects

The location and content type of related resources

tagslist of strings

Tags for the metric group

_creationDatelong

Timestamp of when the metric group was created

_lastModifiedlong

Timestamp of when the metric group was last modified

maintainerobject

The maintainer of this metric

metricslist of objects

An ordered list of the metrics in this metric group

_versioninteger

The version of this metric group

descriptionstring or null

Description of the metric group

_accessobject or null

Details on the allowed and denied actions for this metric group

experimentslist of objects or null

Experiments that use this metric group. Only included if specified in the expand query parameter in a getMetricGroup request.

experimentCountinteger or null

The number of experiments using this metric group

activeExperimentCountinteger or null

The number of active experiments using this metric group

activeGuardedRolloutCountinteger or null

The number of active guarded rollouts using this metric group

totalConnectionsCountinteger or null

The total number of connections using this metric group

totalActiveConnectionsCountinteger or null

The total number of active connections using this metric group

Authentication

Path parameters

Request

Response

Errors