System View Reports
Get all Reports for a System View
Get all Reports resources for a System View.
GET /api/v2/system-view/{system_view_id}/reports/
Query Parameters
Fields | Required | Description |
---|---|---|
search | No | Filter search queries by name. |
GET /api/v2/system-view/1/reports/ HTTP/1.1
Accept: application/json
Authorization: Token "YOUR SDE ACCESS TOKEN"
HTTP/1.1 200 OK
Content-Type: application/json
{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"id": 1,
"name": "Sample Report 1",
"description": "",
"system_view": {
"id": 1,
"name": "View One"
},
"regulation": {
"db_id": 1,
"item_id": "REG1",
"name": "Regulation One"
},
"created": "2025-04-16T14:59:37.971395-04:00",
"created_by": 1,
"modified": "2025-04-16T14:59:55.568031-04:00",
"modified_by": 1
},
{
"id": 2,
"name": "Sample Report 2",
"description": "",
"system_view": {
"id": 1,
"name": "View One"
},
"regulation": {
"db_id": 11,
"item_id": "REG11",
"name": "Regulation Eleven"
},
"created": "2025-04-16T15:03:04.256405-04:00",
"created_by": 1,
"modified": "2025-04-16T15:03:36.926868-04:00",
"modified_by": 1
}
]
}
Expand Parameters
See the Expand Parameters section for more details.
Parameter | Description |
---|---|
created_by | created_by field is expanded. |
GET /api/v2/system-view/3/reports/?expand=created_by HTTP/1.1
Accept: application/json
Authorization: Token "YOUR SDE ACCESS TOKEN"
HTTP/1.1 200 OK
Content-Type: application/json
{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"id": 1,
"name": "Sample Report 1",
"description": "",
"system_view": {
"id": 3,
"name": "View One"
},
"regulation": {
"db_id": 2,
"item_id": "REG2",
"name": "HIPAA"
},
"created": "2025-05-26T15:03:15.354990-04:00",
"created_by": {
"id": 1,
"email": "admin@example.com",
"first_name": "Admin",
"last_name": "Testerton",
"is_active": true,
"role": {
"id": "UR4",
"name": "Administrator"
}
},
"modified": "2025-05-26T15:03:15.355002-04:00",
"modified_by": 1
},
{
"id": 2,
"name": "Sample Report 2",
"description": "",
"system_view": {
"id": 3,
"name": "View One"
},
"regulation": {
"db_id": 2,
"item_id": "REG2",
"name": "HIPAA"
},
"created": "2025-05-26T15:03:43.625842-04:00",
"created_by": {
"id": 1,
"email": "admin@example.com",
"first_name": "Admin",
"last_name": "Testerton",
"is_active": true,
"role": {
"id": "UR4",
"name": "Administrator"
}
},
"modified": "2025-05-26T15:03:43.625853-04:00",
"modified_by": 1
}
]
}
Get a specific Report for a System View
Returns a single System View Report resource for a System View, as specified by the URL parameter.
GET /api/v2/system-view/{system_view_id}/reports/{system_view_report_id}/
URL Parameters
Parameter | Description |
---|---|
system_view_id | The ID of an existing System View to be retrieved. |
system_view_report_id | The ID of an existing System View Report to be retrieved. |
GET /api/v2/system-view/1/reports/1/ HTTP/1.1
Accept: application/json
Authorization: Token "YOUR SDE ACCESS TOKEN"
HTTP/1.1 200 OK
Content-Type: application/json
{
"id": 1,
"name": "Sample Report 1",
"description": "",
"system_view": {
"id": 1,
"name": "View One"
},
"regulation": {
"db_id": 1,
"item_id": "REG1",
"name": "Regulation One"
},
"created": "2025-04-16T14:59:37.971395-04:00",
"created_by": 1,
"modified": "2025-04-16T14:59:55.568031-04:00",
"modified_by": 1
}
Expand Parameters
See the Expand Parameters section for more details.
Parameter | Description |
---|---|
created_by | created_by field is expanded. |
GET /api/v2/system-view/3/reports/1/?expand=created_by HTTP/1.1
Accept: application/json
Authorization: Token "YOUR SDE ACCESS TOKEN"
HTTP/1.1 200 OK
Content-Type: application/json
{
"id": 1,
"name": "Sample Report 1",
"description": "",
"system_view": {
"id": 3,
"name": "View One"
},
"regulation": {
"db_id": 2,
"item_id": "REG2",
"name": "HIPAA"
},
"created": "2025-05-26T15:03:15.354990-04:00",
"created_by": {
"id": 1,
"email": "admin@example.com",
"first_name": "Admin",
"last_name": "Testerton",
"is_active": true,
"role": {
"id": "UR4",
"name": "Administrator"
}
},
"modified": "2025-05-26T15:03:15.355002-04:00",
"modified_by": 1
}
Create a System View Report
Creates a new System View Report resource for a given System View and Regulation.
POST /api/v2/system-view/{system_view_id}/reports/
Payload
Fields | Required | Description |
---|---|---|
name | No | The name of the System View Report. |
regulation | Yes | The compliance regulation for the created the report |
description | No | The description of the System View Report |
POST /api/v2/system-view/1/reports/
Accept: application/json
Authorization: Token "YOUR SDE ACCESS TOKEN"
{
"name": "GDPR Report",
"regulation": 1
}
HTTP/1.1 201 Created
Content-Type: application/json
{
"id": 1,
"name": "GDPR Report",
"description": "",
"system_view": {
"id": 1,
"name": "View One"
},
"regulation": {
"db_id": 1,
"item_id": "REG1",
"name": "Regulation One"
},
"created": "2025-04-21T15:26:24.480098-04:00",
"created_by": 1,
"modified": "2025-04-21T15:26:24.480110-04:00",
"modified_by": 1
}
Payload Without Name
The name field is optional. If not provided, the system will generate a name for the report.
POST /api/v2/system-view/1/reports/
Accept: application/json
Authorization: Token "YOUR SDE ACCESS TOKEN"
{
"regulation": 1
}
HTTP/1.1 201 Created
Content-Type: application/json
{
"id": 1,
"name": "View One_Regulation One_Compliance Report",
"description": "",
"system_view": {
"id": 1,
"name": "View One"
},
"regulation": {
"db_id": 1,
"item_id": "REG1",
"name": "Regulation One"
},
"created": "2025-04-21T15:26:24.480098-04:00",
"created_by": 1,
"modified": "2025-04-21T15:26:24.480110-04:00",
"modified_by": 1
}
Update a System View Report for a System View
Update a single System View Report resource for a System View, as specified by the URL parameter.
PATCH /api/v2/system-view/{system_view_id}/reports/{system_view_report_id}/
URL Parameters
Parameter | Description |
---|---|
system_view_id | The ID of an existing System View to be retrieved. |
system_view_report_id | The ID of an existing System View Report to be retrieved. |
Payload
Fields | Required | Description |
---|---|---|
name | No | The name of the System View Report. |
description | No | The description of the System View Report. |
PATCH /api/v2/system-view/1/reports/1/ HTTP/1.1
Accept: application/json
Authorization: Token "YOUR SDE ACCESS TOKEN"
{
"name": "Sample Report Name",
"description": "Sample Report Description"
}
HTTP/1.1 200 OK
Content-Type: application/json
{
"id": 1,
"name": "Sample Report Name",
"description": "Sample Report Description",
"system_view": {
"id": 1,
"name": "View One"
},
"regulation": {
"db_id": 1,
"item_id": "REG1",
"name": "Regulation One"
},
"created": "2025-04-16T14:59:37.971395-04:00",
"created_by": 1,
"modified": "2025-04-16T14:59:55.568031-04:00",
"modified_by": 1
}
Delete a Sytem View Report
Deletes a Sytem View Report resource for a given system view.
DELETE /api/v2/system-view/{system_view_id}/reports/{system_view_report_id}/
URL Parameters
Parameter | Description |
---|---|
system_view_id | The ID of an existing System View. |
system_view_report_id | The ID of an existing Report for the associated System View. |
DELETE /api/v2/system-view/1/system-view-reports/1/ HTTP/1.1
Accept: application/json
Authorization: Token "YOUR SDE ACCESS TOKEN"
HTTP/1.1 204 NO CONTENT