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/keboola-admin-vendors-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: Keboola Developer Portal Admin Vendors API
  description: 'API for the Keboola Developer Portal — vendor, app (component) and user management for Keboola Connection. Most calls authenticate with a JWT token returned by `POST /auth/login`, passed verbatim in the `Authorization` header (valid for 1 hour; refresh with `GET /auth/token`).

    '
  version: 1.0.0
servers:
- url: https://apps-api.keboola.com
  description: Production
security:
- bearerAuth: []
tags:
- name: Admin Vendors
paths:
  /admin/vendors:
    get:
      tags:
      - Admin Vendors
      summary: List vendors
      description: List all vendors. Requires an admin token.
      parameters:
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          default: 0
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 1000
      - name: filter
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: List of vendors
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Vendor'
    post:
      tags:
      - Admin Vendors
      summary: Create a vendor
      description: Create a vendor directly (admin). Requires an admin token.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - id
              - name
              - address
              - email
              properties:
                id:
                  type: string
                  description: Vendor id; used as prefix for app ids. Max length 64.
                  minLength: 3
                  maxLength: 64
                name:
                  type: string
                  maxLength: 128
                address:
                  type: string
                  maxLength: 255
                email:
                  type: string
                  format: email
                  maxLength: 128
                projectUrl:
                  type: string
                  format: uri
            example:
              id: company
              name: Company ltd.
              address: 410 Terry Ave. North, Seattle, WA
              email: info@company.com
      responses:
        '201':
          description: Vendor created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Vendor'
  /admin/vendors/{vendor}:
    patch:
      tags:
      - Admin Vendors
      summary: Update a vendor
      description: Update vendor details (admin). Requires an admin token.
      parameters:
      - name: vendor
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
              properties:
                name:
                  type: string
                address:
                  type: string
                email:
                  type: string
                type:
                  type: string
                  enum:
                  - other
                  - keboola
                projectUrl:
                  type: string
                isPublic:
                  type: boolean
                isApproved:
                  type: boolean
                isTrusted:
                  type: boolean
      responses:
        '200':
          description: Vendor updated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Vendor'
    delete:
      tags:
      - Admin Vendors
      summary: Delete a vendor
      description: Delete a vendor. Requires an admin token.
      parameters:
      - name: vendor
        in: path
        required: true
        schema:
          type: string
      responses:
        '204':
          description: Vendor deleted
  /admin/vendors/{vendor}/approve:
    post:
      tags:
      - Admin Vendors
      summary: Approve vendor
      description: Approve a vendor, optionally renaming its id. Requires an admin token.
      parameters:
      - name: vendor
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                newId:
                  type: string
                  maxLength: 32
                  description: New vendor id, if you want to rename the current temporary id.
            example:
              newId: vendor
      responses:
        '204':
          description: Vendor approved
components:
  schemas:
    Vendor:
      type: object
      additionalProperties: true
      properties:
        id:
          type: string
        name:
          type: string
        address:
          type: string
        email:
          type: string
          format: email
        isPublic:
          type: boolean
        isApproved:
          type: boolean
  securitySchemes:
    bearerAuth:
      type: apiKey
      in: header
      name: Authorization
      description: 'JWT token from `POST /auth/login`, passed verbatim (no "Bearer " prefix). Admin endpoints require a token belonging to an administrator.

        '