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/apiman-actions-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: Manager REST Actions API
  description: The API Manager REST API is used by the API Manager UI to get stuff done. You can use it to automate any API Management task you wish. For example, create new Organizations, Plans, Clients, and APIs.
  version: 3.1.0-SNAPSHOT
servers:
- url: /apiman
tags:
- name: Actions
paths:
  /actions/contracts:
    post:
      tags:
      - Actions
      summary: Approve a contract
      description: Approve a contract (assuming it requires approval). If all contracts for a given Client Version have been approved, then it will transition from `AwaitingApproval` to `Ready`, and hence can be published.
      operationId: approveContract
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ContractActionDto'
      responses:
        '204':
          description: If the action completes successfully.
  /actions:
    post:
      tags:
      - Actions
      summary: Execute an Entity Action
      description: Call this endpoint in order to execute actions for apiman entities such as Plans, APIs, or Clients. The type of the action must be included in the request payload.
      operationId: performAction
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ActionBean'
      responses:
        '204':
          description: If the action completes successfully.
components:
  schemas:
    ContractActionDto:
      type: object
      properties:
        contractId:
          type: integer
          format: int64
        status:
          type: string
          enum:
          - AwaitingApproval
          - Created
          - Rejected
        rejectionReason:
          type: string
        autoPromote:
          type: boolean
    ActionBean:
      type: object
      properties:
        type:
          type: string
          enum:
          - publishAPI
          - retireAPI
          - registerClient
          - unregisterClient
          - lockPlan
        organizationId:
          type: string
        entityId:
          type: string
        entityVersion:
          type: string