get https://yourapihubdomain.io/v1/purposes
This API is used to get all the Purposes that are available in the tenant.
Know your endpoint
Based on the domain you use to log in to Webex Campaign, the endpoint domain for your API varies. For more information, refer to the Know Your API Endpoints section.
Headers
The following table describes the request headers:
| Request Header | Description |
|---|---|
| content-type | application/json |
| authorization | Access token or API Secret Key in Bearer format Example: Bearer $(key) |
Request Example
https://yourapihubdomain.io/v1/purposes
https://yourapihubdomain.io/v1/purposes/582
Response Parameters
This API will return the following response parameters:
| Parameter | Description |
|---|---|
| tenantName | Returns the tenant name in which the Purpose is created. |
| name | Returns the name of the Purpose |
| id | Returns the id of the Purpose. |
| group | Returns the group name of the Purpose. |
| createdOn | Returns the Purpose created date. |
| description | Returns the description of the Purpose. |
Response Example
[
{
"id": 582,
"name": "Marketing",
"tenantName": "surya",
"createdDate": "2023-01-05 08:51:06",
"description": "Marketing P and L",
"imageUrl": "http://demo.qa.webexcampaign.io/assets/logos/Untitled.png"
},
{
"id": 581,
"name": "Sales",
"tenantName": "surya",
"createdDate": "2022-11-22 07:14:56",
"description": "Sales P and L",
"imageUrl": "http://demo.qa.webexcampaign.io/assets/logos/thumbnail.png"
},
{
"id": 579,
"name": "Presales",
"tenantName": "surya",
"createdDate": "2022-11-20 07:15:21",
"description": "Presales P and L",
"imageUrl": "http://demo.qa.webexcampaign.io/assets/logos/thumbnail.png"
}
]
Failure Response Codes
The API will return code within the response as per the following table in case of failure scenarios.
| HTTP Status Code | Code within API Response | Description |
|---|---|---|
| 400 | 400 | I/O error on post request. Cannot retry due to server authentication, in streaming mode. |
| 401 | 430 | Authorization failed. This resource is not allowed to access using this TOKEN or KEY |
| 401 | 498 | Invalid token or Access token expired |
| 404 | 404 | Not found |
| 405 | 405 | Method not supported |
| 500 | 500 | Internal server error |