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

Wherobots service API

The service API from Wherobots — 3 operation(s) for service.

Wherobots service API is one of 34 APIs that Wherobots publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

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

This API exposes 5 operations across 3 paths, and defines 11 schemas. It is described by OpenAPI 3.1.0, at version 0.0.1.

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

5 operations 3 paths 11 schemas 1 DELETE2 GET1 PATCH1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
0.0.1
Base URL
https://api.cloud.wherobots.com
Authentication
HTTP Bearer, API Key
Resource Areas
1

Authentication & Security 2

Wherobots service API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (bearerToken). An API key is passed in the header as X-API-Key (wherobotsApiKey).

  • wherobotsApiKey — A Wherobots-generated API key

Paths & Operations 5

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

service 5
GET
/service
List service principals
listServicePrincipals → 200400401403404409422500
GET
/service/{service_id}
Get a service principal
getServicePrincipal 1 param → 200400401403404409422500
PATCH
/service/{service_id}
Update a service principal
updateServicePrincipal 1 param body → 200400401403404409422500
DELETE
/service/{service_id}
Delete a service principal
deleteServicePrincipal 1 param → 200400401403404409422500
POST
/service/register
Register a new service principal
registerServicePrincipal body → 200400401403404409422500

Schemas 11

The contract defines 11 schemas that model the data the API accepts and returns. The most detailed are ServicePrincipal (8 properties), ServicePrincipalUpdateInput (8 properties), Policy (7 properties), ErrorInfo (7 properties). Each schema is shown below with its type and property counts.

Provider
string
ServicePrincipalRegisterInput
object
1 property 1 required
ErrorInfo
object
7 properties 4 required
ServicePrincipalUpdateInput
object
8 properties
Role-Output
object
6 properties 6 required
Role-Input
object
6 properties 6 required
Effect
string
ErrorClass
string
ServicePrincipal
object
8 properties 7 required
ErrorBody
object
2 properties 2 required
Policy
object
7 properties 4 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

wherobots-service-api-openapi.yml Raw ↑

Other APIs Wherobots publishes across the network.

Wherobots apikey API
Wherobots audit-log API
Wherobots catalogs API
Wherobots cloud-connections API
Wherobots coupon API
Wherobots environment-override--preset API
Wherobots environment-preset API
Wherobots files API
Wherobots Flags API
Wherobots foreign-catalog API
Wherobots Health API
Wherobots Is Super User API