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

ReasonBlocks Patterns & Traces API

The Patterns & Traces API from ReasonBlocks — 2 operation(s) for patterns & traces.

ReasonBlocks Patterns & Traces API is one of 9 APIs that ReasonBlocks publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Patterns & Traces. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and a getting-started guide.

This API exposes 2 operations across 2 paths, and defines 10 schemas. It is described by OpenAPI 3.1.0, at version 0.1.0.

Requests are made against the base URL https://rb-api.reasonblocks.com.

2 operations 2 paths 10 schemas 2 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://rb-api.reasonblocks.com
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

ReasonBlocks Patterns & Traces API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (HTTPBearer).

Paths & Operations 2

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

Patterns & Traces 2
POST
/v1/traces/retrieve
Retrieve Traces
retrieve_traces_v1_traces_retrieve_post 1 param body → 200422
POST
/v1/traces
Store Trace
store_trace_v1_traces_post 1 param body → 200422

Schemas 10

The contract defines 10 schemas that model the data the API accepts and returns. The most detailed are TraceCallRecord (13 properties), TraceManifest (10 properties), ETraceItem (9 properties), StepPayload (8 properties). Each schema is shown below with its type and property counts.

InjectedPattern
object
One pattern the SDK injected during a call.
3 properties 2 required
ValidationError
object
5 properties 3 required
TraceCallRecord
object
One LLM call inside a session, as captured by the SDK middleware. messages is a small JSON-friendly projection of the LangChain messages sent to the model, not…
13 properties 1 required
TraceRetrieveRequest
object
Retrieval query. level (legacy) and tier are accepted interchangeably — the SDK and the server both normalize to lowercase e1/e2/e3. tier is the preferred fiel…
7 properties 1 required
HTTPValidationError
object
1 property
TraceStoreRequest
object
POST /traces body. Two supported shapes: Legacy: traceid + steps + outcome. Returns 200. v2 (trace collection): manifest + calls. Returns 202; storage + distil…
5 properties
StepPayload
object
Legacy per-step shape posted by storetrace (pre-v2).
8 properties 1 required
ETraceItem
object
One retrieved pattern. The SDK treats fields as the source of truth and feeds it to reasonblocks.formatrouting.renderpattern(tier, model, fields). The legacy i…
9 properties 1 required
TraceManifest
object
Session-level manifest the SDK sends with the per-call records.
10 properties 1 required
TraceRetrieveResponse
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

reasonblocks-patterns-traces-api-openapi.yml Raw ↑

Other APIs ReasonBlocks publishes across the network.

ReasonBlocks Billing API
ReasonBlocks Codebase Findings API
ReasonBlocks Health API
ReasonBlocks monitor API
ReasonBlocks Monitor Telemetry API
ReasonBlocks Monitors API
ReasonBlocks Pattern Library API
ReasonBlocks Scoring API