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

Revelator Account API

Partner account signup, login, switching, and permissions.

Revelator Account API is one of 8 APIs that Revelator publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Account. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 6 operations across 6 paths, and defines 3 schemas. It is described by OpenAPI 3.0.1, at version 1.0.

Requests are made against a single base URL, https://api.revelator.com.

6 operations 6 paths 3 schemas 2 GET4 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
1.0
Base URL
https://api.revelator.com
Authentication
HTTP Bearer
Terms of Service
Resource Areas
1

Authentication & Security 1

Revelator Account API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — Access token obtained from POST /partner/account/login (or /account/login/as), sent as 'Authorization: Bearer '. Tokens are valid for 8 hours.

Paths & Operations 6

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

Account 6

Partner account signup, login, switching, and permissions.

POST
/partner/account/signup
Create a new child account and user.
partnerAccountSignup body → 200
POST
/partner/account/login
Authenticate a user and obtain an access token.
partnerAccountLogin body → 200
POST
/partner/account/upgrade
Upgrade an account type or settings.
partnerAccountUpgrade → 200
POST
/account/login/as
Switch authentication context to a different enterprise.
accountLoginAs → 200
GET
/account/permissions
Retrieve the list of accessible accounts.
getAccountPermissions → 200
GET
/enterprise/clients/{enterpriseId}
Retrieve client information for an enterprise.
getEnterpriseClients 1 param → 200

Schemas 3

The contract defines 3 schemas that model the data the API accepts and returns. The most detailed are LoginRequest (4 properties), SignupRequest (3 properties), AuthToken (3 properties). Each schema is shown below with its type and property counts.

AuthToken
object
3 properties
LoginRequest
object
4 properties 1 required
SignupRequest
object
3 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

revelator-account-api-openapi.yml Raw ↑

Other APIs Revelator publishes across the network.

Revelator Accounting API
Revelator Analytics API
Revelator Distribution API
Revelator Integrations API
Revelator Lookup API
Revelator Revenue API
Revelator Royalty Tokens API