Soveren Public API (1.0.0)

Download OpenAPI specification:Download

Soveren Support Team: support@soveren.io URL: https://soveren.io

Soveren Public API

Authentication

token

Security Scheme Type	HTTP
HTTP Authorization Scheme	bearer
Bearer format	"text"

Data types

Get list of data types names and IDs

Authorizations:

token

Responses

200

Successful response

401

Unauthorized

500

Internal server error

get /api/v1/data-types

Production server.

https://api.soveren.io/api/v1/data-types

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"data_types": 
[
{"id": 2,
"name": "Card number",
"sensitivity": "High"
}
],
"total": 0
}

Assets

Get list of clusters

Authorizations:

token

Responses

200

Successful response

401

Unauthorized

500

Internal server error

get /api/v1/clusters

Production server.

https://api.soveren.io/api/v1/clusters

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"clusters": 
[
{"id": 2,
"name": "private-cloud/sg-pc-6g"
}
],
"total": 0
}

Get list of assets

Authorizations:

token

query Parameters

limit	integer <int> >= 1 Default: 100 Example: limit=25 Number of entries to show.
offset	integer <int> >= 0 Default: 0 Example: offset=10 Number of entries to skip.
cluster_id	integer <int64> >= 1 Example: cluster_id=150 Cluster ID.

Responses

200

Successful response

400

Invalid request

401

Unauthorized

500

Internal server error

get /api/v1/assets

Production server.

https://api.soveren.io/api/v1/assets

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"assets": 
[
{"id": 0,
"name": "Some asset name",
"description": "string",
"owner": "John Doe",
"kind": "k8s_workload",
"info": 
{"cluster_id": 0,
"is_external": true,
"type": "endusers",
"namespace": "booking-api",
"k8s_types": 
["LoadBalancer"
],
"labels": 
[
{"key": "app.kubernetes.io/name",
"value": "nginx"
}
]
},
"data_types": 
[0
],
"first_seen_at": 1638267989332,
"last_seen_at": 1638267989332
}
],
"total": 0
}

Get an asset by ID.

Authorizations:

token

path Parameters

required

integer <int64> >= 0

Example: 150

ID.

Responses

200

Successful response

401

Unauthorized

404

Not found

500

Internal server error

get /api/v1/assets/{id}

Production server.

https://api.soveren.io/api/v1/assets/{id}

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"id": 0,
"name": "Some asset name",
"description": "string",
"owner": "John Doe",
"kind": "k8s_workload",
"info": 
{"cluster_id": 0,
"is_external": true,
"type": "endusers",
"namespace": "booking-api",
"k8s_types": 
["LoadBalancer"
],
"labels": 
[
{"key": "app.kubernetes.io/name",
"value": "nginx"
}
]
},
"data_types": 
[0
],
"first_seen_at": 1638267989332,
"last_seen_at": 1638267989332
}

Get data flows of an asset.

Authorizations:

token

path Parameters

required

integer <int64> >= 0

Example: 150

ID.

query Parameters

limit	integer <int> >= 1 Default: 100 Example: limit=25 Number of entries to show.
offset	integer <int> >= 0 Default: 0 Example: offset=10 Number of entries to skip.

Responses

200

Successful response

400

Invalid request

401

Unauthorized

500

Internal server error

get /api/v1/assets/{id}/data-flows

Production server.

https://api.soveren.io/api/v1/assets/{id}/data-flows

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"data_flows": 
[
{"asset_id": 0,
"counterparty_asset_id": 0,
"to_counterparty_data_types": 
[0
],
"from_counterparty_data_types": 
[0
],
"data_streams": 
[
{"requester_asset_id": 0,
"responder_asset_id": 0,
"endpoint_id": 0,
"request_data_types": 
[0
],
"response_data_types": 
[0
],
"last_seen_at": 1638267989332
}
]
}
],
"total": 0
}

Endpoints

Get an endpoint by ID.

Authorizations:

token

path Parameters

required

integer <int64> >= 0

Example: 150

ID.

Responses

200

Successful response

401

Unauthorized

404

Not found

500

Internal server error

get /api/v1/endpoints/{id}

Production server.

https://api.soveren.io/api/v1/endpoints/{id}

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"id": 0,
"asset_id": 0,
"hostname": "api.example.com",
"method": "GET",
"url": "/api/v1/user/[num]",
"request_data_types": 
[0
],
"response_data_types": 
[0
],
"request_data_fields": 
[
{"json_path": "users[0].profile.email",
"data_type": 0,
"masked_value": "*****@***.**"
}
],
"response_data_fields": 
[
{"json_path": "users[0].profile.email",
"data_type": 0,
"masked_value": "*****@***.**"
}
],
"last_seen_at": 1638267989332
}

Get endpoints of an asset.

Authorizations:

token

path Parameters

required

integer <int64> >= 0

Example: 150

ID.

query Parameters

limit	integer <int> >= 1 Default: 100 Example: limit=25 Number of entries to show.
offset	integer <int> >= 0 Default: 0 Example: offset=10 Number of entries to skip.

Responses

200

Successful response

400

Invalid request

401

Unauthorized

500

Internal server error

get /api/v1/assets/{id}/endpoints

Production server.

https://api.soveren.io/api/v1/assets/{id}/endpoints

Response samples

Content type

application/json

Copy

Expand all Collapse all


{"endpoints": 
[
{"id": 0,
"asset_id": 0,
"hostname": "api.example.com",
"method": "GET",
"url": "/api/v1/user/[num]",
"request_data_types": 
[0
],
"response_data_types": 
[0
],
"request_data_fields": 
[
{"json_path": "users[0].profile.email",
"data_type": 0,
"masked_value": "*****@***.**"
}
],
"response_data_fields": 
[
{"json_path": "users[0].profile.email",
"data_type": 0,
"masked_value": "*****@***.**"
}
],
"last_seen_at": 1638267989332
}
],
"total": 0
}