Skip to content

Detect which SRG a spreadsheet belongs to

POST
/components/detect_srg

Analyzes an uploaded spreadsheet (CSV/XLSX) to determine which SRG its rule IDs match. Used by the component creation flow to auto-select the correct SRG when importing from a spreadsheet. Returns the matched SRG's id, srg_id, title, and version. Returns 422 if no file provided, no SRG IDs found, no matching SRG exists, or IDs map to multiple SRGs.

Authorizations

tokenAuth

Personal access token authentication. Send via Authorization header: Authorization: Token vulcan_xxx. Tokens are SHA-256 hashed server-side (never stored in plaintext). Scopes: read (GET), write (mutations), admin (everything). Create tokens via Settings → API Tokens in the web UI.

Type
HTTP (token)

Request Body

multipart/form-data

CSV or XLSX spreadsheet containing rule IDs.

Format"binary"

Responses

Matched SRG

application/json
JSON
{
  
"id": 1,
  
"srg_id": "Container_Platform_SRG",
  
"title": "Container Platform Security Requirements Guide",
  
"version": "V2R4"
}

Playground

Server
Authorization
Body

Samples

Powered by VitePress OpenAPI

Part of the MITRE Security Automation Framework (SAF)