List labels
GET {{baseUrl}}/endpoint/labels?max=5&cursor=&expand=filters&aid=1234
Returns a list of labels.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
max | number | (Optional) Maximum number of objects to return. | |
cursor | null | (Optional) Opaque cursor used for pagination. Clients should use next value from _links instead of this parameter. | |
expand | string | This parameter is optional and determines whether to include additional details in the response. To specify multiple expansions, you can either separate the values with commas or specify the parameter multiple times. | |
aid | number | A unique identifier associated with your account group. You can retrieve your AccountGroupId from the /account-groups endpoint. Note that you must be assigned to the target account group. Specifying this parameter without being assigned to the target account group will result in an error response. |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"labels":[{"id":"abc-123-def","name":"Head office meeting rooms","color":"#ff3333","matchType":"and","filters":[{"key":"vpn-client-network","values":["10.1.1.0/24","192.168.1.0/24"],"mode":"in"},{"key":"vpn-client-network","values":["10.1.1.0/24","192.168.1.0/24"],"mode":"in"}],"_links":{"self":{"href":"https://api.thousandeyes.com/v7/link/to/resource/id","templated":false,"type":"officia aliqua commodo ex","deprecation":"non sit culpa cillum","name":"eu in","profile":"aliquip","title":"amet labore in laboris magna","hreflang":"Ut et aliqua enim"}}},{"id":"abc-123-def","name":"Head office meeting rooms","color":"#ff3333","matchType":"and","filters":[{"key":"vpn-client-network","values":["10.1.1.0/24","192.168.1.0/24"],"mode":"in"},{"key":"vpn-client-network","values":["10.1.1.0/24","192.168.1.0/24"],"mode":"in"}],"_links":{"self":{"href":"https://api.thousandeyes.com/v7/link/to/resource/id","templated":false,"type":"exerc","deprecation":"dolor elit","name":"nostrud eiusmo","profile":"eiusmod ","title":"ad dolor","hreflang":"non"}}}],"_links":{"next":{"href":"https://api.thousandeyes.com/v7/link/to/resource/id","templated":false,"type":"veniam fugiat","deprecation":"","name":"adipisicing in nisi dolor","profile":"dolor reprehenderit","title":"minim elit ut","hreflang":"veli"},"self":{"href":"https://api.thousandeyes.com/v7/link/to/resource/id","templated":false,"type":"velit","deprecation":"sed nulla","name":"aute dolore nisi","profile":"consectetur ut dolore dol","title":"in ad enim","hreflang":"sunt fugiat Excepteur"}}}