Submit evidence form | Comp AI API

Submit evidence form

curl --request POST \
  --url https://api.trycomp.ai/v1/evidence-forms/{formType}/submissions \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "rows": [
    {
      "system": "Production VPC",
      "owner": "Platform",
      "environment": "prod"
    }
  ]
}
'

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({rows: [{system: 'Production VPC', owner: 'Platform', environment: 'prod'}]})
};

fetch('https://api.trycomp.ai/v1/evidence-forms/{formType}/submissions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.trycomp.ai/v1/evidence-forms/{formType}/submissions"

payload = { "rows": [
        {
            "system": "Production VPC",
            "owner": "Platform",
            "environment": "prod"
        }
    ] }
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

POST

/

v1

/

evidence-forms

/

{formType}

/

submissions

Submit evidence form

curl --request POST \
  --url https://api.trycomp.ai/v1/evidence-forms/{formType}/submissions \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "rows": [
    {
      "system": "Production VPC",
      "owner": "Platform",
      "environment": "prod"
    }
  ]
}
'

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({rows: [{system: 'Production VPC', owner: 'Platform', environment: 'prod'}]})
};

fetch('https://api.trycomp.ai/v1/evidence-forms/{formType}/submissions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.trycomp.ai/v1/evidence-forms/{formType}/submissions"

payload = { "rows": [
        {
            "system": "Production VPC",
            "owner": "Platform",
            "environment": "prod"
        }
    ] }
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

Authorizations

X-API-Key

string

header

required

API key for authentication

Headers

X-Organization-Id

string

Organization ID (required for session auth, optional for API key auth)

Path Parameters

formType

enum<string>

required

Slug of the evidence form. Call GET /v1/evidence-forms to see every form with its title.

Available options:

board-meeting,

it-leadership-meeting,

risk-committee-meeting,

meeting,

access-request,

whistleblower-report,

penetration-test,

rbac-matrix,

infrastructure-inventory,

employee-performance-evaluation,

network-diagram,

tabletop-exercise,

account-types

Body

application/json

Answers keyed by the form definition's field keys. Call GET /v1/evidence-forms/{formType} first — its form.fields lists every key, type and whether it is required. matrix fields take an array of row objects keyed by column key; file fields take the {fileName, fileKey, downloadUrl} object returned by POST /v1/evidence-forms/uploads. Forms whose submissionDateMode is auto set submissionDate server-side.

The body is of type object.

Response

201 - undefined