Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

APIs.io Engineering Platform Oauth-Authorizations API

OAuth Authorizations API

This API exposes 10 operations across 6 paths, and defines 8 schemas. It is described by OpenAPI 3.0.0, at version 2015-07-09.

Requests are made against 4 base URLs: http://apigateway.{region}.amazonaws.com, https://apigateway.{region}.amazonaws.com, http://apigateway.{region}.amazonaws.com.cn, https://apigateway.{region}.amazonaws.com.cn.

10 operations 6 paths 8 schemas 2 DELETE4 GET1 PATCH1 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
2015-07-09
Base URL
https://{bucketname}.s3.amazonaws.com
Authentication
API Key
Terms of Service
Resource Areas
1

Authentication & Security 1

APIs.io Engineering Platform Oauth-Authorizations API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (hmac). By default, every request must be authenticated.

  • hmac — Amazon Signature authorization v4

Paths & Operations 10

Across 6 paths, the API surfaces 10 operations — 2 DELETE, 4 GET, 1 PATCH, 1 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Oauth-Authorizations 10

OAuth Authorizations API

GET
/applications/grantsdeprecated
APIs.io Engineering Platform List your grants
oauth-authorizations/list-grants 3 params → 200304403401404
GET
/applications/grants/{grant_id}deprecated
APIs.io Engineering Platform Get a single grant
oauth-authorizations/get-grant 1 param → 200304403401
DELETE
/applications/grants/{grant_id}deprecated
APIs.io Engineering Platform Delete a grant
oauth-authorizations/delete-grant 1 param → 204304403401
GET
/authorizationsdeprecated
APIs.io Engineering Platform List your authorizations
oauth-authorizations/list-authorizations 3 params → 200304403401404
POST
/authorizationsdeprecated
APIs.io Engineering Platform Create a new authorization
oauth-authorizations/create-authorization body → 201422410304403401
PUT
/authorizations/clients/{client_id}deprecated
APIs.io Engineering Platform Get-or-create an authorization for a specific app
oauth-authorizations/get-or-create-authorization-for-app 1 param body → 200201422304403401
PUT
/authorizations/clients/{client_id}/{fingerprint}deprecated
APIs.io Engineering Platform Get-or-create an authorization for a specific app and fingerprint
oauth-authorizations/get-or-create-authorization-for-app-and-fingerprint 2 params body → 200201422
GET
/authorizations/{authorization_id}deprecated
APIs.io Engineering Platform Get a single authorization
oauth-authorizations/get-authorization 1 param → 200304403401
PATCH
/authorizations/{authorization_id}deprecated
APIs.io Engineering Platform Update an existing authorization
oauth-authorizations/update-authorization 1 param body → 200422
DELETE
/authorizations/{authorization_id}deprecated
APIs.io Engineering Platform Delete an authorization
oauth-authorizations/delete-authorization 1 param → 204304403401

Schemas 8

The contract defines 8 schemas that model the data the API accepts and returns. The most detailed are app-permissions (45 properties), simple-user (21 properties), nullable-simple-user (21 properties), authorization (15 properties). Each schema is shown below with its type and property counts.

nullable-simple-user
object
A GitHub user.
21 properties 18 required
basic-error
object
Basic Error
4 properties
validation-error
object
Validation Error
3 properties 2 required
nullable-scoped-installation
object
7 properties 5 required
app-permissions
object
The permissions granted to the user access token.
45 properties
simple-user
object
A GitHub user.
21 properties 18 required
authorization
object
The authorization for an OAuth app, GitHub App, or a Personal Access Token.
15 properties 13 required
application-grant
object
The authorization associated with an OAuth Access.
7 properties 6 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

engineering-platform-oauth-authorizations-api-openapi.yml Raw ↑