Balladic

Balladic OAuth API

The oauth API from Balladic — 7 operation(s) for oauth.

GitHub OpenAPI

Operations 8

POST /oauth/token Token Exchange #
POST /oauth/revoke Revoke Token #
GET /oauth/clients/{client_id}/info Get Client Info #
GET /oauth/clients List Clients #
POST /oauth/clients Create Client #
DELETE /oauth/clients/{client_id} Delete Client #
GET /oauth/grants List My Grants #
DELETE /oauth/grants/{grant_id} Revoke My Grant #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/balladic-com/openapi/balladic-com-oauth-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/balladic-com/json-schema/balladic-com-project-list-item-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/balladic-com/json-schema/balladic-com-project-detail-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/balladic-com/json-schema/balladic-com-org-billing-status-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/balladic-com/json-schema/balladic-com-task-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/balladic-com/json-schema/balladic-com-notification-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/balladic-com/json-schema/balladic-com-user-response-schema.json

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/balladic-com:balladic-com-oauth-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

balladic-com-oauth-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Balladic OAuth API
  description: Balladestreger
  version: 0.11.10
tags:
- name: OAuth
paths:
  /oauth/token:
    post:
      tags:
      - OAuth
      summary: Token Exchange
      operationId: token_exchange_oauth_token_post
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/Body_token_exchange_oauth_token_post'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /oauth/revoke:
    post:
      tags:
      - OAuth
      summary: Revoke Token
      operationId: revoke_token_oauth_revoke_post
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/Body_revoke_token_oauth_revoke_post'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /oauth/clients/{client_id}/info:
    get:
      tags:
      - OAuth
      summary: Get Client Info
      operationId: get_client_info_oauth_clients__client_id__info_get
      parameters:
      - name: client_id
        in: path
        required: true
        schema:
          type: string
          title: Client Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClientInfoResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /oauth/clients:
    get:
      tags:
      - OAuth
      summary: List Clients
      operationId: list_clients_oauth_clients_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/ClientListItem'
                type: array
                title: Response List Clients Oauth Clients Get
      security:
      - HTTPBearer: []
    post:
      tags:
      - OAuth
      summary: Create Client
      operationId: create_client_oauth_clients_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateClientRequest'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateClientResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /oauth/clients/{client_id}:
    delete:
      tags:
      - OAuth
      summary: Delete Client
      operationId: delete_client_oauth_clients__client_id__delete
      security:
      - HTTPBearer: []
      parameters:
      - name: client_id
        in: path
        required: true
        schema:
          type: string
          title: Client Id
      responses:
        '204':
          description: Successful Response
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /oauth/grants:
    get:
      tags:
      - OAuth
      summary: List My Grants
      operationId: list_my_grants_oauth_grants_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/GrantResponse'
                type: array
                title: Response List My Grants Oauth Grants Get
      security:
      - HTTPBearer: []
  /oauth/grants/{grant_id}:
    delete:
      tags:
      - OAuth
      summary: Revoke My Grant
      operationId: revoke_my_grant_oauth_grants__grant_id__delete
      security:
      - HTTPBearer: []
      parameters:
      - name: grant_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
          title: Grant Id
      responses:
        '204':
          description: Successful Response
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    Body_revoke_token_oauth_revoke_post:
      properties:
        token:
          type: string
          title: Token
        client_id:
          type: string
          title: Client Id
      type: object
      required:
      - token
      - client_id
      title: Body_revoke_token_oauth_revoke_post
    CreateClientResponse:
      properties:
        client_id:
          type: string
          title: Client Id
        client_secret:
          anyOf:
          - type: string
          - type: 'null'
          title: Client Secret
        name:
          type: string
          title: Name
        logo_uri:
          anyOf:
          - type: string
          - type: 'null'
          title: Logo Uri
        redirect_uris:
          items:
            type: string
          type: array
          title: Redirect Uris
        scopes:
          items:
            type: string
          type: array
          title: Scopes
        is_public:
          type: boolean
          title: Is Public
      type: object
      required:
      - client_id
      - client_secret
      - name
      - redirect_uris
      - scopes
      - is_public
      title: CreateClientResponse
    Body_token_exchange_oauth_token_post:
      properties:
        grant_type:
          type: string
          title: Grant Type
        code:
          anyOf:
          - type: string
          - type: 'null'
          title: Code
        redirect_uri:
          anyOf:
          - type: string
          - type: 'null'
          title: Redirect Uri
        client_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Client Id
        client_secret:
          anyOf:
          - type: string
          - type: 'null'
          title: Client Secret
        code_verifier:
          anyOf:
          - type: string
          - type: 'null'
          title: Code Verifier
        refresh_token:
          anyOf:
          - type: string
          - type: 'null'
          title: Refresh Token
      type: object
      required:
      - grant_type
      title: Body_token_exchange_oauth_token_post
    CreateClientRequest:
      properties:
        name:
          type: string
          title: Name
        logo_uri:
          anyOf:
          - type: string
          - type: 'null'
          title: Logo Uri
        redirect_uris:
          items:
            type: string
          type: array
          title: Redirect Uris
        scopes:
          items:
            type: string
          type: array
          title: Scopes
          default:
          - read
        is_public:
          type: boolean
          title: Is Public
          default: false
      type: object
      required:
      - name
      - redirect_uris
      title: CreateClientRequest
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    ClientInfoResponse:
      properties:
        name:
          type: string
          title: Name
        logo_uri:
          anyOf:
          - type: string
          - type: 'null'
          title: Logo Uri
        scopes:
          items:
            type: string
          type: array
          title: Scopes
        is_public:
          type: boolean
          title: Is Public
        redirect_uris:
          items:
            type: string
          type: array
          title: Redirect Uris
      type: object
      required:
      - name
      - scopes
      - is_public
      - redirect_uris
      title: ClientInfoResponse
    GrantResponse:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        client:
          $ref: '#/components/schemas/GrantClient'
        scopes:
          items:
            type: string
          type: array
          title: Scopes
        created_at:
          type: string
          format: date-time
          title: Created At
        last_used_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Last Used At
        expires_at:
          type: string
          format: date-time
          title: Expires At
      type: object
      required:
      - id
      - client
      - scopes
      - created_at
      - last_used_at
      - expires_at
      title: GrantResponse
    ClientListItem:
      properties:
        client_id:
          type: string
          title: Client Id
        name:
          type: string
          title: Name
        redirect_uris:
          items:
            type: string
          type: array
          title: Redirect Uris
        scopes:
          items:
            type: string
          type: array
          title: Scopes
        is_public:
          type: boolean
          title: Is Public
      type: object
      required:
      - client_id
      - name
      - redirect_uris
      - scopes
      - is_public
      title: ClientListItem
    GrantClient:
      properties:
        client_id:
          type: string
          title: Client Id
        name:
          type: string
          title: Name
        logo_uri:
          anyOf:
          - type: string
          - type: 'null'
          title: Logo Uri
      type: object
      required:
      - client_id
      - name
      title: GrantClient
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer