curl --request POST \
--url 'https://api.nsr.stateset.com/api/v1/flywheel/process' \
--header 'X-API-Key: YOUR_API_KEY'
{
"new_candidates": [
{
"artifact_type": "Rule",
"content": null,
"created_at": "2026-07-24T12:00:00Z",
"evidence_events": [],
"id": "string",
"org_id": "string",
"reviewed_at": "2026-07-24T12:00:00Z",
"reviewed_by": "string",
"status": "Pending"
}
],
"stats": {
"approved_candidates": 1,
"auto_promoted": 1,
"pending_candidates": 1,
"processed_events": 1,
"queued_events": 1,
"rejected_candidates": 1
},
"total_new_candidates": 1
}
Flywheel process handler
Required scope: write
POST
/
api
/
v1
/
flywheel
/
process
curl --request POST \
--url 'https://api.nsr.stateset.com/api/v1/flywheel/process' \
--header 'X-API-Key: YOUR_API_KEY'
{
"new_candidates": [
{
"artifact_type": "Rule",
"content": null,
"created_at": "2026-07-24T12:00:00Z",
"evidence_events": [],
"id": "string",
"org_id": "string",
"reviewed_at": "2026-07-24T12:00:00Z",
"reviewed_by": "string",
"status": "Pending"
}
],
"stats": {
"approved_candidates": 1,
"auto_promoted": 1,
"pending_candidates": 1,
"processed_events": 1,
"queued_events": 1,
"rejected_candidates": 1
},
"total_new_candidates": 1
}
Required scope:
write
Response
FlywheelProcessResponse
PromotionCandidate[]
required
FlywheelStats
required
integer
required
Status codes
| Code | Meaning |
|---|---|
200 | Processed queue and generated promotion candidates |
401 | Unauthorized — missing or invalid credentials |
403 | Forbidden — the key/token lacks the required scope |
429 | Rate limited — see Retry-After / X-RateLimit-Reset |
curl --request POST \
--url 'https://api.nsr.stateset.com/api/v1/flywheel/process' \
--header 'X-API-Key: YOUR_API_KEY'
{
"new_candidates": [
{
"artifact_type": "Rule",
"content": null,
"created_at": "2026-07-24T12:00:00Z",
"evidence_events": [],
"id": "string",
"org_id": "string",
"reviewed_at": "2026-07-24T12:00:00Z",
"reviewed_by": "string",
"status": "Pending"
}
],
"stats": {
"approved_candidates": 1,
"auto_promoted": 1,
"pending_candidates": 1,
"processed_events": 1,
"queued_events": 1,
"rejected_candidates": 1
},
"total_new_candidates": 1
}