Tenable Security Center API: Director Repository

This API resource is only available for administrators in Tenable.sc Director.

/mgmt/repository

Methods
GET

Gets the list of Repositories for the specified SCI linked to Director or all SCIs if no parameter is specified.

Fields Parameter
Expand

The fields parameter should be specified along the query string, and it takes the syntax

    ?fields=<field>,...

Allowed Fields

*id
*uuid
*running
*type
*dataFormat
*SCI
**name
**description
createdTime
downloadFormat
lastSyncTime
remoteID
remoteIP
sciRepID
vulnCount

Legend

* = always comes back
** = comes back if fields list not specified

red = field is a JSON object ( e.g. "SCI" : {"id" : "2", "name" : "SCI Name", "description" : "Description"} )

Request Parameters
Expand

Parameters can be passed in as a query string if specified in the format of: /mgmt/repository?sciID=<id> or in the request as JSON.

Optional

1
2
{
    "sciID" : <number>}
Example Response
Expand

No query parameters specified to get all SCI Repositories.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
{
    "error_code": 0,
    "error_msg": "",
    "response": [
        {
            "id": "4",
            "uuid": "14556FF6-034F-453A-935A-82B5682FE3E7",
            "name": "Local IPv4 Repository",
            "description": "",
            "dataFormat": "IPv4",
            "type": "Local",
            "running": "false",
            "SCI": {
                "id": "2",
                "name": "SCI 1",
                "description": ""            }
        },
        {
            "id": "6",
            "uuid": "1A9E688C-FAFD-46A6-B97E-A9D4E6E2BAD4",
            "name": "Agent Repository",
            "description": "",
            "dataFormat": "agent",
            "type": "Local",
            "running": "false",
            "SCI": {
                "id": "3",
                "name": "SCI 1"                "description": ""            }
        }
    ],
    "timestamp": 1643230109,
    "type": "regular",
    "warnings": []
}

Query parameter specified for SCI #3: /mgmt/repository?sciID=3

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{
    "error_code": 0,
    "error_msg": "",
    "response": [
        {
            "id": "6",
            "uuid": "1A9E688C-FAFD-46A6-B97E-A9D4E6E2BAD4",
            "name": "Agent Repository",
            "description": "",
            "dataFormat": "agent",
            "type": "Local",
            "running": "false",
            "SCI": {
                "id": "3",
                "name": "SCI 1"                "description": ""            }
        }
    ],
    "timestamp": 1643230109,
    "type": "regular",
    "warnings": []
}



/mgmt/repository/{id}

/mgmt/repository/{uuid}

Methods
GET

Gets the SCI Repository associated with {id} or {uuid} on Director.

Fields Parameter
Expand

The fields parameter should be specified along the query string, and it takes the syntax

    ?fields=<field>,...

Allowed Fields

*id
*uuid
*running
*type
*dataFormat
*SCI
**name
**description
**createdTime
**downloadFormat
**lastSyncTime
**remoteID
**remoteIP
**sciRepID
**vulnCount

Legend

* = always comes back
** = comes back if fields list not specified

red = field is a JSON object ( e.g. "SCI" : {"id" : "2", "name" : "SCI Name", "description" : "Description"} )

Request Parameters

None

Example Response
Expand
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
{
    "error_code": 0,
    "error_msg": "",
    "response": [
        {
            "id": "6",
            "uuid": "1A9E688C-FAFD-46A6-B97E-A9D4E6E2BAD4",
            "name": "Agent Repository",
            "description": "",
            "type": "Local",
            "SCI": {
                "id": "3",
                "name": "SCI 1"                "description": ""            },
            "sciRepID": "3",
            "dataFormat": "agent",
            "vulnCount": "0",
            "remoteID": "",
            "remoteIP": "",
            "running": "false",
            "downloadFormat": "v2",
            "lastSyncTime": "1638811912",
            "createdTime": "1639149484"        }
    ],
    "timestamp": 1643230109,
    "type": "regular",
    "warnings": []
}