Deprecated endpoints
DEPRECATED
This endpoint is deprecated as of March 15, 2022.
For more information see [Quantive Results to sunset Announcements functionality](https://quantive.com/resources/bloggtmhub-sunsets-announcements-functionality)
Gets all announcements that match the specified filters
Use the ?fields= query string parameter to control the response.
Parameters
| Name | Type | Description |
|---|---|---|
| gtmhub-accountId * | string | Specifies the id of the gtmhub account. expected in header, sample value: 5be26318e5274a0007f17f61 |
| formatting | string | The formatting used for the comment. By default it is returned as 'mentionsMarkup' and it can contain markdown and special markup for mentioned people. Use 'plainText' if you want the response without markdown and special markup. expected in query, sample value: string |
Expected response codes
200 | announcementsResponse |
400 | bad request |
401 | unauthorized |
402 | payment required |
403 | forbidden |
500 | internal server error |
curl -X GET 'https://app.quantive.com/results/api/v1/announcements?formatting=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/announcements?formatting=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/announcements"
requests.get(url, headers = headers)
{
"items": [
{
"announcementTargetId": "string value",
"announcementType": "string value",
"author": {
"accountId": "string value",
"dateCreated": "string value",
"email": "string value",
"firstName": "string value",
"id": "string value",
"language": "string value",
"lastName": "string value",
"name": "string value",
"picture": "string value"
},
"authorId": "string value",
"comment": "string value",
"dateCreated": "string value",
"id": "string value",
"notificationStrategy": "string value",
"notify": [
"string value 1",
"string value 2"
]
}
],
"totalCount": 2
}DEPRECATED
This endpoint is deprecated as of March 15, 2022.
For more information see [Quantive Results to sunset Announcements functionality](https://quantive.com/resources/bloggtmhub-sunsets-announcements-functionality)
Gets a single announcement based on the specified id
Parameters
| Name | Type | Description |
|---|---|---|
| gtmhub-accountId * | string | Specifies the id of the gtmhub account. expected in header, sample value: 5be26318e5274a0007f17f61 |
| id * | string | The ID of the announcement. expected in path, sample value: 5be26318e5274a0007f17f61 |
| formatting | string | The formatting used for the comment. By default it is returned as 'mentionsMarkup' and it can contain markdown and special markup for mentioned people. Use 'plainText' if you want the response without markdown and special markup. expected in query, sample value: string |
Expected response codes
200 | announcementResponse |
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/announcements/{id}?formatting=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/announcements/{id}?formatting=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/announcements/{id}"
requests.get(url, headers = headers)
{
"announcementTargetId": "string value",
"announcementType": "string value",
"author": {
"accountId": "string value",
"dateCreated": "string value",
"email": "string value",
"firstName": "string value",
"id": "string value",
"language": "string value",
"lastName": "string value",
"name": "string value",
"picture": "string value"
},
"authorId": "string value",
"comment": "string value",
"dateCreated": "string value",
"id": "string value",
"notificationStrategy": "string value",
"notify": [
"string value 1",
"string value 2"
]
}DEPRECATED
Gets metrics (key results) by a specified owner identifier (id).
This method is deprecated.
Use GET Key Results with ownerIds filter instead.
Parameters
| Name | Type | Description |
|---|---|---|
| gtmhub-accountId * | string | Specifies the unique identifier (id) of the Quantive Results account. expected in header, sample value: 5be26318e5274a0007f17f61 |
| ownerId * | string | The unique identifier of the owner (id). expected in path |
| formatting | string | The formatting used for the description and custom fields of type text area.
By default returned as 'mentionsMarkup' (Ex: "@[Mariya Velikova:mariya@okrs.tech:602a65efc05575000123291b]").
Use 'plainText' if you need the response to be returned without markdown and special markup (Ex: "@Mariya Velikova"). expected in query, sample value: string |
Expected response codes
200 | metricsResponse |
400 | bad request |
401 | unauthorized |
402 | payment required |
403 | forbidden |
500 | internal server error |
curl -X GET 'https://app.quantive.com/results/api/v1/metrics/owner/{ownerId}?formatting=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/metrics/owner/{ownerId}?formatting=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/metrics/owner/{ownerId}"
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
}DEPRECATED
This endpoint is deprecated as of March 15, 2022.
For more information see [Quantive Results to sunset Announcements functionality](https://quantive.com/resources/bloggtmhub-sunsets-announcements-functionality)
Creates an announcement in the current gtmhub account.
Parameters
| Name | Type | Description |
|---|---|---|
| gtmhub-accountId * | string | Specifies the id of the gtmhub account. expected in header, sample value: 5be26318e5274a0007f17f61 |
| announcement * | object | expected in body, sample value: {
"announcementTargetId": "string value",
"announcementType": "string value",
"authorID": "string value",
"comment": "string value",
"notificationStrategy": "string value",
"notify": [
"string value 1",
"string value 2"
]
} |
Expected response codes
201 | announcementResponse |
400 | bad request |
401 | unauthorized |
402 | payment required |
403 | forbidden |
500 | internal server error |
curl -X POST 'https://app.quantive.com/results/api/v1/announcements' \ -H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {token}' \
-H 'gtmhub-accountId: 5be26318e5274a0007f17f61' \
-d '{"announcementTargetId":"string value","announcementType":"string value","authorID":"string value","comment":"string value","notificationStrategy":"string value","notify":["string value 1","string value 2"]}'
var body ={ "announcementTargetId": "string value", "announcementType": "string value", "authorID": "string value", "comment": "string value", "notificationStrategy": "string value", "notify": [ "string value 1", "string value 2" ] };
var settings = { "url": "https://app.quantive.com/results/api/v1/announcements", "method": "POST", "timeout": 0, "headers": { "Content-Type": "application/json", "Accept": "application/json", "Authorization": "Bearer {token}",
"gtmhub-accountId": "5be26318e5274a0007f17f61",
},
"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/announcements"
body = { "announcementTargetId": "string value", "announcementType": "string value", "authorID": "string value", "comment": "string value", "notificationStrategy": "string value", "notify": [ "string value 1", "string value 2" ] };
requests.post(url, data=json.dumps(body), headers = headers)
{
"announcementTargetId": "string value",
"announcementType": "string value",
"author": {
"accountId": "string value",
"dateCreated": "string value",
"email": "string value",
"firstName": "string value",
"id": "string value",
"language": "string value",
"lastName": "string value",
"name": "string value",
"picture": "string value"
},
"authorId": "string value",
"comment": "string value",
"dateCreated": "string value",
"id": "string value",
"notificationStrategy": "string value",
"notify": [
"string value 1",
"string value 2"
]
}DEPRECATED
Updates an Objective.
This endpoint is deprecated.
Use PATCH Objective instead.
Parameters
| Name | Type | Description |
|---|---|---|
| gtmhub-accountId * | string | Specifies the unique identifier (id) of the Quantive Results account. expected in header, sample value: 5be26318e5274a0007f17f61 |
| goalId * | string | Specifies the unique identifier of the goal (objective). expected in path, sample value: 6138969ab6adf10001fc329c |
| goal * | object | The object representing the goal to be updated. expected in body, sample value: {
"attainmentTypeString": "average_children",
"customFields": "customFieldMultiselectDropdown:[\"602b8dc804f94000010daae1\",\"602a65efc05575000123291b\"]",
"description": "Becoming a market leader definitely does not happen overnight, but rather takes careful planning and hard work.",
"links": {},
"name": "Become a market leader",
"ownerId": "string value",
"ownerIds": {},
"parentId": "6184ed271a35460001f26588",
"private": false,
"sessionId": "3284gh256a36860111f56578"
} |
Expected response codes
200 | goalMetricsLinksResponse |
400 | bad request |
401 | unauthorized |
402 | payment required |
403 | forbidden |
404 | not found |
423 | item is locked |
500 | internal server error |
curl -X PUT 'https://app.quantive.com/results/api/v1/goals/{goalId}' \ -H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {token}' \
-H 'gtmhub-accountId: 5be26318e5274a0007f17f61' \
-d '{"attainmentTypeString":"average_children","customFields":"customFieldMultiselectDropdown:[\"602b8dc804f94000010daae1\",\"602a65efc05575000123291b\"]","description":"Becoming a market leader definitely does not happen overnight, but rather takes careful planning and hard work.","links":{},"name":"Become a market leader","ownerId":"string value","ownerIds":{},"parentId":"6184ed271a35460001f26588","private":false,"sessionId":"3284gh256a36860111f56578"}'
var body ={ "attainmentTypeString": "average_children", "customFields": "customFieldMultiselectDropdown:[\"602b8dc804f94000010daae1\",\"602a65efc05575000123291b\"]", "description": "Becoming a market leader definitely does not happen overnight, but rather takes careful planning and hard work.", "links": {}, "name": "Become a market leader", "ownerId": "string value", "ownerIds": {}, "parentId": "6184ed271a35460001f26588", "private": false, "sessionId": "3284gh256a36860111f56578" };
var settings = { "url": "https://app.quantive.com/results/api/v1/goals/{goalId}", "method": "PUT", "timeout": 0, "headers": { "Content-Type": "application/json", "Accept": "application/json", "Authorization": "Bearer {token}",
"gtmhub-accountId": "5be26318e5274a0007f17f61",
},
"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/goals/{goalId}"
body = { "attainmentTypeString": "average_children", "customFields": "customFieldMultiselectDropdown:[\"602b8dc804f94000010daae1\",\"602a65efc05575000123291b\"]", "description": "Becoming a market leader definitely does not happen overnight, but rather takes careful planning and hard work.", "links": {}, "name": "Become a market leader", "ownerId": "string value", "ownerIds": {}, "parentId": "6184ed271a35460001f26588", "private": false, "sessionId": "3284gh256a36860111f56578" };
requests.put(url, data=json.dumps(body), headers = headers)
{
"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": "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"
},
"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": "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"
}
],
"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": {
"inherits": false,
"ownerPermissions": "OwnerPermission",
"permissions": [
"Permission"
]
},
"accountId": "string value",
"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": [
"tagResponse"
],
"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": [
"tagResponse"
],
"type": "string value"
}
],
"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": {
"inherits": false,
"ownerPermissions": "OwnerPermission",
"permissions": [
"Permission"
]
},
"accountId": "string",
"aggregation": "string value",
"createdById": "string",
"dateCreated": "string value",
"dateUpdated": "string value",
"description": "string value",
"groups": [
"ID"
],
"id": "string",
"mentions": {},
"modifiedById": "string",
"name": "string value",
"obfuscated": false,
"ownerId": "string",
"ownerIds": [
"ID"
],
"targetOperator": "string value"
}
],
"metrics": [
{
"actual": 6,
"cascadeType": "absolute_value",
"description": "My Description",
"dynamic": true,
"fieldName": "count",
"format": {
"ID": "ID",
"fractionSize": 2,
"prefix": "string value",
"suffix": "string value"
},
"goalId": "string value",
"goalName": "string value",
"initialValue": 2,
"insightName": "1k42vv2z24",
"manualType": "double",
"name": "string value",
"numberOfOwners": 2,
"obfuscated": false,
"ownerId": "string value",
"ownerIds": {},
"sessionId": "6093fdabd251f200015e8f92",
"tags": [
{
"createdBy": "ID",
"dateCreated": "string value",
"id": "string value",
"isActive": false,
"items": [
"tagResponse"
],
"name": "string value",
"title": "string value"
}
],
"target": 100,
"targetOperator": "at_least"
}
],
"sessions": [
{
"accountId": "string value",
"end": "string value",
"id": "string value",
"inherits": false,
"ownerPermissions": {
"deny": "Binary",
"grant": "Binary"
},
"parentId": "string value",
"permissions": [
{
"grant": "Binary",
"principalId": "ID",
"principalKind": "string value"
}
],
"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": "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"
]
}
],
"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": "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"
}
],
"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": "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"
},
"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"
}
}DEPRECATED
Updates an existing goal.
This endpoint is deprecated.
Confidence is available on a Key Result level.
Use PATCH Key Result instead.
Parameters
| Name | Type | Description |
|---|---|---|
| goalId * | string | Specifies the unique identifier of the goal (objective). expected in path, sample value: 6138969ab6adf10001fc329c |
| goalConfidence * | object | expected in body, sample value: {
"reason": "string value",
"value": 2
} |
Expected response codes
200 | goal |
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/goals/{goalId}/confidence' \ -H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {token}' \
-d '{"reason":"string value","value":2}'
var body ={ "reason": "string value", "value": 2 };
var settings = { "url": "https://app.quantive.com/results/api/v1/goals/{goalId}/confidence", "method": "PUT", "timeout": 0, "headers": { "Content-Type": "application/json", "Accept": "application/json", "Authorization": "Bearer {token}",
},
"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/goals/{goalId}/confidence"
body = { "reason": "string value", "value": 2 };
requests.put(url, data=json.dumps(body), headers = headers)
{
"accountId": "string",
"aggregatedAttainment": 2,
"attainment": 2,
"attainmentType": 2,
"calculationStatus": 2,
"childrenAggregatedAttainment": 2,
"childrenCount": 2,
"childrenKRAttainment": 2,
"closedStatus": {
"Reason": "string value",
"Status": 2
},
"createdById": "string",
"dateCreated": "string value",
"dateFrom": "string value",
"dateTo": "string value",
"deletedAt": "string value",
"deletedById": "string",
"deletionReason": 2,
"description": "string value",
"designScore": {
"policies": [
{
"passed": false,
"policy": "string value",
"score": 2
}
],
"totalPoints": 2
},
"duration": 2,
"fullAggregatedAttainment": 2,
"fullSubTreeCount": 2,
"id": "string",
"inherits": false,
"isDeleted": false,
"lastCalculated": "string value",
"links": {
"expanded": {
"goals": [
{
"accountId": "string",
"attainment": 2,
"attainmentType": 2,
"createdById": "string",
"dateCreated": "string value",
"dateFrom": "string value",
"dateTo": "string value",
"description": "string value",
"id": "string",
"inherits": false,
"isDeleted": false,
"name": "string value",
"ownerIds": [
"ID"
],
"owner_permissions": {
"deny": "Binary",
"grant": "Binary"
},
"parent": {
"goalId": "ID",
"metricGoalId": "ID",
"metricId": "ID",
"sessionId": "ID"
},
"permissions": [
{
"grant": "Binary",
"principalId": "ID",
"principalKind": "string value"
}
],
"private": false,
"sessionId": "string"
}
],
"kpis": [
{
"access": {
"inherits": false,
"owner_permissions": "OwnerPermission",
"permissions": [
"Permission"
]
},
"accountId": "string",
"aggregation": "string value",
"createdById": "string",
"dateCreated": "string value",
"dateUpdated": "string value",
"description": "string value",
"groups": [
"ID"
],
"id": "string",
"mentions": {},
"modifiedById": "string",
"name": "string value",
"ownerId": "string",
"ownerIds": [
"ID"
],
"targetOperator": "string value"
}
],
"metrics": [
{
"actual": 2,
"attainment": 2,
"cascadeType": "string value",
"createdById": "string",
"dateCreated": "string value",
"description": "string value",
"fieldName": "string value",
"format": {
"ID": "ID",
"fractionSize": 2,
"prefix": "string value",
"suffix": "string value"
},
"goalId": "string",
"id": "string",
"inherits": false,
"initialValue": 2,
"insightName": "string value",
"isDeleted": false,
"manualType": "string value",
"modifiedById": "string",
"name": "string value",
"objectId": "string",
"ownerIds": [
"ID"
],
"owner_permissions": {
"deny": "Binary",
"grant": "Binary"
},
"parent": {
"private": false
},
"permissions": [
{
"grant": "Binary",
"principalId": "ID",
"principalKind": "string value"
}
],
"tags": [
{
"id": "ID",
"isActive": "IsActiveFlag",
"name": "string value",
"title": "string value"
}
],
"target": 2,
"targetOperator": "string value"
}
],
"sessions": [
{
"accountId": "string",
"end": "string value",
"id": "string",
"inherits": false,
"isDeleted": false,
"owner_permissions": {
"deny": "Binary",
"grant": "Binary"
},
"parentId": "string",
"permissions": [
{
"grant": "Binary",
"principalId": "ID",
"principalKind": "string value"
}
],
"start": "string value",
"status": "string value",
"title": "string value"
}
]
}
},
"mentions": {},
"metricsAttainment": 2,
"metricsCount": 2,
"modifiedById": "string",
"name": "string value",
"nonArchivedTasksCount": 2,
"orderId": 2,
"ownerIds": [
"string"
],
"owner_permissions": {
"deny": {
"Subtype": 2
},
"grant": {
"Subtype": 2
}
},
"parent": {
"goalId": "string",
"metricGoalId": "string",
"metricId": "string",
"sessionId": "string"
},
"permissions": [
{
"grant": {
"Subtype": 2
},
"principalId": "string",
"principalKind": "string value"
}
],
"private": false,
"sessionId": "string",
"subTreeCount": 2,
"tags": [
{
"id": "string",
"isActive": {
"DateDeactivated": "string value",
"IsActive": false
},
"name": "string value",
"title": "string value"
}
],
"tasksCount": 2,
"watchers": [
"string"
],
"workflow": {
"ApprovedAt": "string value",
"Reviewers": [
{
"Response": 2,
"UserId": "string"
}
],
"ReviewersNeeded": 2,
"Status": 2
}
}DEPRECATED
Updates the user's personal settings.
This endpoint is deprecated.
Use PUT Users instead.
Parameters
| Name | Type | Description |
|---|---|---|
| gtmhub-accountId * | string | Specifies the unique identifier (id) of the gtmhub account. expected in header, sample value: 5be26318e5274a0007f17f61 |
| gtmhub-additional-params | string | Internal use only.
Specifies additional parameters in the request header. expected in header |
Expected response codes
200 | ok |
400 | bad request |
404 | not found |
500 | internal server error |
curl -X PUT 'https://app.quantive.com/results/api/v1/users/settings' \ -H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {token}' \
-H 'gtmhub-accountId: 5be26318e5274a0007f17f61' \
-H 'gtmhub-additional-params: ' \
var settings = { "url": "https://app.quantive.com/results/api/v1/users/settings", "method": "PUT", "timeout": 0, "headers": { "Content-Type": "application/json", "Accept": "application/json", "Authorization": "Bearer {token}",
"gtmhub-accountId": "5be26318e5274a0007f17f61",
"gtmhub-additional-params": "",
}
}; $.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/users/settings"
requests.put(url, headers = headers)
DEPRECATED
This endpoint is deprecated as of March 15, 2022.
For more information see [Quantive Results to sunset Announcements functionality](https://quantive.com/resources/bloggtmhub-sunsets-announcements-functionality)
Updates the specified announcement.
Parameters
| Name | Type | Description |
|---|---|---|
| gtmhub-accountId * | string | Specifies the id of the gtmhub account. expected in header, sample value: 5be26318e5274a0007f17f61 |
| id * | string | The ID of the announcement. expected in path, sample value: 5be26318e5274a0007f17f61 |
| announcement * | object | expected in body, sample value: {
"comment": "string value"
} |
Expected response codes
200 | announcementResponse |
400 | bad request |
401 | unauthorized |
402 | payment required |
403 | forbidden |
500 | internal server error |
curl -X PATCH 'https://app.quantive.com/results/api/v1/announcements/{id}' \ -H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer {token}' \
-H 'gtmhub-accountId: 5be26318e5274a0007f17f61' \
-d '{"comment":"string value"}'
var body ={ "comment": "string value" };
var settings = { "url": "https://app.quantive.com/results/api/v1/announcements/{id}", "method": "PATCH", "timeout": 0, "headers": { "Content-Type": "application/json", "Accept": "application/json", "Authorization": "Bearer {token}",
"gtmhub-accountId": "5be26318e5274a0007f17f61",
},
"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/announcements/{id}"
body = { "comment": "string value" };
requests.patch(url, data=json.dumps(body), headers = headers)
{
"announcementTargetId": "string value",
"announcementType": "string value",
"author": {
"accountId": "string value",
"dateCreated": "string value",
"email": "string value",
"firstName": "string value",
"id": "string value",
"language": "string value",
"lastName": "string value",
"name": "string value",
"picture": "string value"
},
"authorId": "string value",
"comment": "string value",
"dateCreated": "string value",
"id": "string value",
"notificationStrategy": "string value",
"notify": [
"string value 1",
"string value 2"
]
}DEPRECATED
This endpoint is deprecated as of March 15, 2022.
For more information see [Quantive Results to sunset Announcements functionality](https://quantive.com/resources/bloggtmhub-sunsets-announcements-functionality)
Deletes an announcement based on the provided id.
Parameters
| Name | Type | Description |
|---|---|---|
| gtmhub-accountId * | string | Specifies the id of the gtmhub account. expected in header, sample value: 5be26318e5274a0007f17f61 |
| id * | string | The ID of the announcement. expected in path, sample value: 5be26318e5274a0007f17f61 |
Expected response codes
204 | no content |
400 | bad request |
401 | unauthorized |
402 | payment required |
403 | forbidden |
500 | internal server error |
curl -X DELETE 'https://app.quantive.com/results/api/v1/announcements/{id}' \ -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/announcements/{id}", "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/announcements/{id}"
requests.delete(url, headers = headers)
DEPRECATED
This endpoint is deprecated as of March 15, 2022.
For more information see [Quantive Results to sunset Announcements functionality](https://quantive.com/resources/bloggtmhub-sunsets-announcements-functionality)
Deletes a reaction from an announcement.
Parameters
| Name | Type | Description |
|---|---|---|
| gtmhub-accountId * | string | Specifies the id of the gtmhub account. expected in header, sample value: 5be26318e5274a0007f17f61 |
| id * | string | The ID of the announcement. expected in path, sample value: 5be26318e5274a0007f17f61 |
Expected response codes
200 | announcementResponse |
400 | bad request |
401 | unauthorized |
402 | payment required |
403 | forbidden |
500 | internal server error |
curl -X DELETE 'https://app.quantive.com/results/api/v1/announcements/{id}/react' \ -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/announcements/{id}/react", "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/announcements/{id}/react"
requests.delete(url, headers = headers)
{
"announcementTargetId": "string value",
"announcementType": "string value",
"author": {
"accountId": "string value",
"dateCreated": "string value",
"email": "string value",
"firstName": "string value",
"id": "string value",
"language": "string value",
"lastName": "string value",
"name": "string value",
"picture": "string value"
},
"authorId": "string value",
"comment": "string value",
"dateCreated": "string value",
"id": "string value",
"notificationStrategy": "string value",
"notify": [
"string value 1",
"string value 2"
]
}Oops! Looks like there are no API calls of that type for this Endpoint
