How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Vertesia OAuth Providers API

OAuth Provider endpoints manage project-scoped OAuth providers and the associated authorization flows and token lifecycle.

Vertesia OAuth Providers API is one of 48 APIs that Vertesia publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 6 JSON Schema definitions.

Tagged areas include OAuth Providers. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

This API exposes 11 operations across 8 paths, and defines 10 schemas. It is described by OpenAPI 3.2.0, at version 1.6.0-dev.20261019.172735Z.

Requests are made against a single base URL, https://api.{region}.vertesia.io/api/v1.

11 operations 8 paths 10 schemas 2 DELETE4 GET4 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.6.0-dev.20261019.172735Z
Base URL
https://api.us1.vertesia.io/api/v1
Authentication
HTTP Bearer, OAuth 2.0
Contact
License
Apache-2.0
Resource Areas
1

Authentication & Security 2

Vertesia OAuth Providers API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). It supports OAuth 2.0 (OAuth2) using the authorizationCode flow, exposing 33 scopes.

Paths & Operations 11

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

OAuth Providers 11

OAuth Provider endpoints manage project-scoped OAuth providers and the associated authorization flows and token lifecycle.

GET
/oauth-providers
List OAuth providers
ListOAuthProviders 1 param → 2005004XX
POST
/oauth-providers
Create an OAuth provider
CreateOAuthProvider 1 param body → 2005004XX
GET
/oauth-providers/{id}
Retrieve an OAuth provider
GetOAuthProvider 2 params → 2005004XX
PUT
/oauth-providers/{id}
Update an OAuth provider
UpdateOAuthProvider 2 params body → 2005004XX
DELETE
/oauth-providers/{id}
Delete an OAuth provider
DeleteOAuthProvider 2 params → 2005004XX
GET
/oauth-providers/{id}/authorize
Initiate OAuth provider authorization
AuthorizeOAuthProvider 2 params → 2005004XX
POST
/oauth-providers/exchange
Exchange OAuth provider authorization code
ExchangeOAuthProviderCode 1 param body → 2005004XX
GET
/oauth-providers/{id}/status
Get OAuth provider status
GetOAuthProviderStatus 2 params → 2005004XX
POST
/oauth-providers/{id}/connect
Connect an OAuth provider
ConnectOAuthProvider 2 params → 2005004XX
POST
/oauth-providers/{id}/token
Get an OAuth provider token
GetOAuthProviderToken 2 params → 2005004XX
DELETE
/oauth-providers/{id}/disconnect
Disconnect an OAuth provider
DisconnectOAuthProvider 2 params → 2005004XX

Schemas 10

The contract defines 10 schemas that model the data the API accepts and returns. The most detailed are OAuthProvider (14 properties), UpdateOAuthProviderPayload (10 properties), CreateOAuthProviderPayload (10 properties), ErrorResponse (5 properties). Each schema is shown below with its type and property counts.

OAuthProviderArray
array
OAuthProvider
object
OAuth Provider as returned by the API (with id).
14 properties 8 required
OAuthProviderAccessTokenResponse
object
1 property 1 required
CreateOAuthProviderPayload
object
Payload for creating an OAuth Provider. The clientsecret is accepted as plaintext on create and stored encrypted.
10 properties 3 required
SuccessResponse
object
1 property 1 required
OAuthProviderExchangePayload
object
2 properties 2 required
OAuthProviderAuthStatus
object
OAuth authentication status for a user against an OAuth Provider.
5 properties 3 required
OAuthProviderAuthorizeResponse
object
Response from the OAuth authorize endpoint. For authorizationcode flow: contains authorizationurl and state for browser redirect. For clientcredentials flow: c…
3 properties
UpdateOAuthProviderPayload
object
Payload for updating an OAuth Provider. All fields are optional — only provided fields are updated. To clear the clientsecret, set it to an empty string.
10 properties
ErrorResponse
object
Standard JSON error response returned by the server error handler.
5 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

vertesiahq-oauth-providers-api-openapi.yml Raw ↑

Other APIs Vertesia publishes across the network.

Vertesia Access Control Entries API
Vertesia Account API
Vertesia Accounts API
Vertesia Agent Runs API
Vertesia API Keys API
Vertesia Apps API
Vertesia Audit Trail API
Vertesia Bulk Operations API
Vertesia Collections API
Vertesia Commands API
Vertesia Content Object Types API
Vertesia Content Query API
Where this information came from

This is an independent, third-party profile of Vertesia OAuth Providers API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.