Amazon Compute Optimizer Compute Optimizer Account API

The Compute Optimizer Account API from Amazon Compute Optimizer — 3 operation(s) for compute optimizer account.

GitHub OpenAPI

Operations 3

POST /#AssociateAccounts Associate Accounts #
POST /#DisassociateAccounts Disassociate Accounts #
POST /#ListAccounts List Accounts #

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-compute-optimizer:amazon-compute-optimizer-account-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-compute-optimizer-account-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: AWS Compute Optimizer Account API
  version: '2019-11-01'
  description: Generated from AWS's published Smithy model for AWS Compute Optimizer. 3 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://aco-automation.{region}.amazonaws.com
  variables:
    region:
      default: us-east-1
security:
- sigv4: []
paths:
  /#AssociateAccounts:
    post:
      operationId: AssociateAccounts
      summary: Associate Accounts
      description: Associates one or more member accounts with your organization's management account, enabling centralized
        implementation of optimization actions across those accounts. Once associated, the management account (or a delegated
        administrator) can apply recommended actions to the member account. When you associate a member account, its organization
        rule mode is automatically set to "Any allowed," which permits the management account to create Automation rules that
        automatically apply actions to that account. If the member account has not previously enabled the Automation feature,
        the association process automatically enables it. Only the management account or a delegated administrator can perform
        this action.
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/AssociateAccountsResponse'
        '403':
          description: AccessDeniedException; ForbiddenException; OptInRequiredException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/AccessDeniedException'
        '409':
          description: IdempotencyTokenInUseException; IdempotentParameterMismatchException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/IdempotencyTokenInUseException'
        '500':
          description: InternalServerException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/InternalServerException'
        '400':
          description: InvalidParameterValueException; NotManagementAccountException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/InvalidParameterValueException'
        '503':
          description: ServiceUnavailableException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/ServiceUnavailableException'
        '429':
          description: ThrottlingException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/AcoAutomationThrottlingException'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - ComputeOptimizerAutomationService.AssociateAccounts
      requestBody:
        required: true
        content:
          application/x-amz-json-1.0:
            schema:
              $ref: '#/components/schemas/AssociateAccountsRequest'
      tags:
      - Account
  /#DisassociateAccounts:
    post:
      operationId: DisassociateAccounts
      summary: Disassociate Accounts
      description: Disassociates member accounts from your organization's management account, removing centralized automation
        capabilities. Once disassociated, organization rules no longer apply to the member account, and the management account
        (or delegated administrator) cannot create Automation rules for that account. Only the management account or a delegated
        administrator can perform this action.
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/DisassociateAccountsResponse'
        '403':
          description: AccessDeniedException; ForbiddenException; OptInRequiredException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/AccessDeniedException'
        '409':
          description: IdempotencyTokenInUseException; IdempotentParameterMismatchException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/IdempotencyTokenInUseException'
        '500':
          description: InternalServerException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/InternalServerException'
        '400':
          description: InvalidParameterValueException; NotManagementAccountException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/InvalidParameterValueException'
        '503':
          description: ServiceUnavailableException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/ServiceUnavailableException'
        '429':
          description: ThrottlingException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/AcoAutomationThrottlingException'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - ComputeOptimizerAutomationService.DisassociateAccounts
      requestBody:
        required: true
        content:
          application/x-amz-json-1.0:
            schema:
              $ref: '#/components/schemas/DisassociateAccountsRequest'
      tags:
      - Account
  /#ListAccounts:
    post:
      operationId: ListAccounts
      summary: List Accounts
      description: Lists the accounts in your organization that are enrolled in Compute Optimizer and whether they have enabled
        Automation. Only the management account or a delegated administrator can perform this action.
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/ListAccountsResponse'
        '403':
          description: AccessDeniedException; ForbiddenException; OptInRequiredException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/AccessDeniedException'
        '500':
          description: InternalServerException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/InternalServerException'
        '400':
          description: InvalidParameterValueException; NotManagementAccountException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/InvalidParameterValueException'
        '503':
          description: ServiceUnavailableException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/ServiceUnavailableException'
        '429':
          description: ThrottlingException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/AcoAutomationThrottlingException'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - ComputeOptimizerAutomationService.ListAccounts
      requestBody:
        required: true
        content:
          application/x-amz-json-1.0:
            schema:
              $ref: '#/components/schemas/ListAccountsRequest'
      tags:
      - Account
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: aco-automation
  schemas:
    AccessDeniedException:
      type: object
      properties:
        message:
          type: string
    AccountInfo:
      type: object
      properties:
        accountId:
          type: string
          description: The ID of the Amazon Web Services account.
        status:
          type: string
          enum:
          - Active
          - Inactive
          - Pending
          - Failed
          description: 'The enrollment status of the account: Active, Inactive, Pending, or Failed.'
        organizationRuleMode:
          type: string
          enum:
          - AnyAllowed
          - NoneAllowed
          description: Specifies whether the management account can create Automation rules that implement optimization actions
            for this account.
        statusReason:
          type: string
          description: The reason for the current Automation enrollment status.
        lastUpdatedTimestamp:
          type: string
          description: The timestamp when the account's Automation enrollment status was last updated.
      required:
      - accountId
      - status
      - organizationRuleMode
      - lastUpdatedTimestamp
    AcoAutomationThrottlingException:
      type: object
      properties:
        message:
          type: string
    AssociateAccountsRequest:
      type: object
      properties:
        accountIds:
          type: array
          items:
            type: string
          description: The IDs of the member accounts to associate. You can specify up to 50 account IDs.
        clientToken:
          type: string
          description: A unique identifier to ensure idempotency of the request. Valid for 24 hours after creation.
      required:
      - accountIds
    AssociateAccountsResponse:
      type: object
      properties:
        accountIds:
          type: array
          items:
            type: string
          description: The IDs of the member accounts that were successfully associated.
        errors:
          type: array
          items:
            type: string
          description: Any errors that occurred during the association process.
    DisassociateAccountsRequest:
      type: object
      properties:
        accountIds:
          type: array
          items:
            type: string
          description: The IDs of the member accounts to disassociate.
        clientToken:
          type: string
          description: A unique identifier to ensure idempotency of the request.
      required:
      - accountIds
    DisassociateAccountsResponse:
      type: object
      properties:
        accountIds:
          type: array
          items:
            type: string
          description: The IDs of the member accounts that were successfully disassociated.
        errors:
          type: array
          items:
            type: string
          description: Any errors that occurred during the disassociation process.
    IdempotencyTokenInUseException:
      type: object
      properties:
        message:
          type: string
    InternalServerException:
      type: object
      properties:
        message:
          type: string
    InvalidParameterValueException:
      type: object
      properties:
        message:
          type: string
    ListAccountsRequest:
      type: object
      properties:
        maxResults:
          type: integer
          description: The maximum number of results to return in a single call.
        nextToken:
          type: string
          description: The token for the next page of results.
    ListAccountsResponse:
      type: object
      properties:
        accounts:
          type: array
          items:
            $ref: '#/components/schemas/AccountInfo'
          description: The list of accounts in your organization enrolled in Compute Optimizer
        nextToken:
          type: string
          description: The token to use to retrieve the next page of results.
      required:
      - accounts
    ServiceUnavailableException:
      type: object
      properties:
        message:
          type: string
x-provenance:
  method: harvested
  publisher: Amazon Web Services
  source: https://raw.githubusercontent.com/aws/api-models-aws/3cd98287b471c106254abd89279cc87308d38bfd/models/compute-optimizer-automation/service/2025-09-22/compute-optimizer-automation-2025-09-22.json
  note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)