Amazon Braket Spending Limits API

Control QPU and simulator spending

GitHub OpenAPI

Operations 4

POST /spending-limit Create Spending Limit #
POST /spending-limits Search Spending Limits #
PATCH /spending-limit/{spendingLimitArn}/update Update Spending Limit #
DELETE /spending-limit/{spendingLimitArn}/delete Delete Spending Limit #

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-braket:amazon-braket-spending-limits-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-braket-spending-limits-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: Braket Spending Limits API
  version: '2019-09-01'
  description: Generated from AWS's published Smithy model for Braket. 4 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://braket.{region}.amazonaws.com
  variables:
    region:
      default: us-east-1
security:
- sigv4: []
paths:
  /spending-limit:
    post:
      operationId: CreateSpendingLimit
      summary: Create Spending Limit
      description: Creates a spending limit for a specified quantum device. Spending limits help you control costs by setting
        maximum amounts that can be spent on quantum computing tasks within a specified time period. Simulators do not support
        spending limits.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateSpendingLimitResponse'
        '403':
          description: AccessDeniedException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccessDeniedException'
        '410':
          description: DeviceRetiredException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeviceRetiredException'
        '500':
          description: InternalServiceException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServiceException'
        '429':
          description: ThrottlingException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ThrottlingException'
        '400':
          description: ValidationException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationException'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateSpendingLimitRequest'
      tags:
      - Spending Limits
  /spending-limits:
    post:
      operationId: SearchSpendingLimits
      summary: Search Spending Limits
      description: Searches and lists spending limits based on specified filters. This operation supports pagination and allows
        filtering by various criteria to find specific spending limits. We recommend using pagination to ensure that the operation
        returns quickly and successfully.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SearchSpendingLimitsResponse'
        '403':
          description: AccessDeniedException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccessDeniedException'
        '500':
          description: InternalServiceException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServiceException'
        '429':
          description: ThrottlingException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ThrottlingException'
        '400':
          description: ValidationException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationException'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SearchSpendingLimitsRequest'
      tags:
      - Spending Limits
  /spending-limit/{spendingLimitArn}/update:
    patch:
      operationId: UpdateSpendingLimit
      summary: Update Spending Limit
      description: Updates an existing spending limit. You can modify the spending amount or time period. Changes take effect
        immediately.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateSpendingLimitResponse'
        '403':
          description: AccessDeniedException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccessDeniedException'
        '500':
          description: InternalServiceException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServiceException'
        '404':
          description: ResourceNotFoundException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceNotFoundException'
        '429':
          description: ThrottlingException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ThrottlingException'
        '400':
          description: ValidationException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationException'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateSpendingLimitRequest'
      tags:
      - Spending Limits
  /spending-limit/{spendingLimitArn}/delete:
    delete:
      operationId: DeleteSpendingLimit
      summary: Delete Spending Limit
      description: Deletes an existing spending limit. This operation permanently removes the spending limit and cannot be
        undone. After deletion, the associated device becomes unrestricted for spending.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteSpendingLimitResponse'
        '403':
          description: AccessDeniedException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccessDeniedException'
        '500':
          description: InternalServiceException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServiceException'
        '404':
          description: ResourceNotFoundException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceNotFoundException'
        '429':
          description: ThrottlingException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ThrottlingException'
        '400':
          description: ValidationException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationException'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeleteSpendingLimitRequest'
      tags:
      - Spending Limits
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: braket
  schemas:
    AccessDeniedException:
      type: object
      properties:
        message:
          type: string
    CreateSpendingLimitRequest:
      type: object
      properties:
        clientToken:
          type: string
          description: A unique, case-sensitive identifier to ensure that the operation completes no more than one time. If
            this token matches a previous request, Amazon Braket ignores the request, but does not return an error.
        deviceArn:
          type: string
          description: The Amazon Resource Name (ARN) of the quantum device to apply the spending limit to.
        spendingLimit:
          type: string
          description: The maximum amount that can be spent on the specified device, in USD.
        timePeriod:
          $ref: '#/components/schemas/TimePeriod'
        tags:
          type: object
          additionalProperties:
            type: string
          description: The tags to apply to the spending limit. Each tag consists of a key and an optional value.
      required:
      - clientToken
      - deviceArn
      - spendingLimit
    CreateSpendingLimitResponse:
      type: object
      properties:
        spendingLimitArn:
          type: string
          description: The Amazon Resource Name (ARN) of the created spending limit.
      required:
      - spendingLimitArn
    DeleteSpendingLimitRequest:
      type: object
      properties:
        spendingLimitArn:
          type: string
          description: The Amazon Resource Name (ARN) of the spending limit to delete.
      required:
      - spendingLimitArn
    DeleteSpendingLimitResponse:
      type: object
      properties: {}
    DeviceRetiredException:
      type: object
      properties:
        message:
          type: string
    InternalServiceException:
      type: object
      properties:
        message:
          type: string
    ProgramSetValidationFailure:
      type: object
      properties:
        programIndex:
          type: integer
          description: The index of the program within the program set that failed validation.
        inputsIndex:
          type: integer
          description: The index of the input within the program set that failed validation.
        errors:
          type: array
          items:
            type: string
          description: A list of error messages describing the validation failures that occurred.
      required:
      - programIndex
    ResourceNotFoundException:
      type: object
      properties:
        message:
          type: string
    SearchSpendingLimitsFilter:
      type: object
      properties:
        name:
          type: string
          description: The name of the field to filter on. Currently only supports deviceArn.
        values:
          type: array
          items:
            type: string
          description: An array of values to match against the specified field.
        operator:
          type: string
          description: The comparison operator to use when filtering.
      required:
      - name
      - values
      - operator
    SearchSpendingLimitsRequest:
      type: object
      properties:
        nextToken:
          type: string
          description: The token to retrieve the next page of results. This value is returned from a previous call to SearchSpendingLimits
            when there are more results available.
        maxResults:
          type: integer
          description: The maximum number of results to return in a single call. Minimum value of 1, maximum value of 100.
            Default is 20.
        filters:
          type: array
          items:
            $ref: '#/components/schemas/SearchSpendingLimitsFilter'
          description: The filters to apply when searching for spending limits. Use filters to narrow down the results based
            on specific criteria.
    SearchSpendingLimitsResponse:
      type: object
      properties:
        spendingLimits:
          type: array
          items:
            $ref: '#/components/schemas/SpendingLimitSummary'
          description: An array of spending limit summaries that match the specified filters.
        nextToken:
          type: string
          description: The token to retrieve the next page of results. This value is null when there are no more results to
            return.
      required:
      - spendingLimits
    SpendingLimitSummary:
      type: object
      properties:
        spendingLimitArn:
          type: string
          description: The Amazon Resource Name (ARN) that uniquely identifies the spending limit.
        deviceArn:
          type: string
          description: The Amazon Resource Name (ARN) of the quantum device associated with this spending limit.
        timePeriod:
          $ref: '#/components/schemas/TimePeriod'
        spendingLimit:
          type: string
          description: The maximum spending amount allowed for the device during the specified time period, in USD.
        queuedSpend:
          type: string
          description: The amount currently queued for spending on the device, in USD.
        totalSpend:
          type: string
          description: The total amount spent on the device so far during the current time period, in USD.
        createdAt:
          type: string
          description: The date and time when the spending limit was created, in epoch seconds.
        updatedAt:
          type: string
          description: The date and time when the spending limit was last modified, in epoch seconds.
        tags:
          type: object
          additionalProperties:
            type: string
          description: The tags associated with the spending limit. Each tag consists of a key and an optional value.
      required:
      - spendingLimitArn
      - deviceArn
      - timePeriod
      - spendingLimit
      - queuedSpend
      - totalSpend
      - createdAt
      - updatedAt
    ThrottlingException:
      type: object
      properties:
        message:
          type: string
    TimePeriod:
      type: object
      properties:
        startAt:
          type: string
          description: The start date and time for the spending limit period, in epoch seconds.
        endAt:
          type: string
          description: The end date and time for the spending limit period, in epoch seconds.
      required:
      - startAt
      - endAt
    UpdateSpendingLimitRequest:
      type: object
      properties:
        spendingLimitArn:
          type: string
          description: The Amazon Resource Name (ARN) of the spending limit to update.
        clientToken:
          type: string
          description: A unique, case-sensitive identifier to ensure that the operation completes no more than one time. If
            this token matches a previous request, Amazon Braket ignores the request, but does not return an error.
        spendingLimit:
          type: string
          description: The new maximum amount that can be spent on the specified device, in USD.
        timePeriod:
          $ref: '#/components/schemas/TimePeriod'
      required:
      - spendingLimitArn
      - clientToken
    UpdateSpendingLimitResponse:
      type: object
      properties: {}
    ValidationException:
      type: object
      properties:
        message:
          type: string
        reason:
          type: string
          description: The reason for validation failure.
        programSetValidationFailures:
          type: array
          items:
            $ref: '#/components/schemas/ProgramSetValidationFailure'
          description: The validation failures in the program set submitted in the request.
x-provenance:
  method: harvested
  publisher: Amazon Web Services
  source: https://raw.githubusercontent.com/aws/api-models-aws/3cd98287b471c106254abd89279cc87308d38bfd/models/braket/service/2019-09-01/braket-2019-09-01.json
  note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)