OpenShorts OAuth API

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

GitHub OpenAPI

Operations 10

POST /oauth/register Register Client #
OPTIONS /oauth/register Preflight #
GET /oauth/authorize Authorize #
GET /api/oauth/client/{client_id} Client Info #
POST /api/oauth/deny Deny #
POST /api/oauth/authorize Consent #
POST /oauth/token Token #
OPTIONS /oauth/token Preflight #
POST /oauth/revoke Revoke #
OPTIONS /oauth/revoke Preflight #

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/openshorts-app:openshorts-app-oauth-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

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

OpenAPI Specification

openshorts-app-oauth-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Fast OAuth API
  version: 0.1.0
tags:
- name: OAuth
paths:
  /oauth/register:
    post:
      summary: Register Client
      operationId: register_client_oauth_register_post
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - OAuth
    options:
      summary: Preflight
      operationId: preflight_oauth_register_options
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - OAuth
  /oauth/authorize:
    get:
      summary: Authorize
      operationId: authorize_oauth_authorize_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - OAuth
  /api/oauth/client/{client_id}:
    get:
      summary: Client Info
      description: 'What the consent screen shows: the name the client registered with.'
      operationId: client_info_api_oauth_client__client_id__get
      parameters:
      - name: client_id
        in: path
        required: true
        schema:
          type: string
          title: Client Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - OAuth
  /api/oauth/deny:
    post:
      summary: Deny
      description: 'The user said no: where to send the browser. Built here, from a

        redirect_uri registered for the client, never from the page''s own URL

        (which anyone can link to with any redirect_uri in it).'
      operationId: deny_api_oauth_deny_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DenyRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - OAuth
  /api/oauth/authorize:
    post:
      summary: Consent
      description: 'The user said yes on the dashboard: mint the code, return where to go.'
      operationId: consent_api_oauth_authorize_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConsentRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - OAuth
  /oauth/token:
    post:
      summary: Token
      operationId: token_oauth_token_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - OAuth
    options:
      summary: Preflight
      operationId: preflight_oauth_token_options
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - OAuth
  /oauth/revoke:
    post:
      summary: Revoke
      description: 'Takes an access or refresh token and revokes the OAuth connection it

        belongs to. Always 200, known token or not (RFC 7009 2.2). Only keys an

        OAuth flow minted can be revoked here: a hand-made key is managed from the

        account page, never by whoever holds it.'
      operationId: revoke_oauth_revoke_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - OAuth
    options:
      summary: Preflight
      operationId: preflight_oauth_revoke_options
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - OAuth
components:
  schemas:
    DenyRequest:
      properties:
        client_id:
          type: string
          title: Client Id
        redirect_uri:
          type: string
          title: Redirect Uri
        state:
          anyOf:
          - type: string
          - type: 'null'
          title: State
      type: object
      required:
      - client_id
      - redirect_uri
      title: DenyRequest
    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
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ConsentRequest:
      properties:
        client_id:
          type: string
          title: Client Id
        redirect_uri:
          type: string
          title: Redirect Uri
        state:
          anyOf:
          - type: string
          - type: 'null'
          title: State
        code_challenge:
          type: string
          title: Code Challenge
        code_challenge_method:
          anyOf:
          - type: string
          - type: 'null'
          title: Code Challenge Method
          default: S256
        scope:
          anyOf:
          - type: string
          - type: 'null'
          title: Scope
        response_type:
          anyOf:
          - type: string
          - type: 'null'
          title: Response Type
          default: code
      type: object
      required:
      - client_id
      - redirect_uri
      - code_challenge
      title: ConsentRequest