Sessions endpoints
The Sessions endpoints enable you to work programatically with the sessions in your Quantive Results account. All CRUD operations are supported by the sessions API endpoints.
Gets all the sessions in the account
Parameters
| Name | Type | Description |
|---|---|---|
| fields | string | List of fields to be retrieved, separated by comas (,). expected in query, sample value: end,start,title,status |
| filter | string | The format of the parameter follows the MongoDB query format.
For example, the following expression {name: {$in: ["sales", "marketing"]}} would return all the sessions that have name either "sales" or "marketing".
This expression {"name":{$regex:".*Sales.*"}} would return sessions that contain "Sales" in their names. expected in query, sample value: {name: {$in: ["sales", "marketing"]}} |
| skip | integer | How many entities to be skipped when executing a GET query.
By default skip value is 0. expected in query, sample value: 5 |
| limit | integer | The max number of entities that can be returned by the GET query.
By default take value is 100. expected in query, sample value: 10 |
| includeDemo | string | Whether to include the Demo session in the response expected in query, sample value: true |
Expected response codes
200 | planningSessionsResponse |
400 | bad request |
401 | unauthorized |
402 | payment required |
403 | forbidden |
500 | internal server error |
curl -X GET 'https://app.quantive.com/results/api/v2/sessions?fields=end,start,title,status&filter={name: {$in: ["sales", "marketing"]}}&skip=5&limit=10&includeDemo=true' \ -H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {token}' \
var settings = { "url": "https://app.quantive.com/results/api/v2/sessions?fields=end,start,title,status&filter={name: {$in: ["sales", "marketing"]}}&skip=5&limit=10&includeDemo=true", "method": "GET", "timeout": 0, "headers": { "Content-Type": "application/json", "Accept": "application/json", "Authorization": "Bearer {token}",
}
}; $.ajax(settings).done(function (response) { console.log(response); });
NOTE: You must install the module requests.
In a terminal window do: pip install requests
import requests, json
headers = { "Authorization" : "Bearer {token}", "gtmhub-accountId" : "{accountId}", "Content-Type" : "application/json" };
url = "https://app.quantive.com/results/api/v2/sessions"
requests.get(url, headers = headers)
{
"items": [
{
"accountId": "string value",
"cadence": {
"ranges": [
{
"cadenceOrder": 2,
"end": "string value",
"start": "string value"
}
],
"totalCadences": 2,
"type": "string value"
},
"cadenceStart": {
"dayOfMonth": 2,
"periodOfMonth": "string",
"weekday": 2
},
"cadenceTimeZone": "string value",
"color": "string value",
"currentUserAllowedActions": [
"string value 1",
"string value 2"
],
"demo": false,
"dynamicValueType": "string value",
"end": "string value",
"id": "string value",
"inherits": false,
"isSelfApproveAllowed": false,
"ownerPermissions": {
"deny": {
"Subtype": 2
},
"grant": {
"Subtype": 2
}
},
"parentId": "string value",
"permissions": [
{
"grant": {
"Subtype": 2
},
"principalId": "string",
"principalKind": "string value"
}
],
"settings": {
"assignGoalPermissions": "string value",
"assignMetricPermissions": "string value",
"goalsPerOwnerLimit": 2,
"metricsPerGoalLimit": 2,
"multipleOwners": {
"disabledForGoals": false,
"disabledForMetrics": false
},
"progressAggregationDisabled": false
},
"start": "string value",
"status": "string value",
"tags": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "ID",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
"tagResponse"
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"title": "string value",
"workflow": {
"approvalSettings": {
"everyoneCanApprove": false,
"teamsAllowedToApprove": [
"string"
],
"usersAllowedToApprove": [
"string"
]
},
"editableKrFields": [
"string value 1",
"string value 2"
],
"editableOkrFields": [
"string value 1",
"string value 2"
],
"reviewers": 2,
"target": [
"string value 1",
"string value 2"
]
}
}
],
"totalCount": 2
}Gets the goals that are over 99% in this session.
Parameters
| Name | Type | Description |
|---|---|---|
| gtmhub-accountId * | string | Specifies the unique identifier (id) of the Quantive Results account. expected in header, sample value: 5be26318e5274a0007f17f61 |
| sessionId * | string | Specifies the unique identifier (id) of the session. expected in path |
| tags | string | A comma separated list of tag names/titles to filter by.
The filter is inclusive (union). For example specifying tag names as "tag1,tag2" will return all
items that have a tag1 or tag2 assigned. expected in query, sample value: string |
Expected response codes
200 | goalsResponse |
400 | bad request |
500 | internal server error |
curl -X GET 'https://app.quantive.com/results/api/v1/sessions/{id}/stats/goalsMet?tags=string' \ -H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {token}' \
-H 'gtmhub-accountId: 5be26318e5274a0007f17f61' \
var settings = { "url": "https://app.quantive.com/results/api/v1/sessions/{id}/stats/goalsMet?tags=string", "method": "GET", "timeout": 0, "headers": { "Content-Type": "application/json", "Accept": "application/json", "Authorization": "Bearer {token}",
"gtmhub-accountId": "5be26318e5274a0007f17f61",
}
}; $.ajax(settings).done(function (response) { console.log(response); });
NOTE: You must install the module requests.
In a terminal window do: pip install requests
import requests, json
headers = { "Authorization" : "Bearer {token}", "gtmhub-accountId" : "{accountId}", "Content-Type" : "application/json" };
url = "https://app.quantive.com/results/api/v1/sessions/{id}/stats/goalsMet"
requests.get(url, headers = headers)
{
"items": [
{
"access": {
"inherits": false,
"ownerPermissions": {
"deny": {
"Subtype": 2
},
"grant": {
"Subtype": 2
}
},
"permissions": [
{
"grant": {
"Subtype": 2
},
"principalId": "string",
"principalKind": "string value"
}
]
},
"accountId": "string value",
"aggregatedAttainment": 2,
"assignee": {
"accountId": "string value",
"avatar": "string value",
"color": "string value",
"dateDeactivated": "string value",
"dynamicValueType": "string value",
"email": "string value",
"id": "string value",
"isActive": false,
"name": "string value",
"picture": "string value",
"tags": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "ID",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
"tagResponse"
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"type": "string value"
},
"assignees": [
{
"accountId": "string value",
"avatar": "string value",
"color": "string value",
"dateDeactivated": "string value",
"dynamicValueType": "string value",
"email": "string value",
"id": "string value",
"isActive": false,
"name": "string value",
"picture": "string value",
"tags": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "ID",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
"tagResponse"
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"type": "string value"
}
],
"attainment": 2,
"attainmentDelta": 2,
"attainmentTypeString": "string value",
"childrenAggregatedAttainment": 2,
"childrenCount": 2,
"closedStatus": {
"reason": "string value",
"status": "string value"
},
"createdById": "string value",
"currentUserAllowedActions": [
"string value 1",
"string value 2"
],
"dateCreated": "string value",
"dateFrom": "string value",
"dateTo": "string value",
"description": "string value",
"designScore": {
"policies": [
{
"isPassed": false,
"policy": "string value",
"score": 2
}
],
"totalPoints": 2
},
"duration": 2,
"fullAggregatedAttainment": 2,
"fullSubTreeCount": 2,
"id": "string value",
"lastCalculated": "string value",
"links": {
"expanded": {
"goals": [
{
"access": "defaultAccess",
"accountId": "string value",
"assignee": "assigneeResponse",
"assignees": [
"assigneeResponse"
],
"attainment": 2,
"attainmentTypeString": "string value",
"createdById": "string value",
"dateCreated": "string value",
"dateFrom": "string value",
"dateTo": "string value",
"description": "string value",
"id": "string value",
"name": "string value",
"numberOfOwners": 2,
"obfuscated": false,
"ownerId": "string value",
"ownerIds": [
"string value 1",
"string value 2"
],
"parentGoalSessionId": "string value",
"parentId": "string value",
"parentType": "string value",
"private": false,
"sessionId": "string value",
"url": "string value"
}
],
"kpis": [
{
"access": "defaultAccess",
"accountId": "ID",
"aggregation": "string value",
"createdById": "ID",
"dateCreated": "string value",
"dateUpdated": "string value",
"description": "string value",
"groups": "IDs",
"id": "ID",
"mentions": "Mentions",
"modifiedById": "ID",
"name": "string value",
"obfuscated": false,
"ownerId": "ID",
"ownerIds": "IDs",
"targetOperator": "string value"
}
],
"metrics": [
{
"actual": 6,
"cascadeType": "absolute_value",
"description": "My Description",
"dynamic": true,
"fieldName": "count",
"format": "MetricFormat",
"goalId": "string value",
"goalName": "string value",
"initialValue": 2,
"insightName": "1k42vv2z24",
"manualType": "double",
"name": "string value",
"numberOfOwners": 2,
"obfuscated": false,
"ownerId": "string value",
"ownerIds": "Ids",
"sessionId": "6093fdabd251f200015e8f92",
"tags": [
"tagResponse"
],
"target": 100,
"targetOperator": "at_least"
}
],
"sessions": [
{
"accountId": "string value",
"end": "string value",
"id": "string value",
"inherits": false,
"ownerPermissions": "OwnerPermission",
"parentId": "string value",
"permissions": [
"Permission"
],
"start": "string value",
"status": "string value",
"title": "string value"
}
]
}
},
"locked": false,
"metrics": [
{
"actual": 6,
"assignee": {
"accountId": "string value",
"avatar": "string value",
"color": "string value",
"dateDeactivated": "string value",
"dynamicValueType": "string value",
"email": "string value",
"id": "string value",
"isActive": false,
"name": "string value",
"picture": "string value",
"tags": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "ID",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
"tagResponse"
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"type": "string value"
},
"assignees": [
{
"accountId": "string value",
"avatar": "string value",
"color": "string value",
"dateDeactivated": "string value",
"dynamicValueType": "string value",
"email": "string value",
"id": "string value",
"isActive": false,
"name": "string value",
"picture": "string value",
"tags": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "ID",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
"tagResponse"
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"type": "string value"
}
],
"cascadeType": "absolute_value",
"critical": 50,
"currentUserAllowedActions": [
"string value 1",
"string value 2"
],
"description": "My Description",
"dueDate": "2021-06-30",
"dynamic": true,
"fieldName": "count",
"flowName": "string value",
"format": {
"ID": "string",
"fractionSize": 2,
"prefix": "string value",
"suffix": "string value"
},
"goalClosedStatus": {
"reason": "string value",
"status": "string value"
},
"goalDescription": "My Description",
"goalId": "string value",
"goalName": "string value",
"goalOwnerId": "string value",
"goalOwnerIds": {},
"initialValue": 2,
"insightName": "1k42vv2z24",
"links": {
"expanded": {
"goals": [
"EmbeddedGoalResponse"
],
"kpis": [
"BaseKpiResponse"
],
"metrics": [
"BaseMetricResponse"
],
"sessions": [
"BasePlanningSessionResponse"
]
}
},
"manualType": "double",
"milestones": [
{
"date": "string value",
"targetValue": 2
}
],
"name": "string value",
"numberOfOwners": 2,
"obfuscated": false,
"ownerId": "string value",
"ownerIds": {},
"private": false,
"sessionId": "6093fdabd251f200015e8f92",
"settings": [
{
"dynamicValues": [
{
"teamId": "string",
"type": "string"
}
],
"name": "string value",
"value": "string value",
"valueDisplayName": "string value",
"valueDisplayNameAsArray": [
"string value 1",
"string value 2"
]
}
],
"softDueDate": "2021-06-25",
"sourceMetricId": "6093fdabd251f200015e8f92",
"tags": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "ID",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
"tagResponse"
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"target": 100,
"targetMetrics": {},
"targetOperator": "at_least",
"tasksCount": 2,
"url": "string value",
"watchers": [
"string value 1",
"string value 2"
]
}
],
"metricsCount": 2,
"modifiedById": "string value",
"name": "string value",
"nonArchivedTasksCount": 2,
"numberOfOwners": 2,
"obfuscated": false,
"orderId": 2,
"ownerId": "string value",
"ownerIds": [
"string value 1",
"string value 2"
],
"parentGoalSessionId": "string value",
"parentId": "string value",
"parentType": "string value",
"private": false,
"sessionId": "string value",
"subTreeCount": 2,
"tags": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "ID",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
"tagResponse"
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"tasks": [
{
"access": {
"inherits": false,
"ownerPermissions": {
"deny": {
"Subtype": 2
},
"grant": {
"Subtype": 2
}
},
"permissions": [
{
"grant": {
"Subtype": 2
},
"principalId": "string",
"principalKind": "string value"
}
]
},
"accountId": "string value",
"archived": false,
"assignee": {
"accountId": "string value",
"avatar": "string value",
"color": "string value",
"dateDeactivated": "string value",
"dynamicValueType": "string value",
"email": "string value",
"id": "string value",
"isActive": false,
"name": "string value",
"picture": "string value",
"tags": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "ID",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
"tagResponse"
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"type": "string value"
},
"createdById": "string value",
"dateCreated": "string value",
"dateModified": "string value",
"description": "string value",
"dueDate": "string value",
"externalId": "string value",
"externalSystem": "string value",
"id": "string value",
"lastComment": {
"createdById": "string value",
"text": "string value"
},
"modifiedById": "string value",
"name": "string value",
"ownerId": "string value",
"parentId": "string value",
"parentName": "string value",
"parentType": "string value",
"priority": 2,
"sessionId": "string value",
"snapshots": [
{
"id": "string value",
"modifiedAt": "string value",
"modifiedBy": "string value",
"newStatus": "string value",
"oldStatus": "string value",
"previouslyModifiedAt": "string value"
}
],
"status": "string value",
"taskType": "string value"
}
],
"tasksCount": 2,
"url": "string value",
"watchers": [
"string value 1",
"string value 2"
],
"workflow": {
"approvedAt": "string value",
"reviewers": [
2
],
"reviewersNeeded": 2,
"status": "string value"
}
}
],
"totalCount": 2
}Gets a session by its unique identifier (id) in the current Quantive Results account.
Parameters
| Name | Type | Description |
|---|---|---|
| gtmhub-accountId * | string | Specifies the unique identifier (id) of the Quantive Results account. expected in header, sample value: 5be26318e5274a0007f17f61 |
| sessionId * | string | Specifies the unique identifier (id) of the session. expected in path |
Expected response codes
200 | planningSessionResponse |
400 | bad request |
401 | unauthorized |
402 | payment required |
403 | forbidden |
404 | not found |
500 | internal server error |
curl -X GET 'https://app.quantive.com/results/api/v1/sessions/{sessionId}' \ -H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {token}' \
-H 'gtmhub-accountId: 5be26318e5274a0007f17f61' \
var settings = { "url": "https://app.quantive.com/results/api/v1/sessions/{sessionId}", "method": "GET", "timeout": 0, "headers": { "Content-Type": "application/json", "Accept": "application/json", "Authorization": "Bearer {token}",
"gtmhub-accountId": "5be26318e5274a0007f17f61",
}
}; $.ajax(settings).done(function (response) { console.log(response); });
NOTE: You must install the module requests.
In a terminal window do: pip install requests
import requests, json
headers = { "Authorization" : "Bearer {token}", "gtmhub-accountId" : "{accountId}", "Content-Type" : "application/json" };
url = "https://app.quantive.com/results/api/v1/sessions/{sessionId}"
requests.get(url, headers = headers)
{
"accountId": "string value",
"cadence": {
"ranges": [
{
"cadenceOrder": 2,
"end": "string value",
"start": "string value"
}
],
"totalCadences": 2,
"type": "string value"
},
"cadenceStart": {
"dayOfMonth": 2,
"periodOfMonth": "string",
"weekday": 2
},
"cadenceTimeZone": "string value",
"color": "string value",
"currentUserAllowedActions": [
"string value 1",
"string value 2"
],
"demo": false,
"dynamicValueType": "string value",
"end": "string value",
"id": "string value",
"inherits": false,
"isSelfApproveAllowed": false,
"ownerPermissions": {
"deny": {
"Subtype": 2
},
"grant": {
"Subtype": 2
}
},
"parentId": "string value",
"permissions": [
{
"grant": {
"Subtype": 2
},
"principalId": "string",
"principalKind": "string value"
}
],
"settings": {
"assignGoalPermissions": "string value",
"assignMetricPermissions": "string value",
"goalsPerOwnerLimit": 2,
"metricsPerGoalLimit": 2,
"multipleOwners": {
"disabledForGoals": false,
"disabledForMetrics": false
},
"progressAggregationDisabled": false
},
"start": "string value",
"status": "string value",
"tags": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "ID",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
"tagResponse"
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"title": "string value",
"workflow": {
"approvalSettings": {
"everyoneCanApprove": false,
"teamsAllowedToApprove": [
"string"
],
"usersAllowedToApprove": [
"string"
]
},
"editableKrFields": [
"string value 1",
"string value 2"
],
"editableOkrFields": [
"string value 1",
"string value 2"
],
"reviewers": 2,
"target": [
"string value 1",
"string value 2"
]
}
}Gets the stats for a planning session.
Parameters
| Name | Type | Description |
|---|---|---|
| gtmhub-accountId * | string | Specifies the unique identifier (id) of the Quantive Results account. expected in header, sample value: 5be26318e5274a0007f17f61 |
| sessionId * | string | Specifies the unique identifier (id) of the session. expected in path |
| assigneeId * | string | Specifies the unique identifier (id) of the of the assignee.
It could be a single user unique identifier or a team unique identifier. expected in query, sample value: string |
| tags | string | A comma separated list of tag names/titles to filter by.
The filter is inclusive (union). For example specifying tag names as "tag1,tag2" will return all
items that have a tag1 or tag2 assigned. expected in query, sample value: string |
Expected response codes
200 | planningSessionStatsResponse |
400 | bad request |
500 | internal server error |
curl -X GET 'https://app.quantive.com/results/api/v1/sessions/{sessionId}/stats?assigneeId=string&tags=string' \ -H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {token}' \
-H 'gtmhub-accountId: 5be26318e5274a0007f17f61' \
var settings = { "url": "https://app.quantive.com/results/api/v1/sessions/{sessionId}/stats?assigneeId=string&tags=string", "method": "GET", "timeout": 0, "headers": { "Content-Type": "application/json", "Accept": "application/json", "Authorization": "Bearer {token}",
"gtmhub-accountId": "5be26318e5274a0007f17f61",
}
}; $.ajax(settings).done(function (response) { console.log(response); });
NOTE: You must install the module requests.
In a terminal window do: pip install requests
import requests, json
headers = { "Authorization" : "Bearer {token}", "gtmhub-accountId" : "{accountId}", "Content-Type" : "application/json" };
url = "https://app.quantive.com/results/api/v1/sessions/{sessionId}/stats"
requests.get(url, headers = headers)
{
"badMetricsCount": 2,
"daysToDeadline": 2,
"dynamicMetricCount": 2,
"goalCount": 2,
"goalsMetCount": 2,
"goodMetricsCount": 2,
"lastChange": 2,
"lastChangeAt": "string value",
"lastChangePercentage": 2,
"lastPeriodDelta": 2,
"lastPeriodDeltaPercentage": 2,
"manualMetricCount": 2,
"metricsCount": 2,
"metricsMetCount": 2,
"orphanedGoalCount": 2,
"peopleWithoutGoals": 2,
"periodName": "string value",
"progress": 2,
"report": {
"accountId": "string value",
"avatar": "string value",
"color": "string value",
"dateDeactivated": "string value",
"dynamicValueType": "string value",
"email": "string value",
"id": "string value",
"isActive": false,
"name": "string value",
"picture": "string value",
"tags": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "ID",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
"tagResponse"
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"type": "string value"
},
"sessionCount": 2,
"teamsWithoutGoals": 2,
"timePassedProgress": 2
}Gets the stats for a planning session.
Parameters
| Name | Type | Description |
|---|---|---|
| gtmhub-accountId * | string | Specifies the unique identifier (id) of the Quantive Results account. expected in header, sample value: 5be26318e5274a0007f17f61 |
| sessionId * | string | Specifies the unique identifier (id) of the session. expected in path |
| assigneeIds * | string | The IDs of the assignees. Can be either team or user id. expected in query, sample value: string |
| tags | string | A comma separated list of tag names/titles to filter by.
The filter is inclusive (union). For example specifying tag names as "tag1,tag2" will return all
items that have a tag1 or tag2 assigned. expected in query, sample value: string |
Expected response codes
200 | assigneesPlanningSessionStatsResponse |
400 | bad request |
403 | forbidden |
404 | not found |
500 | internal server error |
curl -X GET 'https://app.quantive.com/results/api/v1/sessions/{sessionId}/stats/assignees?assigneeIds=string&tags=string' \ -H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {token}' \
-H 'gtmhub-accountId: 5be26318e5274a0007f17f61' \
var settings = { "url": "https://app.quantive.com/results/api/v1/sessions/{sessionId}/stats/assignees?assigneeIds=string&tags=string", "method": "GET", "timeout": 0, "headers": { "Content-Type": "application/json", "Accept": "application/json", "Authorization": "Bearer {token}",
"gtmhub-accountId": "5be26318e5274a0007f17f61",
}
}; $.ajax(settings).done(function (response) { console.log(response); });
NOTE: You must install the module requests.
In a terminal window do: pip install requests
import requests, json
headers = { "Authorization" : "Bearer {token}", "gtmhub-accountId" : "{accountId}", "Content-Type" : "application/json" };
url = "https://app.quantive.com/results/api/v1/sessions/{sessionId}/stats/assignees"
requests.get(url, headers = headers)
{
"assigneeId": "string value",
"planningSessionStats": {
"badMetricsCount": 2,
"daysToDeadline": 2,
"dynamicMetricCount": 2,
"goalCount": 2,
"goalsMetCount": 2,
"goodMetricsCount": 2,
"lastChange": 2,
"lastChangeAt": "string value",
"lastChangePercentage": 2,
"lastPeriodDelta": 2,
"lastPeriodDeltaPercentage": 2,
"manualMetricCount": 2,
"metricsCount": 2,
"metricsMetCount": 2,
"orphanedGoalCount": 2,
"peopleWithoutGoals": 2,
"periodName": "string value",
"progress": 2,
"report": {
"accountId": "string value",
"avatar": "string value",
"color": "string value",
"dateDeactivated": "string value",
"dynamicValueType": "string value",
"email": "string value",
"id": "string value",
"isActive": false,
"name": "string value",
"picture": "string value",
"tags": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "ID",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
"tagResponse"
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"type": "string value"
},
"sessionCount": 2,
"teamsWithoutGoals": 2,
"timePassedProgress": 2
}
}Gets the metrics with bad progress (less than 60% of the projected for the current date).
Parameters
| Name | Type | Description |
|---|---|---|
| gtmhub-accountId * | string | Specifies the unique identifier (id) of the Quantive Results account. expected in header, sample value: 5be26318e5274a0007f17f61 |
| sessionId * | string | Specifies the unique identifier (id) of the session. expected in path |
| tags | string | A comma separated list of tag names/titles to filter by.
The filter is inclusive (union). For example specifying tag names as "tag1,tag2" will return all
items that have a tag1 or tag2 assigned. expected in query, sample value: string |
Expected response codes
200 | metricsResponse |
400 | bad request |
500 | internal server error |
curl -X GET 'https://app.quantive.com/results/api/v1/sessions/{sessionId}/stats/badMetrics?tags=string' \ -H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {token}' \
-H 'gtmhub-accountId: 5be26318e5274a0007f17f61' \
var settings = { "url": "https://app.quantive.com/results/api/v1/sessions/{sessionId}/stats/badMetrics?tags=string", "method": "GET", "timeout": 0, "headers": { "Content-Type": "application/json", "Accept": "application/json", "Authorization": "Bearer {token}",
"gtmhub-accountId": "5be26318e5274a0007f17f61",
}
}; $.ajax(settings).done(function (response) { console.log(response); });
NOTE: You must install the module requests.
In a terminal window do: pip install requests
import requests, json
headers = { "Authorization" : "Bearer {token}", "gtmhub-accountId" : "{accountId}", "Content-Type" : "application/json" };
url = "https://app.quantive.com/results/api/v1/sessions/{sessionId}/stats/badMetrics"
requests.get(url, headers = headers)
{
"items": [
{
"actual": 6,
"assignee": {
"accountId": "string value",
"avatar": "string value",
"color": "string value",
"dateDeactivated": "string value",
"dynamicValueType": "string value",
"email": "string value",
"id": "string value",
"isActive": false,
"name": "string value",
"picture": "string value",
"tags": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "ID",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
"tagResponse"
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"type": "string value"
},
"assignees": [
{
"accountId": "string value",
"avatar": "string value",
"color": "string value",
"dateDeactivated": "string value",
"dynamicValueType": "string value",
"email": "string value",
"id": "string value",
"isActive": false,
"name": "string value",
"picture": "string value",
"tags": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "ID",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
"tagResponse"
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"type": "string value"
}
],
"cascadeType": "absolute_value",
"critical": 50,
"currentUserAllowedActions": [
"string value 1",
"string value 2"
],
"description": "My Description",
"dueDate": "2021-06-30",
"dynamic": true,
"fieldName": "count",
"flowName": "string value",
"format": {
"ID": "string",
"fractionSize": 2,
"prefix": "string value",
"suffix": "string value"
},
"goalClosedStatus": {
"reason": "string value",
"status": "string value"
},
"goalDescription": "My Description",
"goalId": "string value",
"goalName": "string value",
"goalOwnerId": "string value",
"goalOwnerIds": {},
"initialValue": 2,
"insightName": "1k42vv2z24",
"links": {
"expanded": {
"goals": [
{
"access": "defaultAccess",
"accountId": "string value",
"assignee": "assigneeResponse",
"assignees": [
"assigneeResponse"
],
"attainment": 2,
"attainmentTypeString": "string value",
"createdById": "string value",
"dateCreated": "string value",
"dateFrom": "string value",
"dateTo": "string value",
"description": "string value",
"id": "string value",
"name": "string value",
"numberOfOwners": 2,
"obfuscated": false,
"ownerId": "string value",
"ownerIds": [
"string value 1",
"string value 2"
],
"parentGoalSessionId": "string value",
"parentId": "string value",
"parentType": "string value",
"private": false,
"sessionId": "string value",
"url": "string value"
}
],
"kpis": [
{
"access": "defaultAccess",
"accountId": "ID",
"aggregation": "string value",
"createdById": "ID",
"dateCreated": "string value",
"dateUpdated": "string value",
"description": "string value",
"groups": "IDs",
"id": "ID",
"mentions": "Mentions",
"modifiedById": "ID",
"name": "string value",
"obfuscated": false,
"ownerId": "ID",
"ownerIds": "IDs",
"targetOperator": "string value"
}
],
"metrics": [
{
"actual": 6,
"cascadeType": "absolute_value",
"description": "My Description",
"dynamic": true,
"fieldName": "count",
"format": "MetricFormat",
"goalId": "string value",
"goalName": "string value",
"initialValue": 2,
"insightName": "1k42vv2z24",
"manualType": "double",
"name": "string value",
"numberOfOwners": 2,
"obfuscated": false,
"ownerId": "string value",
"ownerIds": "Ids",
"sessionId": "6093fdabd251f200015e8f92",
"tags": [
"tagResponse"
],
"target": 100,
"targetOperator": "at_least"
}
],
"sessions": [
{
"accountId": "string value",
"end": "string value",
"id": "string value",
"inherits": false,
"ownerPermissions": "OwnerPermission",
"parentId": "string value",
"permissions": [
"Permission"
],
"start": "string value",
"status": "string value",
"title": "string value"
}
]
}
},
"manualType": "double",
"milestones": [
{
"date": "string value",
"targetValue": 2
}
],
"name": "string value",
"numberOfOwners": 2,
"obfuscated": false,
"ownerId": "string value",
"ownerIds": {},
"private": false,
"sessionId": "6093fdabd251f200015e8f92",
"settings": [
{
"dynamicValues": [
{
"teamId": "string",
"type": "string"
}
],
"name": "string value",
"value": "string value",
"valueDisplayName": "string value",
"valueDisplayNameAsArray": [
"string value 1",
"string value 2"
]
}
],
"softDueDate": "2021-06-25",
"sourceMetricId": "6093fdabd251f200015e8f92",
"tags": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "ID",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
"tagResponse"
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"target": 100,
"targetMetrics": {},
"targetOperator": "at_least",
"tasksCount": 2,
"url": "string value",
"watchers": [
"string value 1",
"string value 2"
]
}
],
"totalCount": 2
}Gets the dynamic metrics for the specified planning session.
Parameters
| Name | Type | Description |
|---|---|---|
| gtmhub-accountId * | string | Specifies the unique identifier (id) of the Quantive Results account. expected in header, sample value: 5be26318e5274a0007f17f61 |
| sessionId * | string | Specifies the unique identifier (id) of the session. expected in path |
| tags | string | A comma separated list of tag names/titles to filter by.
The filter is inclusive (union). For example specifying tag names as "tag1,tag2" will return all
items that have a tag1 or tag2 assigned. expected in query, sample value: string |
Expected response codes
200 | metricsResponse |
400 | bad request |
500 | internal server error |
curl -X GET 'https://app.quantive.com/results/api/v1/sessions/{sessionId}/stats/dynamicMetrics?tags=string' \ -H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {token}' \
-H 'gtmhub-accountId: 5be26318e5274a0007f17f61' \
var settings = { "url": "https://app.quantive.com/results/api/v1/sessions/{sessionId}/stats/dynamicMetrics?tags=string", "method": "GET", "timeout": 0, "headers": { "Content-Type": "application/json", "Accept": "application/json", "Authorization": "Bearer {token}",
"gtmhub-accountId": "5be26318e5274a0007f17f61",
}
}; $.ajax(settings).done(function (response) { console.log(response); });
NOTE: You must install the module requests.
In a terminal window do: pip install requests
import requests, json
headers = { "Authorization" : "Bearer {token}", "gtmhub-accountId" : "{accountId}", "Content-Type" : "application/json" };
url = "https://app.quantive.com/results/api/v1/sessions/{sessionId}/stats/dynamicMetrics"
requests.get(url, headers = headers)
{
"items": [
{
"actual": 6,
"assignee": {
"accountId": "string value",
"avatar": "string value",
"color": "string value",
"dateDeactivated": "string value",
"dynamicValueType": "string value",
"email": "string value",
"id": "string value",
"isActive": false,
"name": "string value",
"picture": "string value",
"tags": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "ID",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
"tagResponse"
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"type": "string value"
},
"assignees": [
{
"accountId": "string value",
"avatar": "string value",
"color": "string value",
"dateDeactivated": "string value",
"dynamicValueType": "string value",
"email": "string value",
"id": "string value",
"isActive": false,
"name": "string value",
"picture": "string value",
"tags": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "ID",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
"tagResponse"
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"type": "string value"
}
],
"cascadeType": "absolute_value",
"critical": 50,
"currentUserAllowedActions": [
"string value 1",
"string value 2"
],
"description": "My Description",
"dueDate": "2021-06-30",
"dynamic": true,
"fieldName": "count",
"flowName": "string value",
"format": {
"ID": "string",
"fractionSize": 2,
"prefix": "string value",
"suffix": "string value"
},
"goalClosedStatus": {
"reason": "string value",
"status": "string value"
},
"goalDescription": "My Description",
"goalId": "string value",
"goalName": "string value",
"goalOwnerId": "string value",
"goalOwnerIds": {},
"initialValue": 2,
"insightName": "1k42vv2z24",
"links": {
"expanded": {
"goals": [
{
"access": "defaultAccess",
"accountId": "string value",
"assignee": "assigneeResponse",
"assignees": [
"assigneeResponse"
],
"attainment": 2,
"attainmentTypeString": "string value",
"createdById": "string value",
"dateCreated": "string value",
"dateFrom": "string value",
"dateTo": "string value",
"description": "string value",
"id": "string value",
"name": "string value",
"numberOfOwners": 2,
"obfuscated": false,
"ownerId": "string value",
"ownerIds": [
"string value 1",
"string value 2"
],
"parentGoalSessionId": "string value",
"parentId": "string value",
"parentType": "string value",
"private": false,
"sessionId": "string value",
"url": "string value"
}
],
"kpis": [
{
"access": "defaultAccess",
"accountId": "ID",
"aggregation": "string value",
"createdById": "ID",
"dateCreated": "string value",
"dateUpdated": "string value",
"description": "string value",
"groups": "IDs",
"id": "ID",
"mentions": "Mentions",
"modifiedById": "ID",
"name": "string value",
"obfuscated": false,
"ownerId": "ID",
"ownerIds": "IDs",
"targetOperator": "string value"
}
],
"metrics": [
{
"actual": 6,
"cascadeType": "absolute_value",
"description": "My Description",
"dynamic": true,
"fieldName": "count",
"format": "MetricFormat",
"goalId": "string value",
"goalName": "string value",
"initialValue": 2,
"insightName": "1k42vv2z24",
"manualType": "double",
"name": "string value",
"numberOfOwners": 2,
"obfuscated": false,
"ownerId": "string value",
"ownerIds": "Ids",
"sessionId": "6093fdabd251f200015e8f92",
"tags": [
"tagResponse"
],
"target": 100,
"targetOperator": "at_least"
}
],
"sessions": [
{
"accountId": "string value",
"end": "string value",
"id": "string value",
"inherits": false,
"ownerPermissions": "OwnerPermission",
"parentId": "string value",
"permissions": [
"Permission"
],
"start": "string value",
"status": "string value",
"title": "string value"
}
]
}
},
"manualType": "double",
"milestones": [
{
"date": "string value",
"targetValue": 2
}
],
"name": "string value",
"numberOfOwners": 2,
"obfuscated": false,
"ownerId": "string value",
"ownerIds": {},
"private": false,
"sessionId": "6093fdabd251f200015e8f92",
"settings": [
{
"dynamicValues": [
{
"teamId": "string",
"type": "string"
}
],
"name": "string value",
"value": "string value",
"valueDisplayName": "string value",
"valueDisplayNameAsArray": [
"string value 1",
"string value 2"
]
}
],
"softDueDate": "2021-06-25",
"sourceMetricId": "6093fdabd251f200015e8f92",
"tags": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "ID",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
"tagResponse"
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"target": 100,
"targetMetrics": {},
"targetOperator": "at_least",
"tasksCount": 2,
"url": "string value",
"watchers": [
"string value 1",
"string value 2"
]
}
],
"totalCount": 2
}Gets the metrics with good progress (more than 60% of the projected for the current date).
Parameters
| Name | Type | Description |
|---|---|---|
| gtmhub-accountId * | string | Specifies the unique identifier (id) of the Quantive Results account. expected in header, sample value: 5be26318e5274a0007f17f61 |
| sessionId * | string | Specifies the unique identifier (id) of the session. expected in path |
| tags | string | A comma separated list of tag names/titles to filter by.
The filter is inclusive (union). For example specifying tag names as "tag1,tag2" will return all
items that have a tag1 or tag2 assigned. expected in query, sample value: string |
Expected response codes
200 | metricsResponse |
400 | bad request |
500 | internal server error |
curl -X GET 'https://app.quantive.com/results/api/v1/sessions/{sessionId}/stats/goodMetrics?tags=string' \ -H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {token}' \
-H 'gtmhub-accountId: 5be26318e5274a0007f17f61' \
var settings = { "url": "https://app.quantive.com/results/api/v1/sessions/{sessionId}/stats/goodMetrics?tags=string", "method": "GET", "timeout": 0, "headers": { "Content-Type": "application/json", "Accept": "application/json", "Authorization": "Bearer {token}",
"gtmhub-accountId": "5be26318e5274a0007f17f61",
}
}; $.ajax(settings).done(function (response) { console.log(response); });
NOTE: You must install the module requests.
In a terminal window do: pip install requests
import requests, json
headers = { "Authorization" : "Bearer {token}", "gtmhub-accountId" : "{accountId}", "Content-Type" : "application/json" };
url = "https://app.quantive.com/results/api/v1/sessions/{sessionId}/stats/goodMetrics"
requests.get(url, headers = headers)
{
"items": [
{
"actual": 6,
"assignee": {
"accountId": "string value",
"avatar": "string value",
"color": "string value",
"dateDeactivated": "string value",
"dynamicValueType": "string value",
"email": "string value",
"id": "string value",
"isActive": false,
"name": "string value",
"picture": "string value",
"tags": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "ID",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
"tagResponse"
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"type": "string value"
},
"assignees": [
{
"accountId": "string value",
"avatar": "string value",
"color": "string value",
"dateDeactivated": "string value",
"dynamicValueType": "string value",
"email": "string value",
"id": "string value",
"isActive": false,
"name": "string value",
"picture": "string value",
"tags": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "ID",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
"tagResponse"
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"type": "string value"
}
],
"cascadeType": "absolute_value",
"critical": 50,
"currentUserAllowedActions": [
"string value 1",
"string value 2"
],
"description": "My Description",
"dueDate": "2021-06-30",
"dynamic": true,
"fieldName": "count",
"flowName": "string value",
"format": {
"ID": "string",
"fractionSize": 2,
"prefix": "string value",
"suffix": "string value"
},
"goalClosedStatus": {
"reason": "string value",
"status": "string value"
},
"goalDescription": "My Description",
"goalId": "string value",
"goalName": "string value",
"goalOwnerId": "string value",
"goalOwnerIds": {},
"initialValue": 2,
"insightName": "1k42vv2z24",
"links": {
"expanded": {
"goals": [
{
"access": "defaultAccess",
"accountId": "string value",
"assignee": "assigneeResponse",
"assignees": [
"assigneeResponse"
],
"attainment": 2,
"attainmentTypeString": "string value",
"createdById": "string value",
"dateCreated": "string value",
"dateFrom": "string value",
"dateTo": "string value",
"description": "string value",
"id": "string value",
"name": "string value",
"numberOfOwners": 2,
"obfuscated": false,
"ownerId": "string value",
"ownerIds": [
"string value 1",
"string value 2"
],
"parentGoalSessionId": "string value",
"parentId": "string value",
"parentType": "string value",
"private": false,
"sessionId": "string value",
"url": "string value"
}
],
"kpis": [
{
"access": "defaultAccess",
"accountId": "ID",
"aggregation": "string value",
"createdById": "ID",
"dateCreated": "string value",
"dateUpdated": "string value",
"description": "string value",
"groups": "IDs",
"id": "ID",
"mentions": "Mentions",
"modifiedById": "ID",
"name": "string value",
"obfuscated": false,
"ownerId": "ID",
"ownerIds": "IDs",
"targetOperator": "string value"
}
],
"metrics": [
{
"actual": 6,
"cascadeType": "absolute_value",
"description": "My Description",
"dynamic": true,
"fieldName": "count",
"format": "MetricFormat",
"goalId": "string value",
"goalName": "string value",
"initialValue": 2,
"insightName": "1k42vv2z24",
"manualType": "double",
"name": "string value",
"numberOfOwners": 2,
"obfuscated": false,
"ownerId": "string value",
"ownerIds": "Ids",
"sessionId": "6093fdabd251f200015e8f92",
"tags": [
"tagResponse"
],
"target": 100,
"targetOperator": "at_least"
}
],
"sessions": [
{
"accountId": "string value",
"end": "string value",
"id": "string value",
"inherits": false,
"ownerPermissions": "OwnerPermission",
"parentId": "string value",
"permissions": [
"Permission"
],
"start": "string value",
"status": "string value",
"title": "string value"
}
]
}
},
"manualType": "double",
"milestones": [
{
"date": "string value",
"targetValue": 2
}
],
"name": "string value",
"numberOfOwners": 2,
"obfuscated": false,
"ownerId": "string value",
"ownerIds": {},
"private": false,
"sessionId": "6093fdabd251f200015e8f92",
"settings": [
{
"dynamicValues": [
{
"teamId": "string",
"type": "string"
}
],
"name": "string value",
"value": "string value",
"valueDisplayName": "string value",
"valueDisplayNameAsArray": [
"string value 1",
"string value 2"
]
}
],
"softDueDate": "2021-06-25",
"sourceMetricId": "6093fdabd251f200015e8f92",
"tags": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "ID",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
"tagResponse"
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"target": 100,
"targetMetrics": {},
"targetOperator": "at_least",
"tasksCount": 2,
"url": "string value",
"watchers": [
"string value 1",
"string value 2"
]
}
],
"totalCount": 2
}Gets the manual metrics for the specified planning session.
Parameters
| Name | Type | Description |
|---|---|---|
| gtmhub-accountId * | string | Specifies the unique identifier (id) of the Quantive Results account. expected in header, sample value: 5be26318e5274a0007f17f61 |
| sessionId * | string | Specifies the unique identifier (id) of the session. expected in path |
| tags | string | A comma separated list of tag names/titles to filter by.
The filter is inclusive (union). For example specifying tag names as "tag1,tag2" will return all
items that have a tag1 or tag2 assigned. expected in query, sample value: string |
Expected response codes
200 | metricsResponse |
400 | bad request |
500 | internal server error |
curl -X GET 'https://app.quantive.com/results/api/v1/sessions/{sessionId}/stats/manualMetrics?tags=string' \ -H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {token}' \
-H 'gtmhub-accountId: 5be26318e5274a0007f17f61' \
var settings = { "url": "https://app.quantive.com/results/api/v1/sessions/{sessionId}/stats/manualMetrics?tags=string", "method": "GET", "timeout": 0, "headers": { "Content-Type": "application/json", "Accept": "application/json", "Authorization": "Bearer {token}",
"gtmhub-accountId": "5be26318e5274a0007f17f61",
}
}; $.ajax(settings).done(function (response) { console.log(response); });
NOTE: You must install the module requests.
In a terminal window do: pip install requests
import requests, json
headers = { "Authorization" : "Bearer {token}", "gtmhub-accountId" : "{accountId}", "Content-Type" : "application/json" };
url = "https://app.quantive.com/results/api/v1/sessions/{sessionId}/stats/manualMetrics"
requests.get(url, headers = headers)
{
"items": [
{
"actual": 6,
"assignee": {
"accountId": "string value",
"avatar": "string value",
"color": "string value",
"dateDeactivated": "string value",
"dynamicValueType": "string value",
"email": "string value",
"id": "string value",
"isActive": false,
"name": "string value",
"picture": "string value",
"tags": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "ID",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
"tagResponse"
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"type": "string value"
},
"assignees": [
{
"accountId": "string value",
"avatar": "string value",
"color": "string value",
"dateDeactivated": "string value",
"dynamicValueType": "string value",
"email": "string value",
"id": "string value",
"isActive": false,
"name": "string value",
"picture": "string value",
"tags": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "ID",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
"tagResponse"
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"type": "string value"
}
],
"cascadeType": "absolute_value",
"critical": 50,
"currentUserAllowedActions": [
"string value 1",
"string value 2"
],
"description": "My Description",
"dueDate": "2021-06-30",
"dynamic": true,
"fieldName": "count",
"flowName": "string value",
"format": {
"ID": "string",
"fractionSize": 2,
"prefix": "string value",
"suffix": "string value"
},
"goalClosedStatus": {
"reason": "string value",
"status": "string value"
},
"goalDescription": "My Description",
"goalId": "string value",
"goalName": "string value",
"goalOwnerId": "string value",
"goalOwnerIds": {},
"initialValue": 2,
"insightName": "1k42vv2z24",
"links": {
"expanded": {
"goals": [
{
"access": "defaultAccess",
"accountId": "string value",
"assignee": "assigneeResponse",
"assignees": [
"assigneeResponse"
],
"attainment": 2,
"attainmentTypeString": "string value",
"createdById": "string value",
"dateCreated": "string value",
"dateFrom": "string value",
"dateTo": "string value",
"description": "string value",
"id": "string value",
"name": "string value",
"numberOfOwners": 2,
"obfuscated": false,
"ownerId": "string value",
"ownerIds": [
"string value 1",
"string value 2"
],
"parentGoalSessionId": "string value",
"parentId": "string value",
"parentType": "string value",
"private": false,
"sessionId": "string value",
"url": "string value"
}
],
"kpis": [
{
"access": "defaultAccess",
"accountId": "ID",
"aggregation": "string value",
"createdById": "ID",
"dateCreated": "string value",
"dateUpdated": "string value",
"description": "string value",
"groups": "IDs",
"id": "ID",
"mentions": "Mentions",
"modifiedById": "ID",
"name": "string value",
"obfuscated": false,
"ownerId": "ID",
"ownerIds": "IDs",
"targetOperator": "string value"
}
],
"metrics": [
{
"actual": 6,
"cascadeType": "absolute_value",
"description": "My Description",
"dynamic": true,
"fieldName": "count",
"format": "MetricFormat",
"goalId": "string value",
"goalName": "string value",
"initialValue": 2,
"insightName": "1k42vv2z24",
"manualType": "double",
"name": "string value",
"numberOfOwners": 2,
"obfuscated": false,
"ownerId": "string value",
"ownerIds": "Ids",
"sessionId": "6093fdabd251f200015e8f92",
"tags": [
"tagResponse"
],
"target": 100,
"targetOperator": "at_least"
}
],
"sessions": [
{
"accountId": "string value",
"end": "string value",
"id": "string value",
"inherits": false,
"ownerPermissions": "OwnerPermission",
"parentId": "string value",
"permissions": [
"Permission"
],
"start": "string value",
"status": "string value",
"title": "string value"
}
]
}
},
"manualType": "double",
"milestones": [
{
"date": "string value",
"targetValue": 2
}
],
"name": "string value",
"numberOfOwners": 2,
"obfuscated": false,
"ownerId": "string value",
"ownerIds": {},
"private": false,
"sessionId": "6093fdabd251f200015e8f92",
"settings": [
{
"dynamicValues": [
{
"teamId": "string",
"type": "string"
}
],
"name": "string value",
"value": "string value",
"valueDisplayName": "string value",
"valueDisplayNameAsArray": [
"string value 1",
"string value 2"
]
}
],
"softDueDate": "2021-06-25",
"sourceMetricId": "6093fdabd251f200015e8f92",
"tags": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "ID",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
"tagResponse"
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"target": 100,
"targetMetrics": {},
"targetOperator": "at_least",
"tasksCount": 2,
"url": "string value",
"watchers": [
"string value 1",
"string value 2"
]
}
],
"totalCount": 2
}Gets the metrics which target values have been reached in the specified planning session.
Parameters
| Name | Type | Description |
|---|---|---|
| gtmhub-accountId * | string | Specifies the unique identifier (id) of the Quantive Results account. expected in header, sample value: 5be26318e5274a0007f17f61 |
| sessionId * | string | Specifies the unique identifier (id) of the session. expected in path |
| tags | string | A comma separated list of tag names/titles to filter by.
The filter is inclusive (union). For example specifying tag names as "tag1,tag2" will return all
items that have a tag1 or tag2 assigned. expected in query, sample value: string |
Expected response codes
200 | metricsResponse |
400 | bad request |
500 | internal server error |
curl -X GET 'https://app.quantive.com/results/api/v1/sessions/{sessionId}/stats/metricsMet?tags=string' \ -H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {token}' \
-H 'gtmhub-accountId: 5be26318e5274a0007f17f61' \
var settings = { "url": "https://app.quantive.com/results/api/v1/sessions/{sessionId}/stats/metricsMet?tags=string", "method": "GET", "timeout": 0, "headers": { "Content-Type": "application/json", "Accept": "application/json", "Authorization": "Bearer {token}",
"gtmhub-accountId": "5be26318e5274a0007f17f61",
}
}; $.ajax(settings).done(function (response) { console.log(response); });
NOTE: You must install the module requests.
In a terminal window do: pip install requests
import requests, json
headers = { "Authorization" : "Bearer {token}", "gtmhub-accountId" : "{accountId}", "Content-Type" : "application/json" };
url = "https://app.quantive.com/results/api/v1/sessions/{sessionId}/stats/metricsMet"
requests.get(url, headers = headers)
{
"items": [
{
"actual": 6,
"assignee": {
"accountId": "string value",
"avatar": "string value",
"color": "string value",
"dateDeactivated": "string value",
"dynamicValueType": "string value",
"email": "string value",
"id": "string value",
"isActive": false,
"name": "string value",
"picture": "string value",
"tags": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "ID",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
"tagResponse"
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"type": "string value"
},
"assignees": [
{
"accountId": "string value",
"avatar": "string value",
"color": "string value",
"dateDeactivated": "string value",
"dynamicValueType": "string value",
"email": "string value",
"id": "string value",
"isActive": false,
"name": "string value",
"picture": "string value",
"tags": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "ID",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
"tagResponse"
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"type": "string value"
}
],
"cascadeType": "absolute_value",
"critical": 50,
"currentUserAllowedActions": [
"string value 1",
"string value 2"
],
"description": "My Description",
"dueDate": "2021-06-30",
"dynamic": true,
"fieldName": "count",
"flowName": "string value",
"format": {
"ID": "string",
"fractionSize": 2,
"prefix": "string value",
"suffix": "string value"
},
"goalClosedStatus": {
"reason": "string value",
"status": "string value"
},
"goalDescription": "My Description",
"goalId": "string value",
"goalName": "string value",
"goalOwnerId": "string value",
"goalOwnerIds": {},
"initialValue": 2,
"insightName": "1k42vv2z24",
"links": {
"expanded": {
"goals": [
{
"access": "defaultAccess",
"accountId": "string value",
"assignee": "assigneeResponse",
"assignees": [
"assigneeResponse"
],
"attainment": 2,
"attainmentTypeString": "string value",
"createdById": "string value",
"dateCreated": "string value",
"dateFrom": "string value",
"dateTo": "string value",
"description": "string value",
"id": "string value",
"name": "string value",
"numberOfOwners": 2,
"obfuscated": false,
"ownerId": "string value",
"ownerIds": [
"string value 1",
"string value 2"
],
"parentGoalSessionId": "string value",
"parentId": "string value",
"parentType": "string value",
"private": false,
"sessionId": "string value",
"url": "string value"
}
],
"kpis": [
{
"access": "defaultAccess",
"accountId": "ID",
"aggregation": "string value",
"createdById": "ID",
"dateCreated": "string value",
"dateUpdated": "string value",
"description": "string value",
"groups": "IDs",
"id": "ID",
"mentions": "Mentions",
"modifiedById": "ID",
"name": "string value",
"obfuscated": false,
"ownerId": "ID",
"ownerIds": "IDs",
"targetOperator": "string value"
}
],
"metrics": [
{
"actual": 6,
"cascadeType": "absolute_value",
"description": "My Description",
"dynamic": true,
"fieldName": "count",
"format": "MetricFormat",
"goalId": "string value",
"goalName": "string value",
"initialValue": 2,
"insightName": "1k42vv2z24",
"manualType": "double",
"name": "string value",
"numberOfOwners": 2,
"obfuscated": false,
"ownerId": "string value",
"ownerIds": "Ids",
"sessionId": "6093fdabd251f200015e8f92",
"tags": [
"tagResponse"
],
"target": 100,
"targetOperator": "at_least"
}
],
"sessions": [
{
"accountId": "string value",
"end": "string value",
"id": "string value",
"inherits": false,
"ownerPermissions": "OwnerPermission",
"parentId": "string value",
"permissions": [
"Permission"
],
"start": "string value",
"status": "string value",
"title": "string value"
}
]
}
},
"manualType": "double",
"milestones": [
{
"date": "string value",
"targetValue": 2
}
],
"name": "string value",
"numberOfOwners": 2,
"obfuscated": false,
"ownerId": "string value",
"ownerIds": {},
"private": false,
"sessionId": "6093fdabd251f200015e8f92",
"settings": [
{
"dynamicValues": [
{
"teamId": "string",
"type": "string"
}
],
"name": "string value",
"value": "string value",
"valueDisplayName": "string value",
"valueDisplayNameAsArray": [
"string value 1",
"string value 2"
]
}
],
"softDueDate": "2021-06-25",
"sourceMetricId": "6093fdabd251f200015e8f92",
"tags": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "ID",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
"tagResponse"
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"target": 100,
"targetMetrics": {},
"targetOperator": "at_least",
"tasksCount": 2,
"url": "string value",
"watchers": [
"string value 1",
"string value 2"
]
}
],
"totalCount": 2
}Creates a session in the current Quantive Results account.
Parameters
| Name | Type | Description |
|---|---|---|
| gtmhub-accountId * | string | Specifies the unique identifier (id) of the Quantive Results account. expected in header, sample value: 5be26318e5274a0007f17f61 |
| gtmhub-additional-params | string | Specifies additional parameters in the request header. expected in header |
| planningSession * | object | expected in body, sample value: {
"cadenceStart": {
"dayOfMonth": 2,
"periodOfMonth": "string",
"weekday": 2
},
"cadenceTimeZone": "Europe/Sofia",
"cadenceType": "WEEKLY",
"color": "#C9DBD7",
"end": "2021-06-12T00:00:00Z",
"inherits": false,
"isSelfApproveAllowed": false,
"ownerPermissions": {
"deny": {
"Subtype": 2
},
"grant": {
"Subtype": 2
}
},
"parentId": "6065c702b97d1200017306b1",
"permissions": [
{
"grant": {
"Subtype": 2
},
"principalId": "string",
"principalKind": "string value"
}
],
"settings": {
"assignGoalPermissions": "string value",
"assignMetricPermissions": "string value",
"goalsPerOwnerLimit": 2,
"metricsPerGoalLimit": 2,
"multipleOwners": {
"disabledForGoals": false,
"disabledForMetrics": false
},
"progressAggregationDisabled": false
},
"start": "2021-04-12T00:00:00Z",
"status": "open",
"title": "My new title"
} |
Expected response codes
201 | planningSessionResponse |
400 | bad request |
401 | unauthorized |
402 | payment required |
403 | forbidden |
500 | internal server error |
curl -X POST 'https://app.quantive.com/results/api/v1/sessions' \ -H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {token}' \
-H 'gtmhub-accountId: 5be26318e5274a0007f17f61' \
-H 'gtmhub-additional-params: ' \
-d '{"cadenceStart":{"dayOfMonth":2,"periodOfMonth":"string","weekday":2},"cadenceTimeZone":"Europe/Sofia","cadenceType":"WEEKLY","color":"#C9DBD7","end":"2021-06-12T00:00:00Z","inherits":false,"isSelfApproveAllowed":false,"ownerPermissions":{"deny":{"Subtype":2},"grant":{"Subtype":2}},"parentId":"6065c702b97d1200017306b1","permissions":[{"grant":{"Subtype":2},"principalId":"string","principalKind":"string value"}],"settings":{"assignGoalPermissions":"string value","assignMetricPermissions":"string value","goalsPerOwnerLimit":2,"metricsPerGoalLimit":2,"multipleOwners":{"disabledForGoals":false,"disabledForMetrics":false},"progressAggregationDisabled":false},"start":"2021-04-12T00:00:00Z","status":"open","title":"My new title"}'
var body ={ "cadenceStart": { "dayOfMonth": 2, "periodOfMonth": "string", "weekday": 2 }, "cadenceTimeZone": "Europe/Sofia", "cadenceType": "WEEKLY", "color": "#C9DBD7", "end": "2021-06-12T00:00:00Z", "inherits": false, "isSelfApproveAllowed": false, "ownerPermissions": { "deny": { "Subtype": 2 }, "grant": { "Subtype": 2 } }, "parentId": "6065c702b97d1200017306b1", "permissions": [ { "grant": { "Subtype": 2 }, "principalId": "string", "principalKind": "string value" } ], "settings": { "assignGoalPermissions": "string value", "assignMetricPermissions": "string value", "goalsPerOwnerLimit": 2, "metricsPerGoalLimit": 2, "multipleOwners": { "disabledForGoals": false, "disabledForMetrics": false }, "progressAggregationDisabled": false }, "start": "2021-04-12T00:00:00Z", "status": "open", "title": "My new title" };
var settings = { "url": "https://app.quantive.com/results/api/v1/sessions", "method": "POST", "timeout": 0, "headers": { "Content-Type": "application/json", "Accept": "application/json", "Authorization": "Bearer {token}",
"gtmhub-accountId": "5be26318e5274a0007f17f61",
"gtmhub-additional-params": "",
},
"data": body
}; $.ajax(settings).done(function (response) { console.log(response); });
NOTE: You must install the module requests.
In a terminal window do: pip install requests
import requests, json
headers = { "Authorization" : "Bearer {token}", "gtmhub-accountId" : "{accountId}", "Content-Type" : "application/json" };
url = "https://app.quantive.com/results/api/v1/sessions"
body = { "cadenceStart": { "dayOfMonth": 2, "periodOfMonth": "string", "weekday": 2 }, "cadenceTimeZone": "Europe/Sofia", "cadenceType": "WEEKLY", "color": "#C9DBD7", "end": "2021-06-12T00:00:00Z", "inherits": false, "isSelfApproveAllowed": false, "ownerPermissions": { "deny": { "Subtype": 2 }, "grant": { "Subtype": 2 } }, "parentId": "6065c702b97d1200017306b1", "permissions": [ { "grant": { "Subtype": 2 }, "principalId": "string", "principalKind": "string value" } ], "settings": { "assignGoalPermissions": "string value", "assignMetricPermissions": "string value", "goalsPerOwnerLimit": 2, "metricsPerGoalLimit": 2, "multipleOwners": { "disabledForGoals": false, "disabledForMetrics": false }, "progressAggregationDisabled": false }, "start": "2021-04-12T00:00:00Z", "status": "open", "title": "My new title" };
requests.post(url, data=json.dumps(body), headers = headers)
{
"accountId": "string value",
"cadence": {
"ranges": [
{
"cadenceOrder": 2,
"end": "string value",
"start": "string value"
}
],
"totalCadences": 2,
"type": "string value"
},
"cadenceStart": {
"dayOfMonth": 2,
"periodOfMonth": "string",
"weekday": 2
},
"cadenceTimeZone": "string value",
"color": "string value",
"currentUserAllowedActions": [
"string value 1",
"string value 2"
],
"demo": false,
"dynamicValueType": "string value",
"end": "string value",
"id": "string value",
"inherits": false,
"isSelfApproveAllowed": false,
"ownerPermissions": {
"deny": {
"Subtype": 2
},
"grant": {
"Subtype": 2
}
},
"parentId": "string value",
"permissions": [
{
"grant": {
"Subtype": 2
},
"principalId": "string",
"principalKind": "string value"
}
],
"settings": {
"assignGoalPermissions": "string value",
"assignMetricPermissions": "string value",
"goalsPerOwnerLimit": 2,
"metricsPerGoalLimit": 2,
"multipleOwners": {
"disabledForGoals": false,
"disabledForMetrics": false
},
"progressAggregationDisabled": false
},
"start": "string value",
"status": "string value",
"tags": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "ID",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
"tagResponse"
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"title": "string value",
"workflow": {
"approvalSettings": {
"everyoneCanApprove": false,
"teamsAllowedToApprove": [
"string"
],
"usersAllowedToApprove": [
"string"
]
},
"editableKrFields": [
"string value 1",
"string value 2"
],
"editableOkrFields": [
"string value 1",
"string value 2"
],
"reviewers": 2,
"target": [
"string value 1",
"string value 2"
]
}
}Updates an existing session.
Parameters
| Name | Type | Description |
|---|---|---|
| gtmhub-accountId * | string | Specifies the unique identifier (id) of the Quantive Results account. expected in header, sample value: 5be26318e5274a0007f17f61 |
| gtmhub-additional-params | string | Specifies additional parameters in the request header. expected in header |
| sessionId * | string | Specifies the unique identifier (id) of the session. expected in path |
| planningSession * | object | expected in body, sample value: {
"cadenceStart": {
"dayOfMonth": 2,
"periodOfMonth": "string",
"weekday": 2
},
"cadenceTimeZone": "Europe/Sofia",
"cadenceType": "WEEKLY",
"color": "#C9DBD7",
"end": "2021-06-12T00:00:00Z",
"inherits": false,
"isSelfApproveAllowed": false,
"ownerPermissions": {
"deny": {
"Subtype": 2
},
"grant": {
"Subtype": 2
}
},
"parentId": "6065c702b97d1200017306b1",
"permissions": [
{
"grant": {
"Subtype": 2
},
"principalId": "string",
"principalKind": "string value"
}
],
"settings": {
"assignGoalPermissions": "string value",
"assignMetricPermissions": "string value",
"goalsPerOwnerLimit": 2,
"metricsPerGoalLimit": 2,
"multipleOwners": {
"disabledForGoals": false,
"disabledForMetrics": false
},
"progressAggregationDisabled": false
},
"start": "2021-04-12T00:00:00Z",
"status": "open",
"title": "My new title"
} |
Expected response codes
200 | planningSessionResponse |
400 | bad request |
401 | unauthorized |
402 | payment required |
403 | forbidden |
404 | not found |
500 | internal server error |
curl -X PUT 'https://app.quantive.com/results/api/v1/sessions/{sessionId}' \ -H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {token}' \
-H 'gtmhub-accountId: 5be26318e5274a0007f17f61' \
-H 'gtmhub-additional-params: ' \
-d '{"cadenceStart":{"dayOfMonth":2,"periodOfMonth":"string","weekday":2},"cadenceTimeZone":"Europe/Sofia","cadenceType":"WEEKLY","color":"#C9DBD7","end":"2021-06-12T00:00:00Z","inherits":false,"isSelfApproveAllowed":false,"ownerPermissions":{"deny":{"Subtype":2},"grant":{"Subtype":2}},"parentId":"6065c702b97d1200017306b1","permissions":[{"grant":{"Subtype":2},"principalId":"string","principalKind":"string value"}],"settings":{"assignGoalPermissions":"string value","assignMetricPermissions":"string value","goalsPerOwnerLimit":2,"metricsPerGoalLimit":2,"multipleOwners":{"disabledForGoals":false,"disabledForMetrics":false},"progressAggregationDisabled":false},"start":"2021-04-12T00:00:00Z","status":"open","title":"My new title"}'
var body ={ "cadenceStart": { "dayOfMonth": 2, "periodOfMonth": "string", "weekday": 2 }, "cadenceTimeZone": "Europe/Sofia", "cadenceType": "WEEKLY", "color": "#C9DBD7", "end": "2021-06-12T00:00:00Z", "inherits": false, "isSelfApproveAllowed": false, "ownerPermissions": { "deny": { "Subtype": 2 }, "grant": { "Subtype": 2 } }, "parentId": "6065c702b97d1200017306b1", "permissions": [ { "grant": { "Subtype": 2 }, "principalId": "string", "principalKind": "string value" } ], "settings": { "assignGoalPermissions": "string value", "assignMetricPermissions": "string value", "goalsPerOwnerLimit": 2, "metricsPerGoalLimit": 2, "multipleOwners": { "disabledForGoals": false, "disabledForMetrics": false }, "progressAggregationDisabled": false }, "start": "2021-04-12T00:00:00Z", "status": "open", "title": "My new title" };
var settings = { "url": "https://app.quantive.com/results/api/v1/sessions/{sessionId}", "method": "PUT", "timeout": 0, "headers": { "Content-Type": "application/json", "Accept": "application/json", "Authorization": "Bearer {token}",
"gtmhub-accountId": "5be26318e5274a0007f17f61",
"gtmhub-additional-params": "",
},
"data": body
}; $.ajax(settings).done(function (response) { console.log(response); });
NOTE: You must install the module requests.
In a terminal window do: pip install requests
import requests, json
headers = { "Authorization" : "Bearer {token}", "gtmhub-accountId" : "{accountId}", "Content-Type" : "application/json" };
url = "https://app.quantive.com/results/api/v1/sessions/{sessionId}"
body = { "cadenceStart": { "dayOfMonth": 2, "periodOfMonth": "string", "weekday": 2 }, "cadenceTimeZone": "Europe/Sofia", "cadenceType": "WEEKLY", "color": "#C9DBD7", "end": "2021-06-12T00:00:00Z", "inherits": false, "isSelfApproveAllowed": false, "ownerPermissions": { "deny": { "Subtype": 2 }, "grant": { "Subtype": 2 } }, "parentId": "6065c702b97d1200017306b1", "permissions": [ { "grant": { "Subtype": 2 }, "principalId": "string", "principalKind": "string value" } ], "settings": { "assignGoalPermissions": "string value", "assignMetricPermissions": "string value", "goalsPerOwnerLimit": 2, "metricsPerGoalLimit": 2, "multipleOwners": { "disabledForGoals": false, "disabledForMetrics": false }, "progressAggregationDisabled": false }, "start": "2021-04-12T00:00:00Z", "status": "open", "title": "My new title" };
requests.put(url, data=json.dumps(body), headers = headers)
{
"accountId": "string value",
"cadence": {
"ranges": [
{
"cadenceOrder": 2,
"end": "string value",
"start": "string value"
}
],
"totalCadences": 2,
"type": "string value"
},
"cadenceStart": {
"dayOfMonth": 2,
"periodOfMonth": "string",
"weekday": 2
},
"cadenceTimeZone": "string value",
"color": "string value",
"currentUserAllowedActions": [
"string value 1",
"string value 2"
],
"demo": false,
"dynamicValueType": "string value",
"end": "string value",
"id": "string value",
"inherits": false,
"isSelfApproveAllowed": false,
"ownerPermissions": {
"deny": {
"Subtype": 2
},
"grant": {
"Subtype": 2
}
},
"parentId": "string value",
"permissions": [
{
"grant": {
"Subtype": 2
},
"principalId": "string",
"principalKind": "string value"
}
],
"settings": {
"assignGoalPermissions": "string value",
"assignMetricPermissions": "string value",
"goalsPerOwnerLimit": 2,
"metricsPerGoalLimit": 2,
"multipleOwners": {
"disabledForGoals": false,
"disabledForMetrics": false
},
"progressAggregationDisabled": false
},
"start": "string value",
"status": "string value",
"tags": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "string",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
{
"createdBy": "ID",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
"tagResponse"
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"name": "string value",
"title": "string value"
}
],
"title": "string value",
"workflow": {
"approvalSettings": {
"everyoneCanApprove": false,
"teamsAllowedToApprove": [
"string"
],
"usersAllowedToApprove": [
"string"
]
},
"editableKrFields": [
"string value 1",
"string value 2"
],
"editableOkrFields": [
"string value 1",
"string value 2"
],
"reviewers": 2,
"target": [
"string value 1",
"string value 2"
]
}
}Deletes a session by its unique identifier (id).
No request object required.
Parameters
| Name | Type | Description |
|---|---|---|
| gtmhub-accountId * | string | Specifies the unique identifier (id) of the Quantive Results account. expected in header, sample value: 5be26318e5274a0007f17f61 |
| sessionId * | string | Specifies the unique identifier (id) of the session. expected in path |
Expected response codes
200 | ok |
400 | bad request |
401 | unauthorized |
402 | payment required |
403 | forbidden |
404 | not found |
500 | internal server error |
curl -X DELETE 'https://app.quantive.com/results/api/v1/sessions/{sessionId}' \ -H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {token}' \
-H 'gtmhub-accountId: 5be26318e5274a0007f17f61' \
var settings = { "url": "https://app.quantive.com/results/api/v1/sessions/{sessionId}", "method": "DELETE", "timeout": 0, "headers": { "Content-Type": "application/json", "Accept": "application/json", "Authorization": "Bearer {token}",
"gtmhub-accountId": "5be26318e5274a0007f17f61",
}
}; $.ajax(settings).done(function (response) { console.log(response); });
NOTE: You must install the module requests.
In a terminal window do: pip install requests
import requests, json
headers = { "Authorization" : "Bearer {token}", "gtmhub-accountId" : "{accountId}", "Content-Type" : "application/json" };
url = "https://app.quantive.com/results/api/v1/sessions/{sessionId}"
requests.delete(url, headers = headers)
Oops! Looks like there are no API calls of that type for this Endpoint
