Truss API (1.0.0)
Download OpenAPI specification:Download
A security API
search products
Search for products
Request Body schema: application/jsonrequired
Search parameters are optional. Items matching all search parameters will be returned.
startdate | number <Unix Epoch Time> return products that were uploaded on or after this date |
enddate | number <Unix Epoch Time> return products that were uploaded on or before this date |
category | string Exact match for category name |
source | string Exact match for source name |
author | Array of strings Author name contains any of the strings |
title | string Returns products where the product title contains the specified string |
tags | Array of strings Return products that contain any of the specified tags |
validators | Array of strings Return products that contain any of the specified validators |
industry | Array of strings Return products that contain any of the specified industries |
region | Array of strings Return products that contain any of the specified regions |
indicators | object Return products that contain any of the specified indicators |
limit | number maximum number of results to return |
object (StartKey) when paging, use the LastEvaluatedKey returned from the previous query as the startKey for the next query | |
scanOldestToNewest | boolean Default: false Sort order of the products according to the product timestamp (true = oldest to newest) |
Responses
Request samples
- Payload
{- "startdate": 1717377710394,
- "enddate": 1717379710282,
- "category": "Ransomware",
- "source": "Cisco Talos",
- "author": [
- "Research 6",
- "Researcher 8"
], - "title": "GhostSec joint ransomware operation",
- "tags": [
- "C2",
- "AlphV"
], - "validators": [
- "0x2f5c1d8e7b3a9"
], - "industry": [
- "Government",
- "Transport"
], - "region": [
- "Cuba",
- "Argentina",
- "Poland"
], - "indicators": {
- "IPV4": [
- "94.103.91.246"
], - "FILENAME": [
- "*.ghost"
]
}, - "limit": 10,
- "startKey": {
- "GSI2PK": "Ransomware",
- "SK": "VER#0",
- "PK": "PROD#01HGR5R6S0SQDTAPMJC96ZB5BG",
- "GSI2SK": 1717377710608
}, - "scanOldestToNewest": true
}
Response samples
- 200
- default
{- "$metadata": {
- "httpStatusCode": 0,
- "requestId": "string",
- "attempts": 0,
- "totalRetryDelay": 0
}, - "Count": "string",
- "Items": [
- {
- "id": 0,
- "title": "TOR-ExitNodes_New Zealand_06/02/2024 08:00 UTC",
- "author": [
- "TOR Project",
- "Community"
], - "type": "Indicator",
- "category": "TOR",
- "source": "TOR Project",
- "pubDate": "June 02, 2024",
- "tags": [
- "TOR Project",
- "TOR Exit Nodes",
- "Truss Automation",
- "Hourly",
- "IPv4",
- "New Zealand"
], - "industry": [
- "All"
], - "region": [
- "All",
- "New Zealand"
], - "indicators": {
- "IPV4": [
- "188.114.97.7",
- "172.67.148.183"
], - "DOMAIN": [
- "aedjakodu24.ee",
- "lambhuaexpress.in",
- "manchac.com",
- "tonitto.com"
], - "SHA256": [
- "44a45c396516a3f2705eaf9751a06d346fcae1864f5521356349ce85e78fd386",
- "a467302da10ace0bf96963bcd6bdcd6a4e619e28cd477612988276dfee9f429e"
]
}
}
], - "LastEvaluatedKey": {
- "GSI2PK": "string",
- "SK": "string",
- "PK": "string",
- "GSI2SK": "string"
}, - "ScannedCount": 0
}
create product
creates a new security product
Request Body schema: application/jsonrequired
Create a new security product
title | string |
author | Array of strings |
type | string |
category | string |
source | string |
pubDate | string |
reference | Array of strings |
tags | Array of strings |
industry | Array of strings |
region | Array of strings |
indicators | object |
Responses
Request samples
- Payload
{- "title": "TOR-ExitNodes_New Zealand_06/02/2024 08:00 UTC",
- "author": [
- "TOR Project",
- "Community"
], - "type": "Indicator",
- "category": "TOR",
- "source": "TOR Project",
- "pubDate": "June 02, 2024",
- "tags": [
- "TOR Project",
- "TOR Exit Nodes",
- "Truss Automation",
- "Hourly",
- "IPv4",
- "New Zealand"
], - "industry": [
- "All"
], - "region": [
- "All",
- "New Zealand"
], - "indicators": {
- "IPV4": [
- "188.114.97.7",
- "172.67.148.183"
], - "DOMAIN": [
- "aedjakodu24.ee",
- "lambhuaexpress.in",
- "manchac.com",
- "tonitto.com"
], - "SHA256": [
- "44a45c396516a3f2705eaf9751a06d346fcae1864f5521356349ce85e78fd386",
- "a467302da10ace0bf96963bcd6bdcd6a4e619e28cd477612988276dfee9f429e"
]
}
}
Response samples
- 200
- default
{- "id": 0,
- "title": "TOR-ExitNodes_New Zealand_06/02/2024 08:00 UTC",
- "author": [
- "TOR Project",
- "Community"
], - "type": "Indicator",
- "category": "TOR",
- "source": "TOR Project",
- "pubDate": "June 02, 2024",
- "tags": [
- "TOR Project",
- "TOR Exit Nodes",
- "Truss Automation",
- "Hourly",
- "IPv4",
- "New Zealand"
], - "industry": [
- "All"
], - "region": [
- "All",
- "New Zealand"
], - "indicators": {
- "IPV4": [
- "188.114.97.7",
- "172.67.148.183"
], - "DOMAIN": [
- "aedjakodu24.ee",
- "lambhuaexpress.in",
- "manchac.com",
- "tonitto.com"
], - "SHA256": [
- "44a45c396516a3f2705eaf9751a06d346fcae1864f5521356349ce85e78fd386",
- "a467302da10ace0bf96963bcd6bdcd6a4e619e28cd477612988276dfee9f429e"
]
}
}
find product by id
Returns a product based on a product ID
path Parameters
id required | integer <int64> ID of product to fetch |
Responses
Response samples
- 200
- default
{- "id": 0,
- "title": "TOR-ExitNodes_New Zealand_06/02/2024 08:00 UTC",
- "author": [
- "TOR Project",
- "Community"
], - "type": "Indicator",
- "category": "TOR",
- "source": "TOR Project",
- "pubDate": "June 02, 2024",
- "tags": [
- "TOR Project",
- "TOR Exit Nodes",
- "Truss Automation",
- "Hourly",
- "IPv4",
- "New Zealand"
], - "industry": [
- "All"
], - "region": [
- "All",
- "New Zealand"
], - "indicators": {
- "IPV4": [
- "188.114.97.7",
- "172.67.148.183"
], - "DOMAIN": [
- "aedjakodu24.ee",
- "lambhuaexpress.in",
- "manchac.com",
- "tonitto.com"
], - "SHA256": [
- "44a45c396516a3f2705eaf9751a06d346fcae1864f5521356349ce85e78fd386",
- "a467302da10ace0bf96963bcd6bdcd6a4e619e28cd477612988276dfee9f429e"
]
}
}
update product
updates a product
Request Body schema: application/jsonrequired
Create a new security product
title | string |
author | Array of strings |
type | string |
category | string |
source | string |
pubDate | string |
reference | Array of strings |
tags | Array of strings |
industry | Array of strings |
region | Array of strings |
indicators | object |
Responses
Request samples
- Payload
{- "title": "TOR-ExitNodes_New Zealand_06/02/2024 08:00 UTC",
- "author": [
- "TOR Project",
- "Community"
], - "type": "Indicator",
- "category": "TOR",
- "source": "TOR Project",
- "pubDate": "June 02, 2024",
- "tags": [
- "TOR Project",
- "TOR Exit Nodes",
- "Truss Automation",
- "Hourly",
- "IPv4",
- "New Zealand"
], - "industry": [
- "All"
], - "region": [
- "All",
- "New Zealand"
], - "indicators": {
- "IPV4": [
- "188.114.97.7",
- "172.67.148.183"
], - "DOMAIN": [
- "aedjakodu24.ee",
- "lambhuaexpress.in",
- "manchac.com",
- "tonitto.com"
], - "SHA256": [
- "44a45c396516a3f2705eaf9751a06d346fcae1864f5521356349ce85e78fd386",
- "a467302da10ace0bf96963bcd6bdcd6a4e619e28cd477612988276dfee9f429e"
]
}
}
Response samples
- default
{- "code": 0,
- "message": "string"
}