{"openapi":"3.1.0","info":{"title":"Revelion API","version":"2026-03-29","description":"Drive Revelion from your own systems: start a mission, follow it, collect\nfindings, download the report.\n\n## Authentication\n\nEvery request carries an API key as a bearer token:\n\n    Authorization: Bearer rvn_live_...\n\nKeys are created in the dashboard under Settings → API. A key belongs to one\norganisation and carries scopes: `read`, `write`, or `admin`. API access\nrequires an MSP Growth plan or higher.\n\n## Idempotency\n\n`POST /v1/scans` starts a mission and spends credits. Send an `Idempotency-Key`\nheader — any string of 8–255 characters from `[A-Za-z0-9._:~+-]` — and a retry\ncarrying the same key and the same body replays the original response instead of\nstarting a second mission. Replays are marked with `Idempotent-Replay: true`.\n\nReusing a key with a *different* body is refused with `409`.\n\n## Pagination\n\nList endpoints take `limit` and `offset` and return\n`{ \"data\": [...], \"has_more\": bool, \"limit\": int, \"offset\": int }`.\n`has_more` is computed from a look-ahead, so it is accurate on the final page.\n\n## Errors\n\nErrors are returned as:\n\n    { \"error\": { \"type\": \"...\", \"code\": 422, \"message\": \"...\", \"param\": \"...\" } }\n\n`type` is stable and safe to branch on. A `4xx` will not succeed on retry; a\n`429` and a `503` will. Every response carries `X-Request-Id` — quote it when\nreporting a problem.\n\n## Events\n\nRather than polling a long-running mission, subscribe with\n`POST /v1/webhooks`. Deliveries are signed with HMAC-SHA256 over\n`{timestamp}.{body}` in the `X-Revelion-Signature` header; the signing secret is\nreturned once, when the subscription is created.\n","contact":{"name":"Revelion","url":"https://revelion.ai"}},"servers":[{"url":"https://revelion-brain.fly.dev","description":"Production"}],"tags":[{"name":"v1:scans","description":"Start, follow, pause, resume and cancel missions."},{"name":"v1:findings","description":"Read and triage what a mission found."},{"name":"v1:assets","description":"Track targets and their finding history."},{"name":"v1:reports","description":"Download reports and full mission traces."},{"name":"v1:usage","description":"Credit balance and consumption history."},{"name":"v1:webhooks","description":"Subscribe to mission events."}],"paths":{"/v1/scans":{"post":{"tags":["v1","v1:scans"],"summary":"Create Scan V1","description":"Start a mission. Requires `write` scope.\n\nSend an `Idempotency-Key` header. This endpoint spends credits, so a retry\nwithout one starts a second mission and is charged for it.","operationId":"create_scan_v1_v1_scans_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateMissionRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Mission"}}}},"422":{"description":"The request failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"No API key, or the key is invalid, expired or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope, or the plan does not include API access, or the organisation is suspended.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded. Retry after the window in `X-RateLimit-Reset`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Entitlement could not be verified. Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Idempotency-Key conflict, or the resource is not in a state that permits this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"ApiKeyAuth":[]}]},"get":{"tags":["v1","v1:scans"],"summary":"List Scans V1","description":"List missions, newest first. Requires `read` scope.","operationId":"list_scans_v1_v1_scans_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_Mission_"}}}},"422":{"description":"The request failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"No API key, or the key is invalid, expired or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope, or the plan does not include API access, or the organisation is suspended.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded. Retry after the window in `X-RateLimit-Reset`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Entitlement could not be verified. Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/scans/{scan_id}":{"get":{"tags":["v1","v1:scans"],"summary":"Get Scan V1","description":"Fetch one mission. Requires `read` scope.","operationId":"get_scan_v1_v1_scans__scan_id__get","parameters":[{"name":"scan_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Scan Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Mission"}}}},"422":{"description":"The request failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"No API key, or the key is invalid, expired or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope, or the plan does not include API access, or the organisation is suspended.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded. Retry after the window in `X-RateLimit-Reset`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Entitlement could not be verified. Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/scans/{scan_id}/cancel":{"post":{"tags":["v1","v1:scans"],"summary":"Cancel Scan V1","description":"Cancel a running scan. Requires `write` scope.","operationId":"cancel_scan_v1_v1_scans__scan_id__cancel_post","parameters":[{"name":"scan_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Scan Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"The request failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"No API key, or the key is invalid, expired or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope, or the plan does not include API access, or the organisation is suspended.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded. Retry after the window in `X-RateLimit-Reset`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Entitlement could not be verified. Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Idempotency-Key conflict, or the resource is not in a state that permits this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/scans/{scan_id}/pause":{"post":{"tags":["v1","v1:scans"],"summary":"Pause Scan V1","description":"Pause a running mission. Requires `write` scope.","operationId":"pause_scan_v1_v1_scans__scan_id__pause_post","parameters":[{"name":"scan_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Scan Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MissionControlResponse"}}}},"422":{"description":"The request failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"No API key, or the key is invalid, expired or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope, or the plan does not include API access, or the organisation is suspended.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded. Retry after the window in `X-RateLimit-Reset`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Entitlement could not be verified. Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Idempotency-Key conflict, or the resource is not in a state that permits this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/scans/{scan_id}/resume":{"post":{"tags":["v1","v1:scans"],"summary":"Resume Scan V1","description":"Resume a paused mission. Requires `write` scope.\n\nWHY THIS EXISTS ON THE PUBLIC API. `paused` is a resting state a mission can\nsit in indefinitely, and it is not terminal. Until now `resume` existed only\non the dashboard, so an unattended integration whose mission paused had no\nway to recover it: it polled a state that would never change and needed a\nhuman with a browser. That made `paused` a dead end for exactly the callers\nleast able to notice.","operationId":"resume_scan_v1_v1_scans__scan_id__resume_post","parameters":[{"name":"scan_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Scan Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MissionControlResponse"}}}},"422":{"description":"The request failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"No API key, or the key is invalid, expired or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope, or the plan does not include API access, or the organisation is suspended.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded. Retry after the window in `X-RateLimit-Reset`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Entitlement could not be verified. Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Idempotency-Key conflict, or the resource is not in a state that permits this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/scans/{scan_id}/agents":{"get":{"tags":["v1","v1:scans"],"summary":"List Agents V1","description":"List the agents working a mission. Requires `read` scope.","operationId":"list_agents_v1_v1_scans__scan_id__agents_get","parameters":[{"name":"scan_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Scan Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_MissionAgent_"}}}},"422":{"description":"The request failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"No API key, or the key is invalid, expired or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope, or the plan does not include API access, or the organisation is suspended.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded. Retry after the window in `X-RateLimit-Reset`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Entitlement could not be verified. Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/scans/{scan_id}/events":{"get":{"tags":["v1","v1:scans"],"summary":"List Events V1","description":"Read a mission's narrative. Requires `read` scope.","operationId":"list_events_v1_v1_scans__scan_id__events_get","parameters":[{"name":"scan_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Scan Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"default":200,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_MissionEvent_"}}}},"422":{"description":"The request failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"No API key, or the key is invalid, expired or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope, or the plan does not include API access, or the organisation is suspended.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded. Retry after the window in `X-RateLimit-Reset`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Entitlement could not be verified. Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/findings/scan/{scan_id}":{"get":{"tags":["v1","v1:findings"],"summary":"List Findings V1","description":"List findings for a scan. Requires `read` scope.","operationId":"list_findings_v1_v1_findings_scan__scan_id__get","parameters":[{"name":"scan_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Scan Id"}},{"name":"severity","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Severity"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_Finding_"}}}},"422":{"description":"The request failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"No API key, or the key is invalid, expired or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope, or the plan does not include API access, or the organisation is suspended.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded. Retry after the window in `X-RateLimit-Reset`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Entitlement could not be verified. Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/findings/{finding_id}":{"get":{"tags":["v1","v1:findings"],"summary":"Get Finding V1","description":"Get finding details. Requires `read` scope.","operationId":"get_finding_v1_v1_findings__finding_id__get","parameters":[{"name":"finding_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Finding Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Finding"}}}},"422":{"description":"The request failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"No API key, or the key is invalid, expired or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope, or the plan does not include API access, or the organisation is suspended.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded. Retry after the window in `X-RateLimit-Reset`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Entitlement could not be verified. Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"ApiKeyAuth":[]}]},"patch":{"tags":["v1","v1:findings"],"summary":"Update Finding V1","description":"Update finding status/validation. Requires `write` scope.","operationId":"update_finding_v1_v1_findings__finding_id__patch","parameters":[{"name":"finding_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Finding Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateFindingRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Finding"}}}},"422":{"description":"The request failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"No API key, or the key is invalid, expired or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope, or the plan does not include API access, or the organisation is suspended.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded. Retry after the window in `X-RateLimit-Reset`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Entitlement could not be verified. Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Idempotency-Key conflict, or the resource is not in a state that permits this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/assets":{"post":{"tags":["v1","v1:assets"],"summary":"Create Asset V1","description":"Create an asset. Requires `write` scope, and the key's creator must still\nbe an owner, admin or member of the organisation. `client_id` is optional;\nwhen given it must name one of the organisation's clients.","operationId":"create_asset_v1_v1_assets_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAssetRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Asset"}}}},"422":{"description":"The request failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"No API key, or the key is invalid, expired or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope, or the plan does not include API access, or the organisation is suspended.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded. Retry after the window in `X-RateLimit-Reset`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Entitlement could not be verified. Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Idempotency-Key conflict, or the resource is not in a state that permits this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"ApiKeyAuth":[]}]},"get":{"tags":["v1","v1:assets"],"summary":"List Assets V1","description":"List assets. Requires `read` scope.","operationId":"list_assets_v1_v1_assets_get","parameters":[{"name":"asset_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Asset Type"}},{"name":"environment","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Environment"}},{"name":"criticality","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Criticality"}},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","default":"created_at","title":"Sort"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_Asset_"}}}},"422":{"description":"The request failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"No API key, or the key is invalid, expired or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope, or the plan does not include API access, or the organisation is suspended.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded. Retry after the window in `X-RateLimit-Reset`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Entitlement could not be verified. Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/assets/{asset_id}":{"get":{"tags":["v1","v1:assets"],"summary":"Get Asset V1","description":"Get asset details. Requires `read` scope.","operationId":"get_asset_v1_v1_assets__asset_id__get","parameters":[{"name":"asset_id","in":"path","required":true,"schema":{"type":"string","title":"Asset Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Asset"}}}},"422":{"description":"The request failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"No API key, or the key is invalid, expired or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope, or the plan does not include API access, or the organisation is suspended.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded. Retry after the window in `X-RateLimit-Reset`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Entitlement could not be verified. Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/assets/{asset_id}/findings":{"get":{"tags":["v1","v1:assets"],"summary":"List Asset Findings V1","description":"List findings for an asset. Requires `read` scope.","operationId":"list_asset_findings_v1_v1_assets__asset_id__findings_get","parameters":[{"name":"asset_id","in":"path","required":true,"schema":{"type":"string","title":"Asset Id"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"severity","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Severity"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_Finding_"}}}},"422":{"description":"The request failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"No API key, or the key is invalid, expired or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope, or the plan does not include API access, or the organisation is suspended.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded. Retry after the window in `X-RateLimit-Reset`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Entitlement could not be verified. Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/assets/{asset_id}/scans":{"get":{"tags":["v1","v1:assets"],"summary":"Get Asset Scans V1","description":"List scan history for an asset. Requires `read` scope.","operationId":"get_asset_scans_v1_v1_assets__asset_id__scans_get","parameters":[{"name":"asset_id","in":"path","required":true,"schema":{"type":"string","title":"Asset Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_Mission_"}}}},"422":{"description":"The request failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"No API key, or the key is invalid, expired or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope, or the plan does not include API access, or the organisation is suspended.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded. Retry after the window in `X-RateLimit-Reset`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Entitlement could not be verified. Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/scans/{scan_id}/report/pdf":{"get":{"tags":["v1","v1:reports"],"summary":"Get Pdf V1","description":"Download PDF report. Requires `read` scope.","operationId":"get_pdf_v1_v1_scans__scan_id__report_pdf_get","parameters":[{"name":"scan_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Scan Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DownloadLink"}}}},"422":{"description":"The request failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"No API key, or the key is invalid, expired or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope, or the plan does not include API access, or the organisation is suspended.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded. Retry after the window in `X-RateLimit-Reset`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Entitlement could not be verified. Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/scans/{scan_id}/report/json":{"get":{"tags":["v1","v1:reports"],"summary":"Get Json V1","description":"Download JSON report. Requires `read` scope.","operationId":"get_json_v1_v1_scans__scan_id__report_json_get","parameters":[{"name":"scan_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Scan Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DownloadLink"}}}},"422":{"description":"The request failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"No API key, or the key is invalid, expired or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope, or the plan does not include API access, or the organisation is suspended.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded. Retry after the window in `X-RateLimit-Reset`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Entitlement could not be verified. Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/scans/{scan_id}/trace/json":{"get":{"tags":["v1","v1:reports"],"summary":"Get Trace Json V1","description":"Download a full mission trace as JSON. Requires `read` scope.","operationId":"get_trace_json_v1_v1_scans__scan_id__trace_json_get","parameters":[{"name":"scan_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Scan Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DownloadLink"}}}},"422":{"description":"The request failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"No API key, or the key is invalid, expired or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope, or the plan does not include API access, or the organisation is suspended.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded. Retry after the window in `X-RateLimit-Reset`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Entitlement could not be verified. Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/scans/{scan_id}/trace/markdown":{"get":{"tags":["v1","v1:reports"],"summary":"Get Trace Markdown V1","description":"Download a full mission trace as Markdown. Requires `read` scope.","operationId":"get_trace_markdown_v1_v1_scans__scan_id__trace_markdown_get","parameters":[{"name":"scan_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Scan Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DownloadLink"}}}},"422":{"description":"The request failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"No API key, or the key is invalid, expired or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope, or the plan does not include API access, or the organisation is suspended.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded. Retry after the window in `X-RateLimit-Reset`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Entitlement could not be verified. Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/usage":{"get":{"tags":["v1","v1:usage"],"summary":"Get Usage V1","description":"Credit balance for the calling organisation. Requires `read` scope.","operationId":"get_usage_v1_v1_usage_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Usage"}}}},"422":{"description":"The request failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"No API key, or the key is invalid, expired or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope, or the plan does not include API access, or the organisation is suspended.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded. Retry after the window in `X-RateLimit-Reset`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Entitlement could not be verified. Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/usage/history":{"get":{"tags":["v1","v1:usage"],"summary":"Get Usage History V1","description":"Credit usage history, newest first. Requires `read` scope.\n\nNow returns the standard page envelope. It previously returned a bare array,\nwhich gave a client no way to tell a full page from the last one.","operationId":"get_usage_history_v1_v1_usage_history_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_UsageRecord_"}}}},"422":{"description":"The request failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"No API key, or the key is invalid, expired or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope, or the plan does not include API access, or the organisation is suspended.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded. Retry after the window in `X-RateLimit-Reset`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Entitlement could not be verified. Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/webhooks/event-types":{"get":{"tags":["v1","v1:webhooks"],"summary":"List Event Types V1","description":"Every event type a subscription may ask for. Requires `read` scope.","operationId":"list_event_types_v1_v1_webhooks_event_types_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"string"},"title":"Response List Event Types V1 V1 Webhooks Event Types Get"}}}},"422":{"description":"The request failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"No API key, or the key is invalid, expired or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope, or the plan does not include API access, or the organisation is suspended.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded. Retry after the window in `X-RateLimit-Reset`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Entitlement could not be verified. Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/webhooks":{"post":{"tags":["v1","v1:webhooks"],"summary":"Create Webhook V1","description":"Subscribe to mission events. Requires `write` scope.\n\nThe signing secret is in this response and nowhere else, ever. Store it now;\nit is used to verify the `X-Revelion-Signature` header on every delivery.","operationId":"create_webhook_v1_v1_webhooks_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateWebhookRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookCreated"}}}},"422":{"description":"The request failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"No API key, or the key is invalid, expired or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope, or the plan does not include API access, or the organisation is suspended.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded. Retry after the window in `X-RateLimit-Reset`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Entitlement could not be verified. Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Idempotency-Key conflict, or the resource is not in a state that permits this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"ApiKeyAuth":[]}]},"get":{"tags":["v1","v1:webhooks"],"summary":"List Webhooks V1","description":"List subscriptions. Requires `read` scope. Never returns the secret.","operationId":"list_webhooks_v1_v1_webhooks_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_WebhookSubscription_"}}}},"422":{"description":"The request failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"No API key, or the key is invalid, expired or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope, or the plan does not include API access, or the organisation is suspended.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded. Retry after the window in `X-RateLimit-Reset`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Entitlement could not be verified. Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/webhooks/{webhook_id}":{"get":{"tags":["v1","v1:webhooks"],"summary":"Get Webhook V1","description":"Fetch one subscription. Requires `read` scope.","operationId":"get_webhook_v1_v1_webhooks__webhook_id__get","parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Webhook Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookSubscription"}}}},"422":{"description":"The request failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"No API key, or the key is invalid, expired or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope, or the plan does not include API access, or the organisation is suspended.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded. Retry after the window in `X-RateLimit-Reset`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Entitlement could not be verified. Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"ApiKeyAuth":[]}]},"patch":{"tags":["v1","v1:webhooks"],"summary":"Update Webhook V1","description":"Change a subscription. Requires `write` scope.","operationId":"update_webhook_v1_v1_webhooks__webhook_id__patch","parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Webhook Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateWebhookRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookSubscription"}}}},"422":{"description":"The request failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"No API key, or the key is invalid, expired or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope, or the plan does not include API access, or the organisation is suspended.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded. Retry after the window in `X-RateLimit-Reset`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Entitlement could not be verified. Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Idempotency-Key conflict, or the resource is not in a state that permits this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"ApiKeyAuth":[]}]},"delete":{"tags":["v1","v1:webhooks"],"summary":"Delete Webhook V1","description":"Remove a subscription. Requires `write` scope.","operationId":"delete_webhook_v1_v1_webhooks__webhook_id__delete","parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Webhook Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"The request failed validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"No API key, or the key is invalid, expired or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope, or the plan does not include API access, or the organisation is suspended.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded. Retry after the window in `X-RateLimit-Reset`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Entitlement could not be verified. Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Idempotency-Key conflict, or the resource is not in a state that permits this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"security":[{"ApiKeyAuth":[]}]}}},"components":{"schemas":{"Asset":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"asset_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Asset Type"},"target":{"anyOf":[{},{"type":"null"}],"title":"Target"},"environment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Environment"},"criticality":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Criticality"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"client_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Id"},"open_finding_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Open Finding Count"},"total_finding_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Finding Count"},"highest_severity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Highest Severity"},"risk_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Risk Score"},"last_scanned_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Scanned At"},"last_finding_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Finding At"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","name"],"title":"Asset","description":"A tracked target, with its rolled-up finding counts."},"CreateAssetRequest":{"properties":{"name":{"type":"string","title":"Name"},"asset_type":{"type":"string","enum":["web_app","network_host","ip_range","api_endpoint","source_code"],"title":"Asset Type"},"target":{"additionalProperties":true,"type":"object","title":"Target"},"environment":{"type":"string","title":"Environment","default":"production"},"criticality":{"type":"string","title":"Criticality","default":"medium"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","default":[]},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"client_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Client Id"}},"type":"object","required":["name","asset_type","target"],"title":"CreateAssetRequest"},"CreateMissionRequest":{"properties":{"name":{"type":"string","title":"Name"},"engine":{"$ref":"#/components/schemas/PublicEngineName","default":"standard"},"target":{"anyOf":[{"additionalProperties":true,"type":"object"},{"items":{"additionalProperties":true,"type":"object"},"type":"array"}],"title":"Target"},"scan_mode":{"type":"string","title":"Scan Mode","default":"normal"},"scan_type":{"type":"string","title":"Scan Type","default":"web"},"model_tier":{"type":"string","enum":["standard","heavy"],"title":"Model Tier","default":"standard"},"instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instructions"},"reasoning_effort":{"type":"string","title":"Reasoning Effort","default":"high"},"max_iterations":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Iterations"},"budget_credits":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Budget Credits"},"vpn_config_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vpn Config Id"},"compliance_standard":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Compliance Standard"},"client_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Id"},"credentials":{"anyOf":[{"items":{"$ref":"#/components/schemas/ScanCredential"},"type":"array"},{"type":"null"}],"title":"Credentials"},"authorization_confirmed":{"type":"boolean","title":"Authorization Confirmed","default":false},"execution_mode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Execution Mode"}},"type":"object","required":["name","target"],"title":"CreateMissionRequest"},"CreateWebhookRequest":{"properties":{"url":{"type":"string","title":"Url"},"events":{"items":{"type":"string"},"type":"array","title":"Events"},"description":{"type":"string","title":"Description","default":""}},"type":"object","required":["url","events"],"title":"CreateWebhookRequest"},"DownloadLink":{"properties":{"url":{"type":"string","title":"Url"},"filename":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filename"},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Type"},"size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Size Bytes"}},"type":"object","required":["url"],"title":"DownloadLink","description":"A short-lived URL for a generated artifact.\n\nThe URL carries its own signature and expiry; fetch it promptly rather than\nstoring it."},"Finding":{"properties":{"id":{"type":"string","title":"Id"},"scan_id":{"type":"string","title":"Scan Id"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"},"finding_ref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Finding Ref"},"title":{"type":"string","title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"severity":{"type":"string","title":"Severity"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"cvss_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cvss Score"},"cwe_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cwe Id"},"cve_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cve Id"},"owasp_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Owasp Category"},"finding_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Finding Type"},"proof_of_concept":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Proof Of Concept"},"evidence":{"anyOf":[{},{"type":"null"}],"title":"Evidence"},"affected_endpoints":{"anyOf":[{},{"type":"null"}],"title":"Affected Endpoints"},"target_system":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target System"},"business_impact":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Business Impact"},"remediation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Remediation"},"remediation_immediate":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Remediation Immediate"},"remediation_short_term":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Remediation Short Term"},"remediation_long_term":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Remediation Long Term"},"effort_estimate":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Effort Estimate"},"validated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Validated"},"validation_evidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Validation Evidence"},"duplicate_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Duplicate Of"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","scan_id","title","severity"],"title":"Finding","description":"A vulnerability a mission found."},"Mission":{"properties":{"id":{"type":"string","title":"Id"},"engine":{"$ref":"#/components/schemas/RecordedEngineName","default":"standard"},"name":{"type":"string","title":"Name"},"status":{"type":"string","enum":["pending","running","paused","completed","error","cancelled"],"title":"Status"},"target":{"anyOf":[{"additionalProperties":true,"type":"object"},{"items":{"additionalProperties":true,"type":"object"},"type":"array"}],"title":"Target"},"scan_mode":{"type":"string","title":"Scan Mode"},"scan_type":{"type":"string","title":"Scan Type"},"model_tier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model Tier"},"execution_mode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Execution Mode"},"instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instructions"},"reasoning_effort":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reasoning Effort"},"max_iterations":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Iterations"},"budget_credits":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Budget Credits"},"compliance_standard":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Compliance Standard"},"client_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Id"},"asset_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Asset Id"},"schedule_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Schedule Id"},"vpn_config_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vpn Config Id"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message","description":"Why the mission ended in `error`."},"result":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Result"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Started At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","name","status","target","scan_mode","scan_type"],"title":"Mission","description":"A mission (a scan), as the API presents it."},"MissionAgent":{"properties":{"id":{"type":"string","title":"Id"},"scan_id":{"type":"string","title":"Scan Id"},"agent_name":{"type":"string","title":"Agent Name"},"task":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"parent_agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Agent Id"},"iteration":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Iteration"},"max_iterations":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Iterations"},"completed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Completed"},"waiting_for_input":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Waiting For Input"},"result":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Result"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","scan_id","agent_name"],"title":"MissionAgent","description":"One agent working a mission."},"MissionControlResponse":{"properties":{"status":{"type":"string","enum":["pending","running","paused","completed","error","cancelled"],"title":"Status"},"pause_reasons":{"items":{"type":"string"},"type":"array","title":"Pause Reasons","default":[]}},"type":"object","required":["status"],"title":"MissionControlResponse","description":"The outcome of a pause or resume."},"MissionEvent":{"properties":{"id":{"type":"string","title":"Id"},"scan_id":{"type":"string","title":"Scan Id"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"},"event_type":{"type":"string","title":"Event Type"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Data"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["id","scan_id","event_type"],"title":"MissionEvent","description":"One entry in a mission's narrative."},"Page_Asset_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Asset"},"type":"array","title":"Data"},"has_more":{"type":"boolean","title":"Has More"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"}},"type":"object","required":["data","has_more","limit","offset"],"title":"Page[Asset]"},"Page_Finding_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Finding"},"type":"array","title":"Data"},"has_more":{"type":"boolean","title":"Has More"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"}},"type":"object","required":["data","has_more","limit","offset"],"title":"Page[Finding]"},"Page_MissionAgent_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/MissionAgent"},"type":"array","title":"Data"},"has_more":{"type":"boolean","title":"Has More"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"}},"type":"object","required":["data","has_more","limit","offset"],"title":"Page[MissionAgent]"},"Page_MissionEvent_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/MissionEvent"},"type":"array","title":"Data"},"has_more":{"type":"boolean","title":"Has More"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"}},"type":"object","required":["data","has_more","limit","offset"],"title":"Page[MissionEvent]"},"Page_Mission_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Mission"},"type":"array","title":"Data"},"has_more":{"type":"boolean","title":"Has More"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"}},"type":"object","required":["data","has_more","limit","offset"],"title":"Page[Mission]"},"Page_UsageRecord_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/UsageRecord"},"type":"array","title":"Data"},"has_more":{"type":"boolean","title":"Has More"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"}},"type":"object","required":["data","has_more","limit","offset"],"title":"Page[UsageRecord]"},"Page_WebhookSubscription_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/WebhookSubscription"},"type":"array","title":"Data"},"has_more":{"type":"boolean","title":"Has More"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"}},"type":"object","required":["data","has_more","limit","offset"],"title":"Page[WebhookSubscription]"},"PublicEngineName":{"type":"string","enum":["standard"],"title":"PublicEngineName","description":"Engines supported by the public API; internal placeholders stay private."},"RecordedEngineName":{"type":"string","enum":["standard","harrier"],"title":"RecordedEngineName","description":"Truthful history; this is not the public launch request's enum."},"ScanCredential":{"properties":{"credential_type":{"type":"string","enum":["username_password","bearer_token","cookie","custom_headers"],"title":"Credential Type"},"label":{"type":"string","title":"Label","default":""},"username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Username"},"password":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Password"},"login_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Login Url"},"token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Token"},"header_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Header Name"},"cookie_string":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cookie String"},"headers":{"anyOf":[{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array"},{"type":"null"}],"title":"Headers"}},"type":"object","required":["credential_type"],"title":"ScanCredential"},"UpdateFindingRequest":{"properties":{"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"validated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Validated"},"validation_evidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Validation Evidence"}},"type":"object","title":"UpdateFindingRequest"},"UpdateWebhookRequest":{"properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"events":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Events"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Active"}},"type":"object","title":"UpdateWebhookRequest"},"Usage":{"properties":{"credits_remaining":{"type":"number","title":"Credits Remaining"},"total_credits_used":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Credits Used"},"usage_records":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Usage Records"}},"type":"object","required":["credits_remaining"],"title":"Usage","description":"Credit position for the calling organisation."},"UsageRecord":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"scan_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scan Id"},"credits_used":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Credits Used"},"operation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Operation"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"}},"type":"object","title":"UsageRecord","description":"One credit-consuming event."},"WebhookCreated":{"properties":{"id":{"type":"string","title":"Id"},"url":{"type":"string","title":"Url"},"events":{"items":{"type":"string"},"type":"array","title":"Events"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Active"},"disabled_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Disabled Reason"},"secret_prefix":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Secret Prefix","description":"First characters of the signing secret, to identify it. Not the secret."},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"secret":{"type":"string","title":"Secret","description":"Signing secret. Shown once; store it now."}},"type":"object","required":["id","url","events","secret"],"title":"WebhookCreated","description":"The create response, and the only place the secret ever appears."},"WebhookSubscription":{"properties":{"id":{"type":"string","title":"Id"},"url":{"type":"string","title":"Url"},"events":{"items":{"type":"string"},"type":"array","title":"Events"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Active"},"disabled_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Disabled Reason"},"secret_prefix":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Secret Prefix","description":"First characters of the signing secret, to identify it. Not the secret."},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","url","events"],"title":"WebhookSubscription","description":"A subscription to mission events.\n\nThe signing secret is NOT here: it is returned exactly once, by the create\ncall, in ``WebhookCreated``."},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["type","code","message"],"properties":{"type":{"type":"string","description":"Stable machine-readable error class.","examples":["authentication_error","validation_error","rate_limit_exceeded"]},"code":{"type":"integer","description":"HTTP status code."},"message":{"type":"string","description":"Human-readable explanation."},"param":{"type":"string","description":"Dotted path of the offending field, when applicable."},"details":{"type":"array","description":"Per-field validation problems. Never echoes the submitted value.","items":{"type":"object","properties":{"param":{"type":"string"},"message":{"type":"string"},"type":{"type":"string"}}}}}}}}},"securitySchemes":{"ApiKeyAuth":{"type":"http","scheme":"bearer","description":"An API key beginning `rvn_live_`."}}},"security":[{"ApiKeyAuth":[]}]}