Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

AWS Security Hub Findings API

The Findings API from AWS Security Hub — 3 operation(s) for findings.

AWS Security Hub Findings API is one of 12 APIs that AWS Security Hub publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Findings. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 4 operations across 3 paths. It is described by OpenAPI 3.1.0, at version 2018-10-26.

Requests are made against a single base URL, https://securityhub.{region}.amazonaws.com.

4 operations 3 paths 0 schemas 1 PATCH3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
2018-10-26
Base URL
https://securityhub.us-east-1.amazonaws.com
Authentication
API Key
Resource Areas
1

Authentication & Security 1

AWS Security Hub Findings API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (SigV4). By default, every request must be authenticated.

  • SigV4 — AWS Signature Version 4 signed Authorization header

Paths & Operations 4

Across 3 paths, the API surfaces 4 operations — 1 PATCH, 3 POST. Each is listed below with its method, path, parameters, and response codes.

Findings 4
POST
/findings
Get findings
GetFindings body → 200
PATCH
/findings
Batch update findings
BatchUpdateFindings body → 200
POST
/findings/import
Batch import findings from a product
BatchImportFindings body → 200
POST
/findings/history
Get finding history
GetFindingHistory body → 200

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

aws-security-hub-findings-api-openapi.yml Raw ↑

Other APIs AWS Security Hub publishes across the network.

AWS Security Hub CSPM API
AWS Security Hub Action Targets API
AWS Security Hub Automation Rules API
AWS Security Hub Configuration Policies API
AWS Security Hub Controls API
AWS Security Hub Hub API
AWS Security Hub Insights API
AWS Security Hub Invitations API
AWS Security Hub Members API
AWS Security Hub Standards API
AWS Security Hub Tags API