{ "info": { "title": "aisecurity.llc Report API", "version": "0.1.0", "description": "API contract seed for The State of AI Security Engineering Report 2026." }, "paths": { "/rest/v1/v_navigation": { "get": { "tags": [ "dashboard_contract" ], "summary": "Dashboard Navigation", "responses": { "200": { "content": { "application/json": { "schema": { "mode": "rows", "type": "array" } } }, "description": "Successful response" } }, "parameters": [ { "name": "select", "type": "text" } ], "description": "Navigation groups and pages for frontend shell.", "operationId": "dashboard-navigation", "x-public-safe": true, "x-access-level": "public", "x-cache-policy": "long" } }, "/rest/v1/v_page_contract": { "get": { "tags": [ "dashboard_contract" ], "summary": "Dashboard Page Contract", "responses": { "200": { "content": { "application/json": { "schema": { "mode": "rows", "type": "array" } } }, "description": "Successful response" } }, "parameters": [ { "name": "page_slug", "type": "eq" }, { "name": "route_path", "type": "eq" } ], "description": "Page contract with components, charts, filters, and assets.", "operationId": "dashboard-page-contract", "x-public-safe": true, "x-access-level": "public", "x-cache-policy": "long" } }, "/rest/v1/v_prompt_export": { "get": { "tags": [ "content_generation" ], "summary": "Content Prompt Export", "responses": { "200": { "content": { "application/json": { "schema": { "mode": "rows", "type": "array" } } }, "description": "Successful response" } }, "parameters": [], "description": "Active prompt template export.", "operationId": "content-prompt-export", "x-public-safe": true, "x-access-level": "internal", "x-cache-policy": "long" } }, "/rest/v1/sponsor_packages": { "get": { "tags": [ "sponsor" ], "summary": "Sponsor Packages", "responses": { "200": { "content": { "application/json": { "schema": { "mode": "rows", "type": "array" } } }, "description": "Successful response" } }, "parameters": [ { "name": "package_tier", "type": "eq" }, { "name": "status", "type": "eq" } ], "description": "Sponsor package definitions and deliverables.", "operationId": "sponsor-packages", "x-public-safe": true, "x-access-level": "public", "x-cache-policy": "medium" } }, "/rest/v1/v_chart_contract": { "get": { "tags": [ "dashboard_contract" ], "summary": "Dashboard Chart Contract", "responses": { "200": { "content": { "application/json": { "schema": { "mode": "rows", "type": "array" } } }, "description": "Successful response" } }, "parameters": [ { "name": "chart_id", "type": "eq" }, { "name": "chart_family", "type": "eq" } ], "description": "Chart rendering contracts and series.", "operationId": "dashboard-chart-contract", "x-public-safe": true, "x-access-level": "public", "x-cache-policy": "long" } }, "/rest/v1/v_claim_readiness": { "get": { "tags": [ "claims" ], "summary": "Public Claim Readiness", "responses": { "200": { "content": { "application/json": { "schema": { "mode": "rows", "type": "array" } } }, "description": "Successful response" } }, "parameters": [ { "name": "claim_readiness", "type": "eq" }, { "name": "select", "type": "text" } ], "description": "Report claim readiness and usage guidance.", "operationId": "public-claim-readiness", "x-public-safe": true, "x-access-level": "public", "x-cache-policy": "medium" } }, "/rest/v1/v_report_overview": { "get": { "tags": [ "public_report" ], "summary": "Public Report Overview View", "responses": { "200": { "content": { "application/json": { "schema": { "mode": "rows", "type": "array" } } }, "description": "Successful response" } }, "parameters": [ { "name": "select", "type": "text" } ], "description": "Direct public report overview view.", "operationId": "public-report-overview-view", "x-public-safe": true, "x-access-level": "public", "x-cache-policy": "medium" } }, "/rest/v1/v_export_inventory": { "get": { "tags": [ "quality" ], "summary": "Export Inventory", "responses": { "200": { "content": { "application/json": { "schema": { "mode": "rows", "type": "array" } } }, "description": "Successful response" } }, "parameters": [], "description": "Export inventory and redaction status.", "operationId": "export-inventory", "x-public-safe": true, "x-access-level": "internal", "x-cache-policy": "medium" } }, "/rest/v1/v_content_job_queue": { "get": { "tags": [ "content_generation" ], "summary": "Content Job Queue", "responses": { "200": { "content": { "application/json": { "schema": { "mode": "rows", "type": "array" } } }, "description": "Successful response" } }, "parameters": [ { "name": "job_family", "type": "eq" }, { "name": "status", "type": "in" }, { "name": "limit", "type": "integer" } ], "description": "Content generation job queue.", "operationId": "content-job-queue", "x-public-safe": true, "x-access-level": "internal", "x-cache-policy": "short" } }, "/rest/v1/v_signal_benchmarks": { "get": { "tags": [ "signals" ], "summary": "Public Signal Benchmarks", "responses": { "200": { "content": { "application/json": { "schema": { "mode": "rows", "type": "array" } } }, "description": "Successful response" } }, "parameters": [ { "name": "signal_family", "type": "eq" }, { "name": "dataset_period", "type": "eq" }, { "name": "limit", "type": "integer" }, { "name": "order", "type": "text" } ], "description": "Skill, tool, framework, and attack-surface benchmark rows.", "operationId": "public-signal-benchmarks", "x-public-safe": true, "x-access-level": "public", "x-cache-policy": "medium" } }, "/rest/v1/rpc/search_companies": { "post": { "tags": [ "internal_abm" ], "summary": "Search Companies", "responses": { "200": { "content": { "application/json": { "schema": { "mode": "rows", "type": "array" } } }, "description": "Successful response" } }, "parameters": [ { "name": "p_query", "type": "text" }, { "name": "p_industry_ids", "type": "text[]" }, { "name": "p_company_size_band_ids", "type": "text[]" }, { "name": "p_recommended_motion", "type": "text" }, { "name": "p_min_opportunity_score", "type": "numeric" }, { "name": "p_limit", "type": "integer", "default": 100 }, { "name": "p_offset", "type": "integer", "default": 0 } ], "description": "Internal ABM company search with opportunity scores.", "operationId": "search-companies", "x-public-safe": true, "x-access-level": "internal", "x-cache-policy": "short" } }, "/rest/v1/v_sponsor_categories": { "get": { "tags": [ "sponsor" ], "summary": "Sponsor Categories", "responses": { "200": { "content": { "application/json": { "schema": { "mode": "rows", "type": "array" } } }, "description": "Successful response" } }, "parameters": [], "description": "Sponsor category inventory for sponsor prospectus.", "operationId": "sponsor-categories", "x-public-safe": true, "x-access-level": "public", "x-cache-policy": "medium" } }, "/rest/v1/rpc/get_chart_dataset": { "post": { "tags": [ "charts" ], "summary": "Get Chart Dataset", "responses": { "200": { "content": { "application/json": { "schema": { "mode": "array", "type": "jsonb" } } }, "description": "Successful response" } }, "parameters": [ { "name": "p_dataset_period", "type": "text", "default": "2026" }, { "name": "p_limit", "type": "integer", "default": 100 } ], "description": "Generic chart dataset RPC by chart ID.", "operationId": "get-chart-dataset", "x-public-safe": true, "x-access-level": "public", "x-cache-policy": "short" } }, "/rest/v1/rpc/get_chart_registry": { "post": { "tags": [ "charts" ], "summary": "Get Chart Registry", "responses": { "200": { "content": { "application/json": { "schema": { "mode": "rows", "type": "array" } } }, "description": "Successful response" } }, "parameters": [], "description": "Report chart registry.", "operationId": "get-chart-registry", "x-public-safe": true, "x-access-level": "public", "x-cache-policy": "long" } }, "/rest/v1/rpc/get_company_context": { "post": { "tags": [ "internal_abm" ], "summary": "Get Company Context", "responses": { "200": { "content": { "application/json": { "schema": { "mode": "object", "type": "jsonb" } } }, "description": "Successful response" } }, "parameters": [ { "name": "p_company_id", "type": "uuid" }, { "name": "p_primary_domain", "type": "text" } ], "description": "Internal company context by company ID or domain.", "operationId": "get-company-context", "x-public-safe": true, "x-access-level": "internal", "x-cache-policy": "short" } }, "/rest/v1/rpc/get_report_overview": { "post": { "tags": [ "public_report" ], "summary": "Get Report Overview", "responses": { "200": { "content": { "application/json": { "schema": { "mode": "single", "type": "object" } } }, "description": "Successful response" } }, "parameters": [], "description": "Headline public report overview metrics.", "operationId": "get-report-overview", "x-public-safe": true, "x-access-level": "public", "x-cache-policy": "medium" } }, "/rest/v1/rpc/get_sponsor_targets": { "post": { "tags": [ "sponsor" ], "summary": "Get Sponsor Targets", "responses": { "200": { "content": { "application/json": { "schema": { "mode": "rows", "type": "array" } } }, "description": "Successful response" } }, "parameters": [ { "name": "p_sponsor_segment", "type": "text" }, { "name": "p_recommended_tier", "type": "text" }, { "name": "p_min_score", "type": "numeric", "default": 35 }, { "name": "p_limit", "type": "integer", "default": 100 } ], "description": "Sponsor target list for internal sponsorship workflow.", "operationId": "get-sponsor-targets", "x-public-safe": true, "x-access-level": "internal", "x-cache-policy": "short" } }, "/rest/v1/v_public_route_manifest": { "get": { "tags": [ "dashboard_contract" ], "summary": "Dashboard Route Manifest", "responses": { "200": { "content": { "application/json": { "schema": { "mode": "rows", "type": "array" } } }, "description": "Successful response" } }, "parameters": [], "description": "Public route manifest for static generation and sitemap.", "operationId": "dashboard-route-manifest", "x-public-safe": true, "x-access-level": "public", "x-cache-policy": "long" } }, "/rest/v1/v_period_claim_readiness": { "get": { "tags": [ "claims" ], "summary": "Public Period Claim Readiness", "responses": { "200": { "content": { "application/json": { "schema": { "mode": "rows", "type": "array" } } }, "description": "Successful response" } }, "parameters": [ { "name": "metric_id", "type": "eq" }, { "name": "segment_type", "type": "eq" }, { "name": "claim_readiness", "type": "eq" } ], "description": "2023 vs 2026 claim-readiness rows.", "operationId": "public-period-claim-readiness", "x-public-safe": true, "x-access-level": "public", "x-cache-policy": "medium" } }, "/rest/v1/v_psychometric_benchmarks": { "get": { "tags": [ "psychometrics" ], "summary": "Public Psychometric Benchmarks", "responses": { "200": { "content": { "application/json": { "schema": { "mode": "rows", "type": "array" } } }, "description": "Successful response" } }, "parameters": [ { "name": "dataset_period", "type": "eq" }, { "name": "dimension_id", "type": "eq" }, { "name": "industry_id", "type": "eq" }, { "name": "role_family_id", "type": "eq" } ], "description": "Psychometric benchmark rows.", "operationId": "public-psychometric-benchmarks", "x-public-safe": true, "x-access-level": "public", "x-cache-policy": "medium" } }, "/rest/v1/v_release_go_no_go_report": { "get": { "tags": [ "quality" ], "summary": "Release Go No Go", "responses": { "200": { "content": { "application/json": { "schema": { "mode": "rows", "type": "array" } } }, "description": "Successful response" } }, "parameters": [], "description": "Release readiness and blockers.", "operationId": "quality-release-go-no-go", "x-public-safe": true, "x-access-level": "internal", "x-cache-policy": "short" } }, "/rest/v1/rpc/get_score_distribution": { "post": { "tags": [ "charts" ], "summary": "Get Score Distribution", "responses": { "200": { "content": { "application/json": { "schema": { "mode": "array", "type": "jsonb" } } }, "description": "Successful response" } }, "parameters": [ { "name": "p_dataset_period", "type": "text", "default": "2026" }, { "name": "p_segment_type", "type": "text" } ], "description": "Score distribution chart data.", "operationId": "get-score-distribution", "x-public-safe": true, "x-access-level": "public", "x-cache-policy": "short" } }, "/rest/v1/v_report_methodology_stats": { "get": { "tags": [ "public_report" ], "summary": "Public Methodology Stats", "responses": { "200": { "content": { "application/json": { "schema": { "mode": "rows", "type": "array" } } }, "description": "Successful response" } }, "parameters": [ { "name": "select", "type": "text" } ], "description": "Public-safe methodology stats.", "operationId": "public-methodology-stats", "x-public-safe": true, "x-access-level": "public", "x-cache-policy": "medium" } }, "/rest/v1/rpc/get_industry_benchmarks": { "post": { "tags": [ "benchmarks" ], "summary": "Get Industry Benchmarks", "responses": { "200": { "content": { "application/json": { "schema": { "mode": "rows", "type": "array" } } }, "description": "Successful response" } }, "parameters": [ { "name": "p_dataset_period", "type": "text", "default": "2026" }, { "name": "p_min_jobs", "type": "integer", "default": 10 }, { "name": "p_industry_ids", "type": "text[]" } ], "description": "Industry benchmark rows for report and dashboard.", "operationId": "get-industry-benchmarks", "x-public-safe": true, "x-access-level": "public", "x-cache-policy": "medium" } }, "/rest/v1/v_abm_company_targets_export": { "get": { "tags": [ "internal_abm" ], "summary": "Internal ABM Targets Export", "responses": { "200": { "content": { "application/json": { "schema": { "mode": "rows", "type": "array" } } }, "description": "Successful response" } }, "parameters": [ { "name": "recommended_motion", "type": "eq" }, { "name": "limit", "type": "integer" }, { "name": "order", "type": "text" } ], "description": "Internal ABM target export.", "operationId": "internal-abm-targets-export", "x-public-safe": true, "x-access-level": "internal", "x-cache-policy": "medium" } }, "/rest/v1/rpc/get_sponsor_pitch_context": { "post": { "tags": [ "sponsor" ], "summary": "Get Sponsor Pitch Context", "responses": { "200": { "content": { "application/json": { "schema": { "mode": "object", "type": "jsonb" } } }, "description": "Successful response" } }, "parameters": [], "description": "Sponsor category and pitch context.", "operationId": "get-sponsor-pitch-context", "x-public-safe": true, "x-access-level": "internal", "x-cache-policy": "medium" } }, "/rest/v1/v_chart_overview_metric_cards": { "get": { "tags": [ "chart_view" ], "summary": "Chart Overview Metrics", "responses": { "200": { "content": { "application/json": { "schema": { "mode": "rows", "type": "array" } } }, "description": "Successful response" } }, "parameters": [], "description": "Overview metric-card export view.", "operationId": "chart-overview-metrics", "x-public-safe": true, "x-access-level": "public", "x-cache-policy": "medium" } }, "/rest/v1/rpc/get_role_family_benchmarks": { "post": { "tags": [ "benchmarks" ], "summary": "Get Role Family Benchmarks", "responses": { "200": { "content": { "application/json": { "schema": { "mode": "rows", "type": "array" } } }, "description": "Successful response" } }, "parameters": [ { "name": "p_dataset_period", "type": "text", "default": "2026" }, { "name": "p_min_jobs", "type": "integer", "default": 10 }, { "name": "p_role_family_ids", "type": "text[]" } ], "description": "Role family benchmark rows.", "operationId": "get-role-family-benchmarks", "x-public-safe": true, "x-access-level": "public", "x-cache-policy": "medium" } }, "/rest/v1/v_chart_vertical_score_heatmap": { "get": { "tags": [ "chart_view" ], "summary": "Chart Vertical Heatmap", "responses": { "200": { "content": { "application/json": { "schema": { "mode": "rows", "type": "array" } } }, "description": "Successful response" } }, "parameters": [ { "name": "dataset_period", "type": "eq" }, { "name": "limit", "type": "integer" } ], "description": "Vertical heatmap chart export view.", "operationId": "chart-vertical-heatmap", "x-public-safe": true, "x-access-level": "public", "x-cache-policy": "medium" } }, "/rest/v1/rpc/get_company_size_benchmarks": { "post": { "tags": [ "benchmarks" ], "summary": "Get Company Size Benchmarks", "responses": { "200": { "content": { "application/json": { "schema": { "mode": "rows", "type": "array" } } }, "description": "Successful response" } }, "parameters": [ { "name": "p_dataset_period", "type": "text", "default": "2026" }, { "name": "p_score_id", "type": "text" } ], "description": "Company-size benchmark rows.", "operationId": "get-company-size-benchmarks", "x-public-safe": true, "x-access-level": "public", "x-cache-policy": "medium" } }, "/rest/v1/v_company_outreach_context_export": { "get": { "tags": [ "internal_abm" ], "summary": "Internal Company Outreach Context", "responses": { "200": { "content": { "application/json": { "schema": { "mode": "rows", "type": "array" } } }, "description": "Successful response" } }, "parameters": [ { "name": "recommended_motion", "type": "eq" }, { "name": "abm_rank", "type": "lte" }, { "name": "limit", "type": "integer" } ], "description": "Internal company outreach context export.", "operationId": "internal-company-outreach-context", "x-public-safe": true, "x-access-level": "internal", "x-cache-policy": "medium" } }, "/rest/v1/v_sponsor_targets_redacted_export": { "get": { "tags": [ "sponsor" ], "summary": "Sponsor Safe Targets Export", "responses": { "200": { "content": { "application/json": { "schema": { "mode": "rows", "type": "array" } } }, "description": "Successful response" } }, "parameters": [ { "name": "recommended_sponsor_tier", "type": "eq" }, { "name": "sponsor_segment", "type": "eq" } ], "description": "Public-safe sponsor target export for review.", "operationId": "sponsor-safe-targets-export", "x-public-safe": true, "x-access-level": "internal", "x-cache-policy": "medium" } }, "/rest/v1/v_chart_psychometric_overall_radar": { "get": { "tags": [ "chart_view" ], "summary": "Chart Psychometric Radar", "responses": { "200": { "content": { "application/json": { "schema": { "mode": "rows", "type": "array" } } }, "description": "Successful response" } }, "parameters": [ { "name": "dataset_period", "type": "eq" } ], "description": "Psychometric radar chart export view.", "operationId": "chart-psychometric-radar", "x-public-safe": true, "x-access-level": "public", "x-cache-policy": "medium" } }, "/rest/v1/v_hack_the_box_pitch_context_export": { "get": { "tags": [ "sponsor" ], "summary": "Hack The Box Pitch Context", "responses": { "200": { "content": { "application/json": { "schema": { "mode": "rows", "type": "array" } } }, "description": "Successful response" } }, "parameters": [], "description": "Hack The Box-specific platinum sponsor pitch context.", "operationId": "hack-the-box-pitch-context", "x-public-safe": true, "x-access-level": "internal", "x-cache-policy": "medium" } }, "/rest/v1/v_chart_historical_score_shift_slope": { "get": { "tags": [ "chart_view" ], "summary": "Chart Historical Score Shift", "responses": { "200": { "content": { "application/json": { "schema": { "mode": "rows", "type": "array" } } }, "description": "Successful response" } }, "parameters": [ { "name": "metric_id", "type": "eq" }, { "name": "segment_type", "type": "eq" } ], "description": "Historical score shift chart export view.", "operationId": "chart-historical-score-shift", "x-public-safe": true, "x-access-level": "public", "x-cache-policy": "medium" } } }, "openapi": "3.1.0", "servers": [ { "url": "https://aisecurity.llc" }, { "url": "http://localhost:54321" } ] }