find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/aws-security-hub:aws-security-hub-action-targets-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Aws Security Hub Action Targets API
  version: '2018-10-26'
  description: 'Operations tagged Action Targets across 2 of this provider''s published API definitions: aws-security-hub-openapi.yml, aws-security-hub-action-targets-api-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://securityhub.{region}.amazonaws.com
  description: AWS Security Hub regional endpoint
  variables:
    region:
      default: us-east-1
tags:
- name: Action Targets
paths:
  /actionTargets:
    post:
      tags:
      - Action Targets
      operationId: CreateActionTarget
      summary: Create an action target
      requestBody:
        $ref: '#/components/requestBodies/JsonBody'
      responses:
        '200':
          $ref: '#/components/responses/OK'
      security:
      - SigV4: []
    get:
      tags:
      - Action Targets
      operationId: DescribeActionTargets
      summary: Describe action targets
      responses:
        '200':
          $ref: '#/components/responses/OK'
      security:
      - SigV4: []
    servers:
    - url: https://securityhub.{region}.amazonaws.com
      description: AWS Security Hub regional endpoint
      variables:
        region:
          default: us-east-1
  /actionTargets/{ActionTargetArn+}:
    delete:
      operationId: DeleteActionTarget
      summary: Delete Action Target
      description: Deletes a custom action target from Security Hub CSPM. Deleting a custom action target does not affect any findings or insights that were already sent to Amazon CloudWatch Events using the custom action.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteActionTargetResponse'
              example:
                ActionTargetArn: arn:aws:securityhub:us-west-1:123456789012:action/custom/Remediation
        '500':
          description: InternalException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalException'
        '401':
          description: InvalidAccessException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InvalidAccessException'
        '400':
          description: InvalidInputException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InvalidInputException'
        '404':
          description: ResourceNotFoundException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceNotFoundException'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeleteActionTargetRequest'
            example:
              ActionTargetArn: arn:aws:securityhub:us-west-1:123456789012:action/custom/Remediation
      tags:
      - Action Targets
      security:
      - sigv4: []
    patch:
      operationId: UpdateActionTarget
      summary: Update Action Target
      description: Updates the name and description of a custom action target in Security Hub CSPM.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateActionTargetResponse'
        '500':
          description: InternalException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalException'
        '401':
          description: InvalidAccessException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InvalidAccessException'
        '400':
          description: InvalidInputException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InvalidInputException'
        '404':
          description: ResourceNotFoundException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceNotFoundException'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateActionTargetRequest'
            example:
              ActionTargetArn: arn:aws:securityhub:us-west-1:123456789012:action/custom/Remediation
              Name: Chat custom action
              Description: Sends specified findings to customer service chat
      tags:
      - Action Targets
      security:
      - sigv4: []
    servers:
    - url: https://securityhub.{region}.amazonaws.com
      variables:
        region:
          default: us-east-1
  /actionTargets/get:
    post:
      operationId: postActionTargetsGet
      summary: Describe Action Targets
      description: Returns a list of the custom action targets in Security Hub CSPM in your account.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DescribeActionTargetsResponse'
              example:
                ActionTargets:
                - ActionTargetArn: arn:aws:securityhub:us-west-1:123456789012:action/custom/Remediation
                  Description: Action to send the finding for remediation tracking
                  Name: Send to remediation
        '500':
          description: InternalException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalException'
        '401':
          description: InvalidAccessException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InvalidAccessException'
        '400':
          description: InvalidInputException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InvalidInputException'
        '404':
          description: ResourceNotFoundException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceNotFoundException'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DescribeActionTargetsRequest'
            example:
              ActionTargetArns:
              - arn:aws:securityhub:us-west-1:123456789012:action/custom/Remediation
      tags:
      - Action Targets
      security:
      - sigv4: []
      x-operation-id-source: normalized
      x-operation-id-original: DescribeActionTargets
    servers:
    - url: https://securityhub.{region}.amazonaws.com
      variables:
        region:
          default: us-east-1
components:
  responses:
    OK:
      description: Successful response
      content:
        application/json:
          schema:
            type: object
            additionalProperties: true
  requestBodies:
    JsonBody:
      required: true
      content:
        application/json:
          schema:
            type: object
            additionalProperties: true
  schemas:
    DeleteActionTargetResponse:
      type: object
      properties:
        ActionTargetArn:
          type: string
          description: The ARN of the custom action target that was deleted.
      required:
      - ActionTargetArn
    InvalidInputException:
      type: object
      properties:
        Message:
          type: string
        Code:
          type: string
    UpdateActionTargetResponse:
      type: object
      properties: {}
    DescribeActionTargetsResponse:
      type: object
      properties:
        ActionTargets:
          type: array
          items:
            $ref: '#/components/schemas/ActionTarget'
          description: A list of ActionTarget objects. Each object includes the ActionTargetArn, Description, and Name of a custom action target available in Security Hub CSPM.
        NextToken:
          type: string
          description: The pagination token to use to request the next page of results.
      required:
      - ActionTargets
    ResourceNotFoundException:
      type: object
      properties:
        Message:
          type: string
        Code:
          type: string
    UpdateActionTargetRequest:
      type: object
      properties:
        ActionTargetArn:
          type: string
          description: The ARN of the custom action target to update.
        Name:
          type: string
          description: The updated name of the custom action target.
        Description:
          type: string
          description: The updated description for the custom action target.
      required:
      - ActionTargetArn
    InternalException:
      type: object
      properties:
        Message:
          type: string
        Code:
          type: string
    ActionTarget:
      type: object
      properties:
        ActionTargetArn:
          type: string
          description: The ARN for the target action.
        Name:
          type: string
          description: The name of the action target.
        Description:
          type: string
          description: The description of the target action.
      required:
      - ActionTargetArn
      - Name
      - Description
    DescribeActionTargetsRequest:
      type: object
      properties:
        ActionTargetArns:
          type: array
          items:
            type: string
          description: A list of custom action target ARNs for the custom action targets to retrieve.
        NextToken:
          type: string
          description: The token that is required for pagination. On your first call to the DescribeActionTargets operation, set the value of this parameter to NULL. For subsequent calls to the operation, to continue listing data, set the value of this parameter to the value returned from the previous response.
        MaxResults:
          type: integer
          description: The maximum number of results to return.
    DeleteActionTargetRequest:
      type: object
      properties:
        ActionTargetArn:
          type: string
          description: The Amazon Resource Name (ARN) of the custom action target to delete.
      required:
      - ActionTargetArn
    InvalidAccessException:
      type: object
      properties:
        Message:
          type: string
        Code:
          type: string
  securitySchemes:
    SigV4:
      type: apiKey
      in: header
      name: Authorization
      description: AWS Signature Version 4 signed Authorization header
    sigv4:
      type: apiKey
      in: header
      name: Authorization
      description: AWS Signature Version 4. The Authorization header carries an AWS4-HMAC-SHA256 signature over the canonical request, with X-Amz-Date (and X-Amz-Security-Token for temporary credentials). Not a bearer token.
      x-aws-sigv4:
        signingName: securityhub
x-refined-from:
- aws-security-hub-openapi.yml
- aws-security-hub-action-targets-api-openapi.yml