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

cookieAuth
Type
API Key (cookie: _vulcan_session)
or
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

Authorization
Body

Samples

Powered by VitePress OpenAPI

Part of the MITRE Security Automation Framework (SAF)