GET Label

GET Tag

Request used to get a specific Label

URL

https://REGION.rest.logs.insight.rapid7.com/management/labels/:label_id

REGION is the data center for your account - e.g. "us" or "eu"

Method

GET

Authentication

Owner, Read Write or Read Only key is required.

URL Params

label_id=1777de65-61c5-4adc-b7e3-a82d9d4df9e9

Data Params

None

Success Response

Code 200Content:

json
1
{
2
  "label": {
3
    "id": "1777de65-61c5-4adc-b7e3-a82d9d4df9e9",
4
    "sn": 1022,
5
    "name": "DemoTag-Last 20min",
6
    "color": "0000cc",
7
    "reserved": false
8
  }
9
}

Error Response

Sample Call

python
1
import requests
2

3
API_KEY = '00112233-4455-6677-8899-aabbccddeeff'
4

5
def handle_response(resp):
6
    response = resp
7
    if response.status_code >= 200:
8
        print response.status_code
9
        print response.text
10
        return
11

12

13
def make_request():
14
    headers = {'x-api-key': API_KEY}
15
    url = "https://us.rest.logs.insight.rapid7.com/management/labels/1777de65-61c5-4adc-b7e3-a82d9d4df9e9"
16
    req = requests.get(url, headers=headers)
17
    return req
18

19

20
def print_query():
21
    req = make_request()
22
    handle_response(req)
23

24

25
def start():
26
    print_query()
27

28
if __name__ == '__main__':
29
    start()

Notes