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/kymaapi-com:kymaapi-com-decisions-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.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.2.0
info:
  title: Kymaapi Com Decisions API
  version: 1.0.0
  contact:
    name: Kyma API
    url: https://kymaapi.com
    email: support@kymaapi.com
  license:
    name: Proprietary
  termsOfService: https://kymaapi.com/terms
  description: 'Operations tagged Decisions across 2 of this provider''s published API definitions: kymaapi-com-openapi.json, kymaapi-com-v1-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://kymaapi.com/v1
  description: Production
security:
- BearerAuth: []
tags:
- name: Decisions
paths:
  /decisions:
    post:
      summary: Make a decision
      description: 'Ask a model to pick one option per question, with a confidence, instead of writing prose you have to parse back into a choice.


        Send the state and the questions; every question comes back with one of the options you supplied, a confidence between 0 and 1, and the probabilities across the options when the model reports them.


        Billed per input token at the model''s published rate, rounded up to the nearest $0.0001 — the smallest amount the ledger holds — with output free. `usage.cost` is the amount taken from your balance, not a number rounded again later. Failures are not charged.'
      operationId: createDecision
      tags:
      - Decisions
      security:
      - bearerAuth: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - state
              - questions
              properties:
                model:
                  type: string
                  default: jev
                  example: jev
                  description: The decisions model. `jev` is the only value today; any other returns 400.
                state:
                  type: string
                  example: 'Proposed shell command: `rm -rf ./build` in a CI job that has already published its artifacts.'
                  description: What the model is deciding about, in your own words.
                questions:
                  type: object
                  description: 'One or more questions keyed by an id you choose. Each must be a choice question: `{"type": "choice", "instructions": "…", "criteria": {"<option>": "<what it means>"}}` with at least one option.'
                  additionalProperties:
                    type: object
                    required:
                    - type
                    - criteria
                    properties:
                      type:
                        type: string
                        enum:
                        - choice
                      instructions:
                        type: string
                      criteria:
                        type: object
                        additionalProperties:
                          type: string
      responses:
        '200':
          description: One answer per question asked
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  model:
                    type: string
                    example: jev
                  answers:
                    type: object
                    additionalProperties:
                      type: object
                      properties:
                        choice:
                          type: string
                          description: Always one of the options supplied for that question.
                        confidence:
                          type: number
                          minimum: 0
                          maximum: 1
                        probabilities:
                          type: object
                          additionalProperties:
                            type: number
                  usage:
                    type: object
                    properties:
                      input_tokens:
                        type: integer
                      output_tokens:
                        type: integer
                      cost:
                        type: number
                        description: Dollars charged for this call.
        '400':
          description: Missing `state` or `questions`, a question that is not a choice question, or a `model` other than `jev`.
        '401':
          description: Missing or invalid API key.
        '402':
          description: Balance does not cover the call.
    servers:
    - url: https://kymaapi.com/v1
      description: Production
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: Kyma API key (starts with ky-) or session token (starts with ks-)
x-refined-from:
- kymaapi-com-openapi.json
- kymaapi-com-v1-openapi.json