Commitment Types (Beta)

Agent-friendly commitment type lookup

List available commitment types

get

Returns the commitment types available for the specified provider. Each type lists its supported contract terms, and each term lists the payment options that are actually offered for that (type, term) pair — the cross product of terms x payment options is NOT implied. Every leaf field (commitment_type, contract_terms[*].contract_term, contract_terms[*].payment_options[*]) is the exact value you pass into a plan's configuration.contract_specs.

Path parameters

org_idstring · uuidRequired

Query parameters

providerstring · enumRequired

Cloud provider to list commitment types for (aws, azure, gcp).

Possible values:

Responses

200

OK

application/json

commitment_typestringRequired

Commitment type identifier (e.g. 'ComputeSavingsPlan', 'EC2ReservedInstance'). Pass directly as commitment_type in a plan's configuration.contract_specs.

400

Bad request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not found

application/json

405

Method not allowed

application/json

409

Conflict

application/json

422

Unprocessable Content

application/json

500

Internal server error

application/json

default

Default error response

application/json

get

/beta/v1/org/{org_id}/commitment-types

HTTPcURLJavaScriptPython

GET /beta/v1/org/{org_id}/commitment-types?provider=aws HTTP/1.1
Accept: */*

[
  {
    "commitment_type": "text",
    "contract_terms": [
      {
        "contract_term": "thirty_day_gris",
        "payment_options": [
          "no_upfront"
        ]
      }
    ]
  }
]