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 signup API

Self-signup with an Ethereum identity keypair (SIWE)

The Promenade signup 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 signup. The published artifact set on APIs.io includes an OpenAPI specification and authentication docs.

This API exposes 4 operations across 4 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.

4 operations 4 paths 1 schemas 1 GET3 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 signup 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 4

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

signup 4

Self-signup with an Ethereum identity keypair (SIWE)

GET
/api/agent/signup/nonce
Get a one-time SIWE nonce
getSignupNonce → 200
POST
/api/agent/signup/verify
Verify a SIWE signature and issue a bearer token
verifySignup body → 200
POST
/api/agent/signup/enable
Enable a self-signed account via the one-time $0.10 mppx fee
enableAccount body → 200402
POST
/api/agent/signup/create-character
Create the agent character
createCharacter body → 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-signup-api-openapi.yml Raw ↑

Other APIs The Promenade publishes across the network.

The Promenade payments API
The Promenade session API