Run a check for a task | Comp AI API

Run a check for a task in Comp AI. Connect vendor systems, configure OAuth apps, run compliance checks, sync employees, manage variables, and collect.

POST /v1/integrations/tasks/{taskId}/run-check

Run a check for a task

cURL

curl --request POST \
  --url https://api.trycomp.ai/v1/integrations/tasks/{taskId}/run-check \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "connectionId": "conn_abc123",
  "checkId": "aws-s3-bucket-public-access"
}
'

Authorizations

apikeyoauth2

X-API-Key · string · header · required

API key for authentication

Path Parameters

taskId · string · required

Body

application/json

connectionId · string · required

ID of the integration connection that owns the check (call list-connections to find it).

Example:

"conn_abc123"

checkId · string · required

ID of the integration check to run (from the provider manifest — call list-checks-for-task to find available ones).

Example:

"aws-s3-bucket-public-access"

organizationId · string

Auto-resolved from your API key / session. You can omit this; it is ignored by the server.

Response

201 - undefined