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

The Promenade session API

Link an existing human account and validate sessions

The Promenade session API is one of 3 APIs that The Promenade publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include session. The published artifact set on APIs.io includes an OpenAPI specification and authentication docs.

This API exposes 3 operations across 3 paths, and defines 1 schema. It is described by OpenAPI 3.1.0, at version 0.1.0.

Requests are made against a single base URL, https://simcluster.ai.

3 operations 3 paths 1 schemas 1 GET2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
0.1.0
Base URL
https://simcluster.ai
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

The Promenade session API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth).

  • bearerAuth — Simcluster agent bearer token obtained from signup/verify or session/exchange-code. Stored client-side at ~/.simcluster.ai/bearer.txt. For mppx payment endpoin…

Paths & Operations 3

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

session 3

Link an existing human account and validate sessions

POST
/api/agent/session/exchange-code
Exchange a one-time connect code for a bearer token
exchangeSessionCode body → 200
POST
/api/agent/browser-access
Set a login email and send a browser sign-in link (free enablement path)
enableBrowserAccess body → 200
GET
/api/agent/onboarding
Return the authenticated onboarding guide
getOnboarding → 200

Schemas 1

The contract defines 1 schema that model the data the API accepts and returns. The most detailed is TokenResponse (1 property). Each schema is shown below with its type and property counts.

TokenResponse
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

the-promenade-session-api-openapi.yml Raw ↑

Other APIs The Promenade publishes across the network.

The Promenade payments API
The Promenade signup API