Skip to content

Create or duplicate a component in a project

POST
/projects/{projectId}/components

Creates a new component in the project from one or more declared source SRGs, duplicates an existing component, or imports from an uploaded XCCDF/CSV file. Requires admin role on the project. The component is initialized with requirements from every declared source (full union by default, or the requirement_selections subset) — security_requirements_guide_id designates the primary.

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

JSON
{
  
"component": {
  
  
"name": "Container SRG",
  
  
"prefix": "CNTR",
  
  
"title": "Container Platform Security Technical Implementation Guide",
  
  
"version": 1,
  
  
"release": 1,
  
  
"security_requirements_guide_id": 1
  
}
}

Responses

Component created

application/json
JSON
{
  
"toast": {
  
  
"title": "Component created.",
  
  
"message": [
  
  
  
"Successfully created component Container SRG."
  
  
],
  
  
"variant": "success"
  
}
}

Playground

Server
Authorization
Body

Samples

Powered by VitePress OpenAPI

Part of the MITRE Security Automation Framework (SAF)