Alphaus Cost API

Cost API. Base URL: https://api.alphaus.cloud/m/blue/cost

Operations 73

POST /v1/alerts CreateBudgetAlerts #
GET /v1/alerts/{id} GetBudgetAlerts #
DELETE /v1/alerts/{id} DeleteBudgetAlerts #
PUT /v1/alerts/{id} UpdateBudgetAlerts #
POST /v1/alerts:read ReadBudgetAlerts #
POST /v1/aws/cur:import Initiates an ondemand import of all registered CUR files. #
POST /v1/exportcsv/payers:export Exports RI and SP for all payers. #
POST /v1/invoicecosts:read WORK-IN-PROGRESS: Read the invoice costs. Only available in Ripple. #
POST /v1/invoicegroupcosts:read WORK-IN-PROGRESS: Read the invoice group costs. Only available in Ripple. #
POST /v1/invoiceoverviews:read WORK-IN-PROGRESS: Read the invoice overviews. Only available in Ripple. #
POST /v1/reports:export Exports a vendor report and delivers results via email notification channel. Supports multiple report types per vendor. For AWS, this covers RI/SP utilization reports. Returns a lo #
GET /v1/{vendor}/accounts Lists all vendor accounts. #
POST /v1/{vendor}/accounts Registers a vendor account. #
POST /v1/{vendor}/accounts/customers/accounts:check WORK-IN-PROGRESS: Check inputed accountIds belong to current MSP or not #
GET /v1/{vendor}/accounts/groups/{groupId} Lists all vendor accounts. #
GET /v1/{vendor}/accounts/{id} Gets a vendor account. This API includes all of the account's metadata. See https://alphauslabs.github.io/blueapi/ for the list of supported attributes. #
DELETE /v1/{vendor}/accounts/{id} WORK-IN-PROGRESS: Deletes a vendor account. #
PUT /v1/{vendor}/accounts/{id} WORK-IN-PROGRESS: Updates a vendor account. Only available in Ripple. #
POST /v1/{vendor}/adjustments:read Reads the non-usage-based details of an organization (Ripple) or billing group (Wave[Pro]). #
GET /v1/{vendor}/alerts/{id} Get the budget alerts for the account id. Only available in Wave(Pro). #
DELETE /v1/{vendor}/alerts/{id} Delete the budget alerts for the account id. Only available in Wave(Pro). #
POST /v1/{vendor}/alerts/{id} Create the budget alerts for the account id. Only available in Wave(Pro). #
PUT /v1/{vendor}/alerts/{id} Update the budget alerts for the account id. Only available in Wave(Pro). #
POST /v1/{vendor}/aors:read Reads all vendor account-original-resources. Account that have not been used for one month will no longer be retrieved. #
GET /v1/{vendor}/bep/{orgId} Get the breakeven point details for the RI or SP. #
DELETE /v1/{vendor}/budget/{budgetId} Removes monthly budget for the account/acctgroup id from database. #
PUT /v1/{vendor}/budget/{budgetId} Updates monthly budget for the account/acctgroup id. #
GET /v1/{vendor}/budget/{level}/{id} Fetches monthly budget for the account/acctgroup id. #
POST /v1/{vendor}/budget/{level}/{id} Creates monthly budget for the account/acctgroup id. #
GET /v1/{vendor}/calculation/prerequisites/{month} WORK-IN-PROGRESS: List the prerequisites for cost calculations. #
GET /v1/{vendor}/calculations/history Lists vendor costs calculations history and statuses. #
GET /v1/{vendor}/calculations/schedules Lists the schedules of your monthly calculations. Only available in Ripple. #
POST /v1/{vendor}/calculations/schedules Creates a schedule to trigger your monthly calculations. At the moment, only one schedule is allowed per account. Only available in Ripple. #
DELETE /v1/{vendor}/calculations/schedules/{id} Deletes the schedule of your monthly calculations. Only available in Ripple. #
GET /v1/{vendor}/calculator/config WORK-IN-PROGRESS: Gets the vendor cost calculator's current configuration. #
GET /v1/{vendor}/calculator/config/costmods Lists the cost calculator's cost modifiers. At the moment, the supported {vendor} is 'aws'. Only available in Ripple. #
POST /v1/{vendor}/calculator/config/costmods Creates a cost modifier. #
DELETE /v1/{vendor}/calculator/config/costmods/{id} Deletes a cost modifier. At the moment, the supported {vendor} is 'aws'. Only available in Ripple. #
POST /v1/{vendor}/calculator/running:read Lists the vendor calculator's queued accounts for calculation. #
GET /v1/{vendor}/costattrs WORK-IN-PROGRESS: Reads the available cost attributes of an organization (Ripple) or billing group (Wave). #
POST /v1/{vendor}/costattrs:read Reads the available cost attributes of an organization (Ripple) or billing group (Wave). #
GET /v1/{vendor}/costfilters Lists the usage-based cost filter condition. Only available in Wave(Pro). #
POST /v1/{vendor}/costfilters Creates the usage-based cost filter condition. #
DELETE /v1/{vendor}/costfilters/{filterId} Deletes the usage-based cost filter condition. Only available in Wave(Pro). #
PUT /v1/{vendor}/costfilters/{filterId} Updates the usage-based cost filter condition. Only available in Wave(Pro). #
POST /v1/{vendor}/costfilters/{filterId}:export Exports the usage-based cost filter condition. Only available in Wave(Pro). #
POST /v1/{vendor}/costs:calculate Triggers monthly calculations for costs and invoices at either organization or billing group level. #
POST /v1/{vendor}/costs:read Reads the usage-based cost details of an organization (Ripple) or billing group (Wave). #
POST /v1/{vendor}/coverage/ondemand/{orgId}:read Get ondemand cost details for an organization (or MSP). #
POST /v1/{vendor}/coverage/options/{orgId}:read Get coverage options details for an organization (or MSP). #
GET /v1/{vendor}/forecasts Fetches cost forecasts for the specified billing group. Includes historical cost (up to previous month) and forecasted cost (up to three months for now). #
GET /v1/{vendor}/forecasts/month-on-month/{level}/{id} Fetches previous month cost vs current month forecast vs current accumulated cost per category for id. #
GET /v1/{vendor}/forecasts/month-to-date/{level}/{id} Fetches current month daily forecast vs current accumulated daily cost for id. #
GET /v1/{vendor}/forecasts/monthly/{level}/{id} Fetches monthly accumulated costs vs forecasted cost vs budget for the id. #
POST /v1/{vendor}/invoiceids:read Read the invoice ids. Only available in Ripple. #
POST /v1/{vendor}/nontagcosts:read Reads the usage-based non tag costs of a billing group. #
GET /v1/{vendor}/payers Lists vendor payer accounts. #
POST /v1/{vendor}/payers DEPRECATED: Registers a vendor payer account. This is now deprecated for AWS payer accounts. To register an AWS payer account, check out the 'CreateDefaultCostAccess' API. #
POST /v1/{vendor}/payers/basicdetails WORK-IN-PROGRES: Registers a vendor payer account with their basics details such as accountId and accountName. #
PUT /v1/{vendor}/payers/basicdetails/{id} WORK-IN-PROGRES: Updates a vendor payer account's basics details. #
GET /v1/{vendor}/payers/{id} Gets a vendor payer account. #
DELETE /v1/{vendor}/payers/{id} Deletes a vendor payer account. #
POST /v1/{vendor}/payers/{id}/billingtransfer WORK-IN-PROGRESS: Setup payer's billing transfer information #
GET /v1/{vendor}/payers/{id}/importhistory Gets a payer account's import history. #
GET /v1/{vendor}/payers/{id}/proforma Gets a payer account's proforma reports. Applicable for AWS payer accounts only. #
GET /v1/{vendor}/payersextended Lists vendor payer accounts with extended information. WORK IN PROGRESS #
GET /v1/{vendor}/payersextended/{id} Gets a vendor payer account with extended information. WORK IN PROGRESS #
POST /v1/{vendor}/recommendations/{orgId}:read WORK-IN-PROGRESS: Get cost opmtimization recommendations for an organization (or MSP). #
POST /v1/{vendor}/reduction/{orgId}:read Get cost reduction details for an organization (or MSP). #
POST /v1/{vendor}/tagcosts:read Reads the usage-based tag costs of a billing group. #
GET /v1/{vendor}/tags Lists all vendor tags. #
GET /v1/{vendor}/tags/groups/{groupId} Lists all vendor tags. #
GET /v1/{vendor}/utilization/{orgId} Get the utilization details for an organization (or MSP). #

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/alphaus-cost-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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

alphaus-cost-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Blue API reference Admin Cost API
  description: 'Alphaus provides an API for interacting with its services. Blue API is a RESTful API that can be accessed by an HTTP client such as `curl`, or any HTTP library which is part of most modern programming languages. This API reference is autogenerated from [protocol buffers](https://developers.google.com/protocol-buffers) defined in this [repository](https://github.com/alphauslabs/blueapi), together with our supported [client libraries](https://alphauslabs.github.io/docs/blueapi/client-sdks/). See the official [documentation](https://alphauslabs.github.io/docs/blueapi/overview/) for more information.


    You may encounter the following feature maturity indicators:

    - **(WORK-IN-PROGRESS)** - Development is ongoing, don''t use yet;

    - **(BETA)** - New or experimental features, subject to changes; and

    - **(DEPRECATED)** - Outdated or replaced features.


    Some endpoints, especially those that return lists of resources, have streaming responses; newline-separated stream of “chunks”. Each chunk is an envelope that can contain either a response message or an error. Only the last chunk will include an error, if any.'
  version: v1
servers:
- url: https://api.alphaus.cloud/m/blue
  description: Base URL reconciled from apis.yml
tags:
- name: Cost
  description: 'Cost API. Base URL: https://api.alphaus.cloud/m/blue/cost'
  externalDocs:
    description: Service definition
    url: https://github.com/alphauslabs/blueapi/tree/main/cost/
paths:
  /v1/alerts:
    post:
      summary: CreateBudgetAlerts
      description: 'Create the budget alerts.

        Only available in Wave(Pro).'
      operationId: Cost_CreateBudgetAlerts
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1BudgetAlerts'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      tags:
      - Cost
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1CreateBudgetAlertsRequest'
        description: Request message for the CreateBudgetAlerts rpc.
        required: true
  /v1/alerts/{id}:
    get:
      summary: GetBudgetAlerts
      description: 'Gets the budget alerts.

        Only available in Wave(Pro).'
      operationId: Cost_GetBudgetAlerts
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1BudgetAlerts'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        description: Required. budget alert id
        in: path
        required: true
        schema:
          type: string
      tags:
      - Cost
    delete:
      summary: DeleteBudgetAlerts
      description: 'Deletes the budget alerts.

        Only available in Wave(Pro).'
      operationId: Cost_DeleteBudgetAlerts
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                type: object
                properties: {}
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        description: Required. budget alert id
        in: path
        required: true
        schema:
          type: string
      tags:
      - Cost
    put:
      summary: UpdateBudgetAlerts
      description: 'Updates the budget alerts.

        Only available in Wave(Pro).'
      operationId: Cost_UpdateBudgetAlerts
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1BudgetAlerts'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        description: Required. budget alert id
        in: path
        required: true
        schema:
          type: string
      tags:
      - Cost
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CostUpdateBudgetAlertsBody'
        required: true
  /v1/alerts:read:
    post:
      summary: ReadBudgetAlerts
      description: "Reads the budget alerts.\nOnly available in Wave(Pro).\n[ERRORS] \n- Unimplemented:\n  - not implemented\n- InvalidArgument:\n  - parse error"
      operationId: Cost_ReadBudgetAlerts
      responses:
        '200':
          description: A successful response.(streaming responses)
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    $ref: '#/components/schemas/v1BudgetAlerts'
                  error:
                    $ref: '#/components/schemas/rpcStatus'
                title: Stream result of v1BudgetAlerts
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      tags:
      - Cost
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1ReadBudgetAlertsRequest'
        description: Request message for the ReadBudgetAlerts rpc.
        required: true
  /v1/aws/cur:import:
    post:
      summary: Initiates an ondemand import of all registered CUR files.
      description: See https://help.alphaus.cloud/en/articles/3612555-ripple-aws-things-you-need-to-prepare-before-starting for more information.
      operationId: Cost_ImportCurFiles
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/protosOperation'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      tags:
      - Cost
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1ImportCurFilesRequest'
        description: Request message for the Cost.ImportCurFiles rpc.
        required: true
  /v1/exportcsv/payers:export:
    post:
      summary: Exports RI and SP for all payers.
      operationId: Cost_GetExportRISP
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1GetExportRISPResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      tags:
      - Cost
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1GetExportRISPRequest'
        required: true
  /v1/invoicecosts:read:
    post:
      summary: 'WORK-IN-PROGRESS: Read the invoice costs. Only available in Ripple.'
      operationId: Cost_ReadInvoiceCosts
      responses:
        '200':
          description: A successful response.(streaming responses)
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    $ref: '#/components/schemas/v1TotalSection'
                  error:
                    $ref: '#/components/schemas/rpcStatus'
                title: Stream result of v1TotalSection
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      tags:
      - Cost
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1ReadInvoiceCostsRequest'
        description: Request message for the ReadInvoiceCosts rpc.
        required: true
  /v1/invoicegroupcosts:read:
    post:
      summary: 'WORK-IN-PROGRESS: Read the invoice group costs. Only available in Ripple.'
      operationId: Cost_ReadInvoiceGroupCosts
      responses:
        '200':
          description: A successful response.(streaming responses)
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    $ref: '#/components/schemas/v1BillingGroupSection'
                  error:
                    $ref: '#/components/schemas/rpcStatus'
                title: Stream result of v1BillingGroupSection
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      tags:
      - Cost
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1ReadInvoiceGroupCostsRequest'
        description: Request message for the ReadInvoiceGroupCosts rpc.
        required: true
  /v1/invoiceoverviews:read:
    post:
      summary: 'WORK-IN-PROGRESS: Read the invoice overviews. Only available in Ripple.'
      operationId: Cost_ReadInvoiceOverViews
      responses:
        '200':
          description: A successful response.(streaming responses)
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    $ref: '#/components/schemas/v1OverViewSection'
                  error:
                    $ref: '#/components/schemas/rpcStatus'
                title: Stream result of v1OverViewSection
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      tags:
      - Cost
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1ReadInvoiceOverviewsRequest'
        description: Request message for the ReadInvoiceOverviews rpc.
        required: true
  /v1/reports:export:
    post:
      summary: 'Exports a vendor report and delivers results via email notification channel.

        Supports multiple report types per vendor. For AWS, this covers RI/SP utilization reports.

        Returns a long-running operation; use GetOperation to poll for completion.'
      operationId: Cost_ExportReport
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/protosOperation'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      tags:
      - Cost
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1ExportReportRequest'
        description: Request message for ExportReport.
        required: true
  /v1/{vendor}/accounts:
    get:
      summary: Lists all vendor accounts.
      operationId: Cost_ListAccounts
      responses:
        '200':
          description: A successful response.(streaming responses)
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    $ref: '#/components/schemas/blueapiApiAccount'
                  error:
                    $ref: '#/components/schemas/rpcStatus'
                title: Stream result of blueapiApiAccount
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: vendor
        description: Required. At the moment, `aws` and `gcp` is supported.
        in: path
        required: true
        schema:
          type: string
      - name: groupId
        description: Optional. The billing group internal id. Only valid for Ripple users.
        in: query
        required: false
        schema:
          type: string
      - name: fieldMask
        description: Optional.
        in: query
        required: false
        schema:
          type: string
      tags:
      - Cost
    post:
      summary: Registers a vendor account.
      operationId: Cost_CreateAccount
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/blueapiApiAccount'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: vendor
        description: Required. At the moment, only `aws` is supported.
        in: path
        required: true
        schema:
          type: string
      tags:
      - Cost
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CostCreateAccountBody'
        required: true
  /v1/{vendor}/accounts/customers/accounts:check:
    post:
      summary: 'WORK-IN-PROGRESS: Check inputed accountIds belong to current MSP or not'
      operationId: Cost_CheckAccountsBelongToMsp
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1CheckAccountsResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: vendor
        description: Required. At the moment, only `aws` is supported.
        in: path
        required: true
        schema:
          type: string
      tags:
      - Cost
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CostCheckAccountsBelongToMspBody'
        required: true
  /v1/{vendor}/accounts/groups/{groupId}:
    get:
      summary: Lists all vendor accounts.
      operationId: Cost_ListAccounts2
      responses:
        '200':
          description: A successful response.(streaming responses)
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    $ref: '#/components/schemas/blueapiApiAccount'
                  error:
                    $ref: '#/components/schemas/rpcStatus'
                title: Stream result of blueapiApiAccount
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: vendor
        description: Required. At the moment, `aws` and `gcp` is supported.
        in: path
        required: true
        schema:
          type: string
      - name: groupId
        description: Optional. The billing group internal id. Only valid for Ripple users.
        in: path
        required: true
        schema:
          type: string
      - name: fieldMask
        description: Optional.
        in: query
        required: false
        schema:
          type: string
      tags:
      - Cost
  /v1/{vendor}/accounts/{id}:
    get:
      summary: Gets a vendor account. This API includes all of the account's metadata. See https://alphauslabs.github.io/blueapi/ for the list of supported attributes.
      operationId: Cost_GetAccount
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/blueapiApiAccount'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: vendor
        description: Required. At the moment, `aws` and `gcp` is supported.
        in: path
        required: true
        schema:
          type: string
      - name: id
        description: Required. The account id to retrieve.
        in: path
        required: true
        schema:
          type: string
      - name: fieldMask
        description: Optional.
        in: query
        required: false
        schema:
          type: string
      tags:
      - Cost
    delete:
      summary: 'WORK-IN-PROGRESS: Deletes a vendor account.'
      operationId: Cost_DeleteAccount
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                type: object
                properties: {}
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: vendor
        description: Required. At the moment, only `aws` is supported.
        in: path
        required: true
        schema:
          type: string
      - name: id
        description: Required. The account id to delete.
        in: path
        required: true
        schema:
          type: string
      tags:
      - Cost
    put:
      summary: 'WORK-IN-PROGRESS: Updates a vendor account. Only available in Ripple.'
      operationId: Cost_UpdateAccount
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/blueapiApiAccount'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: vendor
        description: Required.
        in: path
        required: true
        schema:
          type: string
      - name: id
        description: Required.
        in: path
        required: true
        schema:
          type: string
      tags:
      - Cost
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CostUpdateAccountBody'
        required: true
  /v1/{vendor}/adjustments:read:
    post:
      summary: Reads the non-usage-based details of an organization (Ripple) or billing group (Wave[Pro]).
      description: This API covers non-usage-based adjustments, such as Fees, Credits, Discounts, Tax, Upfront Fees, etc. At the moment, the supported `{vendor}` is `aws` or `azure`. If datetime range parameters are not set, month-to-date (current month) will be returned.
      operationId: Cost_ReadAdjustments
      responses:
        '200':
          description: A successful response.(streaming responses)
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    $ref: '#/components/schemas/blueapiCostV1CostItem'
                  error:
                    $ref: '#/components/schemas/rpcStatus'
                title: Stream result of blueapiCostV1CostItem
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: vendor
        description: Required. At the moment, only `aws` or `azure` is supported.
        in: path
        required: true
        schema:
          type: string
      tags:
      - Cost
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CostReadAdjustmentsBody'
        required: true
  /v1/{vendor}/alerts/{id}:
    get:
      summary: Get the budget alerts for the account id. Only available in Wave(Pro).
      operationId: Cost_GetAccountBudgetAlerts
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apiWaveBudgetAlert'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: vendor
        description: Required. At the moment, only `aws` is supported.
        in: path
        required: true
        schema:
          type: string
      - name: id
        description: Required. Account Id
        in: path
        required: true
        schema:
          type: string
      tags:
      - Cost
    delete:
      summary: Delete the budget alerts for the account id. Only available in Wave(Pro).
      operationId: Cost_DeleteAccountBudgetAlerts
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                type: object
                properties: {}
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: vendor
        description: Required. At the moment, only `aws` is supported.
        in: path
        required: true
        schema:
          type: string
      - name: id
        description: Required. Account Id
        in: path
        required: true
        schema:
          type: string
      tags:
      - Cost
    post:
      summary: Create the budget alerts for the account id. Only available in Wave(Pro).
      operationId: Cost_CreateAccountBudgetAlerts
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apiWaveBudgetAlert'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: vendor
        description: Required. At the moment, only `aws` is supported.
        in: path
        required: true
        schema:
          type: string
      - name: id
        description: Required. Account Id
        in: path
        required: true
        schema:
          type: string
      tags:
      - Cost
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CostCreateAccountBudgetAlertsBody'
        required: true
    put:
      summary: Update the budget alerts for the account id. Only available in Wave(Pro).
      operationId: Cost_UpdateAccountBudgetAlerts
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apiWaveBudgetAlert'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: vendor
        description: Required. At the moment, only `aws` is supported.
        in: path
        required: true
        schema:
          type: string
      - name: id
        description: Required. Account Id
        in: path
        required: true
        schema:
          type: string
      tags:
      - Cost
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CostUpdateAccountBudgetAlertsBody'
        required: true
  /v1/{vendor}/aors:read:
    post:
      summary: 'Reads all vendor account-original-resources.

        Account that have not been used for one month will no longer be retrieved.'
      operationId: Cost_ReadAccountOriginalResources
      responses:
        '200':
          description: A successful response.(streaming responses)
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    $ref: '#/components/schemas/apiAccountOriginalResource'
                  error:
                    $ref: '#/components/schemas/rpcStatus'
                title: Stream result of apiAccountOriginalResource
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: vendor
        description: Required. At the moment, only `aws`.`gcp`,`azure` is supported.
        in: path
        required: true
        schema:
          type: string
      tags:
      - Cost
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CostReadAccountOriginalResourcesBody'
        required: true
  /v1/{vendor}/bep/{orgId}:
    get:
      summary: Get the breakeven point details for the RI or SP.
      operationId: Cost_GetBreakevenPoint
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1GetBreakevenPointResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: vendor
        description: Required. At the moment, only `aws` is supported.
        in: path
        required: true
        schema:
          type: string
      - name: orgId
        description: Required. Organization Id.
        in: path
        required: true
        schema:
          type: string
      - name: type
        description: Required. For AWS, "ri" or "sp".
        in: query
        required: false
        schema:
          type: string
      - name: arn
        description: Required. RI/SP Arn.
        in: query
        required: false
        schema:
          type: string
      tags:
      - Cost
  /v1/{vendor}/budget/{budgetId}:
    delete:
      summary: Removes monthly budget for the account/acctgroup id from database.
      operationId: Cost_DeleteAccountBudget
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                type: object
                properties: {}
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: vendor
        description: Required. At the moment, only `aws` is supported.
        in: path
        required: true
        schema:
          type: string
      - name: budgetId
        description: Required. Budget Id
        in: path
        required: true
        schema:
          type: string
      tags:
      - Cost
    put:
      summary: Updates monthly budget for the account/acctgroup id.
      operationId: Cost_UpdateAccountBudget
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                type: object
                properties: {}
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: vendor
        description: Required. At the moment, only `aws` is supported.
        in: path
        required: true
        schema:
          type: string
      - name: budgetId
        description: Required. Budget Id
        in: path
        required: true
        schema:
          type: string
      tags:
      - Cost
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CostUpdateAccountBudgetBody'
        required: true
  /v1/{vendor}/budget/{level}/{id}:
    get:
      summary: Fetches monthly budget for the account/acctgroup id.
      operationId: Cost_GetAccountBudget
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1GetAccountBudgetResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: vendor
        description: Required. At the moment, only `aws` is supported.
        in: path
        required: true
        schema:
          type: string
      - name: level
        description: Required. 'account' or 'acctgroup'
        in: path
        required: true
        schema:
          type: string
      - name: id
        description: Required. Account or AccountGroup Id
        in: path
        required: true
        schema:
          type: string
      - name: year
        description: 'Optional. Default is current year. Format: `yyyy`.'
        in: query
        required: false
        schema:
          type: string
      tags:
      - Cost
    post:
      summary: Creates monthly budget for the account/acctgroup id.
      operationId: Cost_CreateAccountBudget
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1CreateAccountBudgetResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: vendor
        description: Required. At the moment, only `aws` is supported.
        in: path
        required: true
        schema:
          type: string
      - name: level
        description: Required. 'account' or 'acctgroup'
        in: path
        required: true
        schema:
          type: string
      - name: id
        description: Required. Account or AccountGroup Id
        in: path
        required: true
        schema:
          type: string
      tags:
      - Cost
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CostCreateAccountBudgetBody'
        required: true
  /v1/{vendor}/calculation/prerequisites/{month}:
    get:
      summary: 'WORK-IN-PROGRESS: List the prerequisites for cost calculations.'
      operationId: Cost_ListCalculationPrerequisites
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1ListCalculationPrerequisitesResponse'
        default:
          d

# --- truncated at 32 KB (221 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/alphaus/refs/heads/main/openapi/alphaus-cost-api-openapi.yml