{"openapi":"3.1.0","info":{"title":"Application & Pipeline Security Checks API","version":"1.0.0","description":"Secrets scanning (gitleaks rules), GitHub Actions and GitLab CI audits, CloudFormation and IAM/GCP binding analysis, JWT inspect, ReDoS check, injection sink scan, OpenAPI security audit, password policy vs NIST, SBOM from lockfiles, nginx/Apache config audits and OAuth client checks — on caller-supplied files only. Paid with x402 exact USDC on Base. No account is required.","contact":{"email":"support@brainiac.software"},"x-guidance":"BRAINIAC.software is a pay-per-call API for software agents. No account or API key is required.\nPayment uses x402 with exact USDC on Base (8453). Each paid resource accepts POST for the call; unpaid GET/HEAD return the same 402 payment challenge for discovery.\nHow to call an operation:\n1. POST JSON matching the requestBody. An unpaid POST (including empty body) returns 402 payment terms before body validation.\n2. Compare 402 payTo, asset, and network with /api/v1/catalog and /.well-known/x402 — not only with the 402 itself.\n3. Pay and retry with payment-signature. Invalid JSON/schema after payment-signature returns 400 and is not charged. Settlement (a charge) only on 2xx. payment-signature attached ≠ charged.\nIdempotency-Key: 64 hex chars from 32 random bytes. Reuse only for the same operation and body (replays stored response, including status=partial). A new key runs a fresh call.\nIdempotency after errors: unpaid 402 does not store the key. Post-signature 402/503 release it (retry same key). Pre-reserve schema 400 does not store it. Other post-signature responses (2xx/4xx/5xx) are stored: same key+body replays; different body → 409. Stored 4xx/5xx replays are not a second charge. Prefer a new key after fixing a 4xx; after 5xx reuse the same key only for the stored error.\nPost-signature 402/503 include prior-payment-attempt (nonce, settled false|unknown). A facilitator 502 is SETTLEMENT_UNKNOWN (stored under the Idempotency-Key; cross-instance replay needs the shared store; may already be charged) — check USDC authorizationState(payer, nonce) on Base before re-signing.\nSettlement signal: settled 2xx include payment-response. 4xx/5xx do not. Do not book a cost from payment-signature alone.\nCoverage billing: HTTP 200 with status complete, partial, or failed is charged at the full listed price. Retrying missing checks needs a new settled call. 4xx/5xx are not charged.\nmissing_items.reason: timeout/rate_limited → one delayed retry (new key); upstream_down → after recovery; not_supported → never.\nInvariants: any missing_items ⇒ not status complete; sources[] is provenance only (source, url, retrievedAt), never success/error keyed by check.\nFree lookup: GET /api/v1/results/{result_id} returns stored coverage JSON (404 RESULT_NOT_FOUND if unknown/expired; not a 402). Prior-Result-Id sets replaces_result_id.\nOutputs are prechecks/drafts for human review — not official determinations, legal advice, or certified filings."},"servers":[{"url":"https://www.brainiac.software"}],"paths":{"/api/v1/appsec-config/secrets-scan":{"post":{"operationId":"scan_files_for_secrets_with_gitleaks_rules","summary":"Scan files for secrets with gitleaks rules","description":"Find secrets in text or diffs using vendored gitleaks rules with redaction.","tags":["appsec-config"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"files":{"minItems":1,"maxItems":1000,"type":"array","items":{"type":"object","properties":{"path":{"type":"string","minLength":1,"maxLength":1024},"content":{"type":"string","maxLength":2000000}},"required":["path","content"],"additionalProperties":false}},"mode":{"default":"text","type":"string","enum":["text","diff"]},"allowlistPaths":{"default":[],"type":"array","items":{"type":"string"}},"includeLowEntropy":{"default":false,"type":"boolean"}},"required":["files"],"additionalProperties":false},"example":{"files":[{"path":"deploy.env","content":"# deploy config\nAWS_ID=AKIAZ7Q3XVJ5RK2MWN4T\nDOCS_SAMPLE=AKIAIOSFODNN7EXAMPLE\nexport GH=ghp_R8vK2mQ9xT4wL7pZ3nB6cY1dF5hJ0sA2eU4g\nSTRIPE=sk_test_aaaaaaaaaaaaaaaa\n"}],"mode":"text","allowlistPaths":[],"includeLowEntropy":false}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"findings":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string"},"severity":{"type":"string"},"path":{"type":"string"},"line":{"type":"number"},"column":{"type":"number"},"redacted":{"type":"string"},"entropy":{"type":"number"},"sha256":{"type":"string"}},"additionalProperties":true}},"suppressed":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string"},"path":{"type":"string"},"reason":{"type":"string"},"redacted":{"type":"string"}},"additionalProperties":true}},"rulesVersion":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"findings":[{"ruleId":"aws-access-token","severity":"high","path":"deploy.env","line":2,"column":8,"redacted":"AKIA…4T","entropy":4.1219,"sha256":"3f961ca1ee76c2940a93ecef02071abba31e33959fb1273033680f7fa712648e"},{"ruleId":"github-pat","severity":"high","path":"deploy.env","line":4,"column":11,"redacted":"ghp_…4g","entropy":5.0719,"sha256":"003b6e5548ef9b12dbcd28505d8a42a68a8dadfef406827ed169f05277f4be51"}],"suppressed":[{"ruleId":"aws-access-token","path":"deploy.env","reason":"allowlist","redacted":"AKIA…LE"}],"rulesVersion":"gitleaks.toml@5f6ec56cfa6f8c67648d863582c7ae2f206d5c1c","sources":[{"source":"Caller-supplied files or snippets processed locally","url":"https://www.brainiac.software/api/v1/appsec-config","retrievedAt":"2026-11-14","status":"ok"},{"source":"gitleaks default rules (MIT)","url":"https://github.com/gitleaks/gitleaks","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…","Nothing is cloned, fetched or executed at request time."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/appsec-config/github-actions-audit":{"post":{"operationId":"audit_github_actions_workflows","summary":"Audit GitHub Actions workflows","description":"Find injection, pinning, permission and pull_request_target risks.","tags":["appsec-config"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"files":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"content":{"type":"string","maxLength":2000000}},"required":["path","content"],"additionalProperties":false}}},"required":["files"],"additionalProperties":false},"example":{"files":[{"path":".github/workflows/pr.yml","content":"on: pull_request_target\npermissions: write-all\njobs:\n  build:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v4\n        with:\n          ref: ${{ github.event.pull_request.head.sha }}\n      - uses: some-org/lint-action@main\n      - run: echo \"${{ github.event.pull_request.title }}\"\n      - run: echo ${{ secrets.NPM_TOKEN }}\n"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"findings":{"type":"array","items":{"type":["object","string"],"properties":{"ruleId":{"type":"string"},"severity":{"type":"string"},"path":{"type":"string"},"line":{"type":"number"},"column":{"type":"number"},"message":{"type":"string"},"reference":{"type":"string"}},"additionalProperties":true}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"findings":[{"ruleId":"GHA004-permissions-write-all","severity":"high","path":".github/workflows/pr.yml","line":2,"column":1,"message":"permissions: write-all","reference":"https://docs.github.com/en/actions/security-guides/security-hardening-for-github-actions"},{"ruleId":"GHA003-unpinned-action","severity":"low","path":".github/workflows/pr.yml","line":7,"column":1,"message":"actions/checkout@v4 (first-party) is pinned to a tag, not a commit SHA","reference":"GitHub Docs"},"…"],"sources":[{"source":"Caller-supplied files or snippets processed locally","url":"https://www.brainiac.software/api/v1/appsec-config","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…","Nothing is cloned, fetched or executed at request time."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/appsec-config/gitlab-ci-audit":{"post":{"operationId":"audit_gitlab_ci_configuration","summary":"Audit GitLab CI configuration","description":"Flag unpinned images, remote includes, secrets and dind risks.","tags":["appsec-config"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"content":{"type":"string","maxLength":2000000},"requireDigest":{"default":false,"type":"boolean"}},"required":["content"],"additionalProperties":false},"example":{"content":"image: node:latest\ninclude:\n  - remote: 'https://example.com/ci.yml'\nvariables:\n  DEPLOY_TOKEN: \"glpat-AbCdEfGhIjKlMnOpQrSt\"\nbuild:\n  services:\n    - docker:dind\n  script:\n    - echo $CI_COMMIT_MESSAGE | sh\n  artifacts:\n    paths: [\".env\"]\n"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"findings":{"type":"array","items":{"type":["object","string"],"properties":{"ruleId":{"type":"string"},"severity":{"type":"string"},"line":{"type":"number"},"column":{"type":"number"},"path":{"type":"string"},"message":{"type":"string"},"reference":{"type":"string"}},"additionalProperties":true}},"unresolvedIncludes":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"findings":[{"ruleId":"GLC001-image-unpinned","severity":"medium","line":1,"column":1,"path":".gitlab-ci.yml","message":"image","reference":"GitLab CI"},{"ruleId":"GLC002-remote-include","severity":"high","line":3,"column":1,"path":".gitlab-ci.yml","message":"include: remote","reference":"GitLab CI"},"…"],"unresolvedIncludes":["https://example.com/ci.yml"],"sources":[{"source":"Caller-supplied files or snippets processed locally","url":"https://www.brainiac.software/api/v1/appsec-config","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…","Nothing is cloned, fetched or executed at request time."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/appsec-config/cloudformation-audit":{"post":{"operationId":"audit_cloudformation_templates","summary":"Audit CloudFormation templates","description":"Flag public storage, open security groups, missing encryption and wildcard IAM.","tags":["appsec-config"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"template":{"type":"string","maxLength":5000000}},"required":["template"],"additionalProperties":false},"example":{"template":"AWSTemplateFormatVersion: '2010-09-09'\nParameters:\n  Open:\n    Type: String\n    Default: 0.0.0.0/0\nResources:\n  Bucket:\n    Type: AWS::S3::Bucket\n    Properties:\n      AccessControl: PublicRead\n  SG:\n    Type: AWS::EC2::SecurityGroup\n    Properties:\n      GroupDescription: x\n      SecurityGroupIngress:\n        - IpProtocol: tcp\n          FromPort: 22\n          ToPort: 22\n          CidrIp: 0.0.0.0/0\n  DB:\n    Type: AWS::RDS::DBInstance\n    Properties:\n      Engine: mysql\n  Policy:\n    Type: AWS::IAM::ManagedPolicy\n    Properties:\n      PolicyDocument:\n        Statement:\n          - Effect: Allow\n            Action: '*'\n            Resource: '*'\n"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"findings":{"type":"array","items":{"type":["object","string"],"properties":{"ruleId":{"type":"string"},"resource":{"type":"string"},"severity":{"type":"string"},"path":{"type":"string"},"line":{"type":"number"},"column":{"type":"number"},"message":{"type":"string"},"reference":{"type":"string"},"conditional":{"type":"boolean"}},"additionalProperties":true}},"unresolved":{"type":"array","items":{}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"findings":[{"ruleId":"CFN001-s3-public-acl","resource":"Bucket","severity":"high","path":"Bucket","line":1,"column":1,"message":"Public ACL","reference":"AWS S3","conditional":false},{"ruleId":"CFN002-s3-no-public-access-block","resource":"Bucket","severity":"medium","path":"Bucket","line":1,"column":1,"message":"missing public access block","reference":"AWS S3","conditional":false},"…"],"unresolved":[],"sources":[{"source":"Caller-supplied files or snippets processed locally","url":"https://www.brainiac.software/api/v1/appsec-config","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…","Nothing is cloned, fetched or executed at request time."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/appsec-config/aws-iam-policy-analyze":{"post":{"operationId":"analyse_aws_iam_policy_documents","summary":"Analyse AWS IAM policy documents","description":"Find wildcards, NotAction pitfalls, privilege-escalation actions and public principals.","tags":["appsec-config"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"policy":{"anyOf":[{"type":"string"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}]},"policyType":{"default":"identity","type":"string","enum":["identity","resource","trust"]}},"required":["policy"],"additionalProperties":false},"example":{"policy":{"Version":"2012-10-17","Statement":[{"Effect":"Allow","Action":["iam:PassRole","ec2:RunInstances"],"Resource":"*"},{"Effect":"Allow","NotAction":"iam:*","Resource":"*"},{"Effect":"Allow","Principal":"*","Action":"s3:GetObject","Resource":"arn:aws:s3:::my-bucket/*"},{"Effect":"Allow","Action":"iam:CreatePolicyVersion","Resource":"*"}]},"policyType":"resource"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"findings":{"type":"array","items":{"type":["object","string"],"properties":{"ruleId":{"type":"string"},"statement":{"type":"number"},"severity":{"type":"string"},"detail":{"type":"string"},"reference":{"type":"string"}},"additionalProperties":true}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"findings":[{"ruleId":"IAM-NOTACTION-ALLOW","statement":1,"severity":"high","detail":"Allow + NotAction grants every action outside iam:* on all resources","reference":"AWS IAM"},{"ruleId":"IAM-PUBLIC-PRINCIPAL","statement":2,"severity":"high","reference":"AWS IAM"},"…"],"sources":[{"source":"Caller-supplied files or snippets processed locally","url":"https://www.brainiac.software/api/v1/appsec-config","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…","Nothing is cloned, fetched or executed at request time."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/appsec-config/gcp-iam-binding-analyze":{"post":{"operationId":"analyse_gcp_iam_policy_bindings","summary":"Analyse GCP IAM policy bindings","description":"Flag basic roles, public members and service-account impersonation.","tags":["appsec-config"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"policy":{"type":"object","properties":{"bindings":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"required":["bindings"],"additionalProperties":false},"serviceAccountPolicies":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["policy"],"additionalProperties":false},"example":{"policy":{"bindings":[{"role":"roles/editor","members":["user:dev@example.com"]},{"role":"roles/storage.objectViewer","members":["allUsers"]},{"role":"roles/iam.serviceAccountTokenCreator","members":["user:ci@example.com"]},{"role":"roles/owner","members":["serviceAccount:app@p.iam.gserviceaccount.com"],"condition":{"title":"temp","expression":"request.time < timestamp('2026-12-01T00:00:00Z')"}}]}}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"findings":{"type":"array","items":{"type":["object","string"],"properties":{"ruleId":{"type":"string"},"role":{"type":"string"},"members":{"type":"array","items":{"type":"string"}},"severity":{"type":"string"},"reference":{"type":"string"}},"additionalProperties":true}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"findings":[{"ruleId":"GCP-BASIC-ROLE","role":"roles/editor","members":["user:dev@example.com"],"severity":"high","reference":"Google Cloud IAM"},{"ruleId":"GCP-PUBLIC-MEMBER","role":"roles/storage.objectViewer","members":["allUsers"],"severity":"high","reference":"Google Cloud IAM"},"…"],"sources":[{"source":"Caller-supplied files or snippets processed locally","url":"https://www.brainiac.software/api/v1/appsec-config","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…","Nothing is cloned, fetched or executed at request time."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/appsec-config/jwt-inspect":{"post":{"operationId":"inspect_jwts_for_weak_crypto_and_claims","summary":"Inspect JWTs for weak crypto and claims","description":"Decode JWTs, flag alg:none, weak HMAC secrets and lifetime issues.","tags":["appsec-config"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"token":{"type":"string","minLength":10,"maxLength":16384},"now":{"type":"string"},"maxLifetimeSeconds":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"expectedAudience":{"type":["string","null"]},"publicKeyPem":{"type":"string"}},"required":["token"],"additionalProperties":false},"example":{"token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c2VyLTEyMyIsImlhdCI6MTc2NzIyNTYwMCwiZXhwIjoxNzY3MzEyMDAwfQ.AbHqNHstAu3Ejvjp6sSIjN_Q96ehum-riC8M7eO98a4","now":"2026-01-01T12:00:00Z","maxLifetimeSeconds":3600,"expectedAudience":null}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"header":{"type":"object","properties":{"alg":{"type":"string"},"typ":{"type":"string"}},"additionalProperties":true},"payload":{"type":"object","properties":{"sub":{"type":"string"},"iat":{"type":"number"},"exp":{"type":"number"}},"additionalProperties":true},"findings":{"type":"array","items":{"type":["object","string"],"properties":{"ruleId":{"type":"string"},"severity":{"type":"string"},"message":{"type":"string"},"secretHint":{"type":"string"},"listLine":{"type":"number"},"reference":{"type":"string"}},"additionalProperties":true}},"expired":{"type":"boolean"},"notYetValid":{"type":"boolean"},"signatureChecked":{"type":"boolean"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"header":{"alg":"HS256","typ":"JWT"},"payload":{"sub":"user-123","iat":1767225600,"exp":1767312000},"findings":[{"ruleId":"JWT-WEAK-SECRET","severity":"critical","message":"HS256 signature verifies with a known public secret","secretHint":"se…et","listLine":40,"reference":"SecLists"},{"ruleId":"JWT-NO-AUD","severity":"low"},"…"],"expired":false,"notYetValid":false,"signatureChecked":true,"sources":[{"source":"Caller-supplied files or snippets processed locally","url":"https://www.brainiac.software/api/v1/appsec-config","retrievedAt":"2026-11-14","status":"ok"},{"source":"SecLists scraped-JWT-secrets.txt (MIT)","url":"https://github.com/danielmiessler/SecLists","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…","Nothing is cloned, fetched or executed at request time."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/appsec-config/regex-redos-check":{"post":{"operationId":"detect_redos_risk_in_a_regular_expression","summary":"Detect ReDoS risk in a regular expression","description":"Check a JavaScript regex for catastrophic backtracking with recheck.","tags":["appsec-config"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"pattern":{"type":"string","maxLength":2000},"flags":{"default":"","type":"string","maxLength":16},"flavour":{"default":"javascript","type":"string","enum":["javascript"]}},"required":["pattern"],"additionalProperties":false},"example":{"pattern":"^(a+)+$","flags":"","flavour":"javascript"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"},"complexity":{"type":"object","properties":{"type":{"type":"string"},"summary":{"type":"string"},"isFuzz":{"type":"boolean"}},"additionalProperties":true},"attack":{"type":"object","properties":{"pumps":{"type":"array","items":{"type":"object","properties":{"prefix":{"type":"string"},"pump":{"type":"string"},"bias":{"type":"number"}},"additionalProperties":true}},"suffix":{"type":"string"},"base":{"type":"number"},"string":{"type":"string"},"pattern":{"type":"string"}},"additionalProperties":true},"checker":{"type":"string"},"engine":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"status":"vulnerable","complexity":{"type":"exponential","summary":"exponential","isFuzz":false},"attack":{"pumps":[{"prefix":"a","pump":"a","bias":0}],"suffix":"\u0000","base":31,"string":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\u0000","pattern":"'a' + 'a'.repeat(31) + '\\x00'"},"checker":"automaton","engine":"recheck 4.6.2","sources":[{"source":"Caller-supplied files or snippets processed locally","url":"https://www.brainiac.software/api/v1/appsec-config","retrievedAt":"2026-11-14","status":"ok"},{"source":"recheck (MIT)","url":"https://github.com/MakeNowJust/recheck","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…","Nothing is cloned, fetched or executed at request time."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/appsec-config/injection-sink-scan":{"post":{"operationId":"scan_a_file_for_injection_sinks","summary":"Scan a file for injection sinks","description":"Lightweight single-file taint scan for SQL, command and XSS sinks.","tags":["appsec-config"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"language":{"type":"string","enum":["javascript","typescript","python"]},"path":{"default":"input","type":"string"},"content":{"type":"string","maxLength":500000}},"required":["language","content"],"additionalProperties":false},"example":{"language":"javascript","path":"routes/user.js","content":"app.get('/u', (req, res) => {\n  const id = req.query.id;\n  db.query(\"SELECT * FROM users WHERE id = \" + id);\n  db.query('SELECT * FROM users WHERE id = ?', [id]);\n  exec(`ping ${req.body.host}`);\n  res.send('<p>' + req.query.name + '</p>');\n});\n"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"findings":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string"},"line":{"type":"number"},"severity":{"type":"string"},"source":{"type":"string"},"sink":{"type":"string"},"path":{"type":"string"},"column":{"type":"number"},"message":{"type":"string"},"reference":{"type":"string"}},"additionalProperties":true}},"scope":{"type":"string"},"caveat":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"findings":[{"ruleId":"INJ-CMD","line":5,"severity":"critical","source":"req.body","sink":"exec","path":"routes/user.js","column":1,"message":"command injection","reference":"CWE-78"},{"ruleId":"INJ-XSS-RESPONSE","line":6,"severity":"medium","source":"req.query","sink":"res.send","path":"routes/user.js","column":1,"message":"xss","reference":"CWE-79"}],"scope":"single_file","caveat":"pattern-based; false positives and negatives expected","sources":[{"source":"Caller-supplied files or snippets processed locally","url":"https://www.brainiac.software/api/v1/appsec-config","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…","Nothing is cloned, fetched or executed at request time."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/appsec-config/openapi-security-audit":{"post":{"operationId":"audit_openapi_3_x_security_design","summary":"Audit OpenAPI 3.x security design","description":"OWASP API Top 10 style checks on an OpenAPI document.","tags":["appsec-config"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"spec":{"type":"string","maxLength":5000000}},"required":["spec"],"additionalProperties":false},"example":{"spec":"openapi: 3.0.3\ninfo: { title: t, version: '1' }\nservers: [{ url: 'http://api.example.com' }]\npaths:\n  /users/{id}:\n    get:\n      parameters:\n        - { name: id, in: path, required: true, schema: { type: integer } }\n        - { name: api_key, in: query, schema: { type: string } }\n      responses: { '200': { description: ok } }\n  /users:\n    get:\n      security: [{ bearer: [] }]\n      responses:\n        '200':\n          description: ok\n          content:\n            application/json:\n              schema: { type: array, items: { type: string } }\ncomponents:\n  securitySchemes:\n    bearer: { type: http, scheme: bearer }\n"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"findings":{"type":"array","items":{"type":["object","string"],"properties":{"ruleId":{"type":"string"},"owasp":{"type":"string"},"path":{"type":"string"},"method":{"type":"string"},"severity":{"type":"string"},"message":{"type":"string"},"reference":{"type":"string"}},"additionalProperties":true}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"findings":[{"ruleId":"OAS-NO-429","owasp":"API4:2023","path":"/users","method":"get","severity":"low","message":"no 429","reference":"OWASP API4:2023"},{"ruleId":"OAS-NO-PAGINATION","owasp":"API4:2023","path":"/users","method":"get","severity":"low","message":"no pagination","reference":"OWASP API4:2023"},"…"],"sources":[{"source":"Caller-supplied files or snippets processed locally","url":"https://www.brainiac.software/api/v1/appsec-config","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…","Nothing is cloned, fetched or executed at request time."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/appsec-config/password-policy-evaluate":{"post":{"operationId":"evaluate_a_password_policy_vs_nist","summary":"Evaluate a password policy vs NIST","description":"Check policy fields and optional samples against NIST SP 800-63B-4.","tags":["appsec-config"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"policy":{"type":"object","properties":{"minLength":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"maxLength":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"usedAsSingleFactor":{"type":"boolean"},"compositionRules":{"type":"array","items":{"type":"string"}},"periodicExpiryDays":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"blocklistCheck":{"type":"boolean"},"allowsUnicode":{"type":"boolean"},"allowsSpace":{"type":"boolean"},"hintsAllowed":{"type":"boolean"},"securityQuestions":{"type":"boolean"}},"additionalProperties":false},"samples":{"default":[],"maxItems":100,"type":"array","items":{"type":"string","maxLength":256}}},"required":["policy"],"additionalProperties":false},"example":{"policy":{"minLength":8,"maxLength":32,"usedAsSingleFactor":true,"compositionRules":["uppercase","digit","symbol"],"periodicExpiryDays":90,"blocklistCheck":false,"allowsUnicode":false,"allowsSpace":false,"hintsAllowed":false,"securityQuestions":true},"samples":["Password1!","correct horse battery staple"]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"findings":{"type":"array","items":{"type":["object","string"],"properties":{"ruleId":{"type":"string"},"requirement":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"samples":{"type":"array","items":{"type":"object","properties":{"index":{"type":"number"},"length":{"type":"number"},"inBlocklist":{"type":"boolean"},"meetsPolicyLength":{"type":"boolean"}},"additionalProperties":true}},"source":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"findings":[{"ruleId":"NIST-MINLEN-SINGLE","requirement":"SHALL","detail":"single-factor passwords must be at least 15 characters; policy allows 8"},{"ruleId":"NIST-MAXLEN","requirement":"SHOULD","detail":"permit at least 64 characters; policy max 32"},"…"],"samples":[{"index":0,"length":10,"inBlocklist":true,"meetsPolicyLength":true},{"index":1,"length":28,"inBlocklist":false,"meetsPolicyLength":true}],"source":"NIST SP 800-63B-4 §3.1.1.2 (final, 2025)","sources":[{"source":"Caller-supplied files or snippets processed locally","url":"https://www.brainiac.software/api/v1/appsec-config","retrievedAt":"2026-11-14","status":"ok"},{"source":"NIST SP 800-63B-4","url":"https://pages.nist.gov/800-63-4/sp800-63b.html","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…","Nothing is cloned, fetched or executed at request time."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/appsec-config/sbom-generate":{"post":{"operationId":"generate_an_sbom_from_a_lockfile","summary":"Generate an SBOM from a lockfile","description":"Build CycloneDX or SPDX SBOMs from npm/PyPI/Go/Cargo lockfiles.","tags":["appsec-config"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"lockfile":{"type":"object","properties":{"type":{"type":"string","enum":["package-lock","pnpm-lock","yarn-lock","requirements","poetry-lock","go-mod","cargo-lock"]},"content":{"type":"string","maxLength":10000000}},"required":["type","content"],"additionalProperties":false},"format":{"default":"cyclonedx-1.6-json","type":"string","enum":["cyclonedx-1.6-json","spdx-2.3-json"]}},"required":["lockfile"],"additionalProperties":false},"example":{"lockfile":{"type":"package-lock","content":"{\"name\":\"app\",\"version\":\"1.0.0\",\"lockfileVersion\":3,\"packages\":{\"\":{\"name\":\"app\",\"version\":\"1.0.0\",\"dependencies\":{\"@babel/core\":\"^7.24.0\"}},\"node_modules/@babel/core\":{\"version\":\"7.24.0\",\"resolved\":\"https://registry.npmjs.org/@babel/core/-/core-7.24.0.tgz\",\"license\":\"MIT\"}}}"},"format":"cyclonedx-1.6-json"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"bomFormat":{"type":"string"},"specVersion":{"type":"string"},"serialNumber":{"type":"string"},"metadata":{"type":"object","properties":{"timestamp":{"type":"string"},"component":{"type":"object","properties":{"type":{"type":"string"},"name":{"type":"string"},"version":{"type":"string"}},"additionalProperties":true}},"additionalProperties":true},"components":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"bom-ref":{"type":"string"},"name":{"type":"string"},"group":{"type":"string"},"version":{"type":"string"},"purl":{"type":"string"},"licenses":{"type":"array","items":{"type":"object","properties":{"license":{"type":"object","properties":{"id":{"type":"string"}},"additionalProperties":true}},"additionalProperties":true}}},"additionalProperties":true}},"dependencies":{"type":"array","items":{"type":"object","properties":{"ref":{"type":"string"},"dependsOn":{"type":"array","items":{"type":"string"}}},"additionalProperties":true}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"bomFormat":"CycloneDX","specVersion":"1.6","serialNumber":"urn:uuid:3042101c-6347-fadd-ba0d-bbe9bb093365","metadata":{"timestamp":"2026-11-15T00:38:45.863Z","component":{"type":"application","name":"app","version":"1.0.0"}},"components":[{"type":"library","bom-ref":"pkg:npm/%40babel/core@7.24.0","name":"core","group":"@babel","version":"7.24.0","purl":"pkg:npm/%40babel/core@7.24.0","licenses":[{"license":{"id":"MIT"}}]}],"dependencies":[{"ref":"app","dependsOn":["pkg:npm/%40babel/core@7.24.0"]}],"sources":[{"source":"Caller-supplied files or snippets processed locally","url":"https://www.brainiac.software/api/v1/appsec-config","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…","Nothing is cloned, fetched or executed at request time."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/appsec-config/nginx-config-audit":{"post":{"operationId":"audit_nginx_configuration","summary":"Audit nginx configuration","description":"Find weak TLS, alias traversal, open proxy and missing headers.","tags":["appsec-config"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"content":{"type":"string","maxLength":2000000}},"required":["content"],"additionalProperties":false},"example":{"content":"server {\n  listen 443 ssl;\n  ssl_protocols TLSv1 TLSv1.2;\n  location /static {\n    alias /var/www/static/;\n  }\n  location /proxy/ {\n    resolver 8.8.8.8;\n    proxy_pass http://$arg_host;\n  }\n}\n"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"findings":{"type":"array","items":{"type":["object","string"],"properties":{"ruleId":{"type":"string"},"line":{"type":"number"},"severity":{"type":"string"},"detail":{"type":"string"},"path":{"type":"string"},"column":{"type":"number"},"message":{"type":"string"},"reference":{"type":"string"}},"additionalProperties":true}},"unresolvedIncludes":{"type":"array","items":{}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"findings":[{"ruleId":"NGX-MISSING-HEADER","line":1,"severity":"low","detail":"X-Content-Type-Options","path":"nginx.conf","column":1,"message":"missing header","reference":"OWASP"},{"ruleId":"NGX-MISSING-HEADER","line":1,"severity":"low","detail":"Content-Security-Policy","path":"nginx.conf","column":1,"message":"missing header","reference":"OWASP"},"…"],"unresolvedIncludes":[],"sources":[{"source":"Caller-supplied files or snippets processed locally","url":"https://www.brainiac.software/api/v1/appsec-config","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…","Nothing is cloned, fetched or executed at request time."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/appsec-config/apache-config-audit":{"post":{"operationId":"audit_apache_httpd_configuration","summary":"Audit Apache httpd configuration","description":"Find weak TLS, directory listing, TRACE and missing hardening.","tags":["appsec-config"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"content":{"type":"string","maxLength":2000000},"kind":{"default":"httpd.conf","type":"string","enum":["httpd.conf","htaccess"]}},"required":["content"],"additionalProperties":false},"example":{"content":"ServerSignature On\nServerTokens Full\n<Directory /var/www/html>\n  Options Indexes FollowSymLinks\n</Directory>\nSSLProtocol all -SSLv3\nTraceEnable On\n","kind":"httpd.conf"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"findings":{"type":"array","items":{"type":["object","string"],"properties":{"ruleId":{"type":"string"},"line":{"type":"number"},"severity":{"type":"string"},"path":{"type":"string"},"column":{"type":"number"},"message":{"type":"string"},"reference":{"type":"string"}},"additionalProperties":true}},"unknownDirectives":{"type":"array","items":{}},"notes":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"findings":[{"ruleId":"APA-SERVER-SIGNATURE","line":1,"severity":"low","path":"httpd.conf","column":1,"message":"ServerSignature On","reference":"Apache docs"},{"ruleId":"APA-SERVER-TOKENS","line":2,"severity":"low","path":"httpd.conf","column":1,"message":"ServerTokens Full","reference":"Apache docs"},"…"],"unknownDirectives":[],"notes":["OpenSSL build or security level may still refuse TLS 1.0/1.1 at runtime."],"sources":[{"source":"Caller-supplied files or snippets processed locally","url":"https://www.brainiac.software/api/v1/appsec-config","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…","Nothing is cloned, fetched or executed at request time."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/appsec-config/oauth-client-audit":{"post":{"operationId":"audit_oauth_oidc_client_registration","summary":"Audit OAuth/OIDC client registration","description":"Check client settings against RFC 9700 security BCP.","tags":["appsec-config"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"client":{"type":"object","properties":{"clientType":{"type":"string","enum":["public","confidential"]},"grantTypes":{"default":[],"type":"array","items":{"type":"string"}},"responseTypes":{"default":[],"type":"array","items":{"type":"string"}},"redirectUris":{"default":[],"type":"array","items":{"type":"string"}},"pkceRequired":{"type":"boolean"},"pkceMethods":{"type":"array","items":{"type":"string"}},"refreshTokenRotation":{"type":"boolean"},"senderConstrainedRefreshTokens":{"type":"boolean"},"accessTokenLifetimeSeconds":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"scopes":{"type":"array","items":{"type":"string"}}},"required":["clientType"],"additionalProperties":false},"maxAccessTokenLifetimeSeconds":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"broadScopes":{"type":"array","items":{"type":"string"}}},"required":["client"],"additionalProperties":false},"example":{"client":{"clientType":"public","grantTypes":["implicit","authorization_code","password","refresh_token"],"responseTypes":["token","code"],"redirectUris":["https://app.example.com/*","http://app.example.com/cb","http://127.0.0.1:8080/cb"],"pkceRequired":false,"pkceMethods":["plain"],"refreshTokenRotation":false,"senderConstrainedRefreshTokens":false,"accessTokenLifetimeSeconds":86400,"scopes":["openid","admin"]},"maxAccessTokenLifetimeSeconds":3600,"broadScopes":["admin","*"]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"findings":{"type":"array","items":{"type":["object","string"],"properties":{"ruleId":{"type":"string"},"severity":{"type":"string"},"reference":{"type":"string"}},"additionalProperties":true}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"findings":[{"ruleId":"OAUTH-IMPLICIT","severity":"high","reference":"RFC 9700 §2.1.2 (SHOULD NOT)"},{"ruleId":"OAUTH-ROPC","severity":"critical","reference":"RFC 9700 §2.4 (MUST NOT)"},"…"],"sources":[{"source":"Caller-supplied files or snippets processed locally","url":"https://www.brainiac.software/api/v1/appsec-config","retrievedAt":"2026-11-14","status":"ok"},{"source":"RFC 9700 OAuth 2.0 Security BCP","url":"https://www.rfc-editor.org/rfc/rfc9700.html","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…","Nothing is cloned, fetched or executed at request time."]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}}},"components":{"schemas":{"ApiError":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}