Amazon EventBridge Events API

Operations for putting events to EventBridge.

GitHub OpenAPI

Operations 1

POST /#PutEvents Put Events #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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/amazon-eventbridge:amazon-eventbridge-events-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.

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

OpenAPI Specification

amazon-eventbridge-events-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: Amazon EventBridge Events API
  version: '2015-10-07'
  description: Generated from AWS's published Smithy model for Amazon EventBridge. 1 operation(s).
  contact:
    name: Amazon Web Services
    url: https://aws.amazon.com/contact-us/
  license:
    name: Apache 2.0
    identifier: Apache-2.0
    url: https://github.com/aws/api-models-aws/blob/main/LICENSE
servers:
- url: https://events.{region}.amazonaws.com
  variables:
    region:
      default: us-east-1
security:
- sigv4: []
paths:
  /#PutEvents:
    post:
      operationId: PutEvents
      summary: Put Events
      description: 'Sends custom events to Amazon EventBridge so that they can be matched to rules. You can batch multiple
        event entries into one request for efficiency. However, the total entry size must be less than 1MB. You can calculate
        the entry size before you send the events. For more information, see Calculating PutEvents event entry size in the
        Amazon EventBridge User Guide . PutEvents accepts the data in JSON format. For the JSON number (integer) data type,
        the constraints are: a minimum value of -9,223,372,036,854,775,808 and a maximum value of 9,223,372,036,854,775,807.
        PutEvents will only process nested JSON up to 1000 levels deep.'
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/PutEventsResponse'
        '500':
          description: InternalException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/InternalException'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - AWSEvents.PutEvents
      requestBody:
        required: true
        content:
          application/x-amz-json-1.1:
            schema:
              $ref: '#/components/schemas/PutEventsRequest'
      tags:
      - Events
components:
  securitySchemes:
    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: events
  schemas:
    InternalException:
      type: object
      properties:
        message:
          type: string
    PutEventsRequest:
      type: object
      properties:
        Entries:
          type: array
          items:
            $ref: '#/components/schemas/PutEventsRequestEntry'
          description: The entry that defines an event in your system. You can specify several parameters for the entry such
            as the source and type of the event, resources associated with the event, and so on.
        EndpointId:
          type: string
          description: The URL subdomain of the endpoint. For example, if the URL for Endpoint is https://abcde.veo.endpoints.event.amazonaws.com,
            then the EndpointId is abcde.veo. When using Java, you must include auth-crt on the class path.
      required:
      - Entries
    PutEventsRequestEntry:
      type: object
      properties:
        Time:
          type: string
          format: date-time
          description: The time stamp of the event, per RFC3339. If no time stamp is provided, the time stamp of the PutEvents
            call is used.
        Source:
          type: string
          description: The source of the event. Detail, DetailType, and Source are required for EventBridge to successfully
            send an event to an event bus. If you include event entries in a request that do not include each of those properties,
            EventBridge fails that entry. If you submit a request in which none of the entries have each of these properties,
            EventBridge fails the entire request.
        Resources:
          type: array
          items:
            type: string
          description: Amazon Web Services resources, identified by Amazon Resource Name (ARN), which the event primarily
            concerns. Any number, including zero, may be present.
        DetailType:
          type: string
          description: Free-form string, with a maximum of 128 characters, used to decide what fields to expect in the event
            detail. Detail, DetailType, and Source are required for EventBridge to successfully send an event to an event
            bus. If you include event entries in a request that do not include each of those properties, EventBridge fails
            that entry. If you submit a request in which none of the entries have each of these properties, EventBridge fails
            the entire request.
        Detail:
          type: string
          description: A valid JSON object. There is no other schema imposed. The JSON object may contain fields and nested
            sub-objects. Detail, DetailType, and Source are required for EventBridge to successfully send an event to an event
            bus. If you include event entries in a request that do not include each of those properties, EventBridge fails
            that entry. If you submit a request in which none of the entries have each of these properties, EventBridge fails
            the entire request.
        EventBusName:
          type: string
          description: The name or ARN of the event bus to receive the event. Only the rules that are associated with this
            event bus are used to match the event. If you omit this, the default event bus is used. If you're using a global
            endpoint with a custom bus, you can enter either the name or Amazon Resource Name (ARN) of the event bus in either
            the primary or secondary Region here. EventBridge then determines the corresponding event bus in the other Region
            based on the endpoint referenced by the EndpointId. Specifying the event bus ARN is preferred.
        TraceHeader:
          type: string
          description: An X-Ray trace header, which is an http header (X-Amzn-Trace-Id) that contains the trace-id associated
            with the event. To learn more about X-Ray trace headers, see Tracing header in the X-Ray Developer Guide.
    PutEventsResponse:
      type: object
      properties:
        FailedEntryCount:
          type: integer
          description: The number of failed entries.
        Entries:
          type: array
          items:
            $ref: '#/components/schemas/PutEventsResultEntry'
          description: The successfully and unsuccessfully ingested events results. If the ingestion was successful, the entry
            has the event ID in it. Otherwise, you can use the error code and error message to identify the problem with the
            entry. For each record, the index of the response element is the same as the index in the request array.
    PutEventsResultEntry:
      type: object
      properties:
        EventId:
          type: string
          description: The ID of the event.
        ErrorCode:
          type: string
          description: 'The error code that indicates why the event submission failed. Retryable errors include: InternalFailure
            The request processing has failed because of an unknown error, exception or failure. ThrottlingException The request
            was denied due to request throttling. Non-retryable errors include: AccessDeniedException You do not have sufficient
            access to perform this action. InvalidAccountIdException The account ID provided is not valid. InvalidArgument
            A specified parameter is not valid. MalformedDetail The JSON provided is not valid. RedactionFailure Redacting
            the CloudTrail event failed. NotAuthori'
        ErrorMessage:
          type: string
          description: The error message that explains why the event submission failed.
x-provenance:
  method: harvested
  publisher: Amazon Web Services
  source: https://raw.githubusercontent.com/aws/api-models-aws/3cd98287b471c106254abd89279cc87308d38bfd/models/eventbridge/service/2015-10-07/eventbridge-2015-10-07.json
  note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)