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 Codebase Findings API

The Codebase Findings API from ReasonBlocks — 5 operation(s) for codebase findings.

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

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

This API exposes 8 operations across 5 paths, and defines 11 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.

8 operations 5 paths 11 schemas 2 DELETE2 GET1 PATCH3 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 Codebase Findings API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (HTTPBearer).

Paths & Operations 8

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

Codebase Findings 8
POST
/v1/findings/{codebase_id}
Store Finding
store_finding_v1_findings__codebase_id__post 2 params body → 200422
GET
/v1/findings/{codebase_id}
List Findings
list_findings_v1_findings__codebase_id__get 2 params → 200422
DELETE
/v1/findings/{codebase_id}
Clear Findings
clear_findings_v1_findings__codebase_id__delete 2 params → 200422
POST
/v1/findings/{codebase_id}/search
Search Findings
search_findings_v1_findings__codebase_id__search_post 2 params body → 200422
DELETE
/v1/findings/{codebase_id}/{finding_id}
Delete Finding
delete_finding_v1_findings__codebase_id___finding_id__delete 3 params → 200422
PATCH
/v1/findings/{codebase_id}/{finding_id}
Patch Finding
patch_finding_v1_findings__codebase_id___finding_id__patch 3 params body → 200422
POST
/v1/findings/{codebase_id}/invalidate
Invalidate Findings
invalidate_findings_v1_findings__codebase_id__invalidate_post 2 params body → 200422
GET
/v1/findings
List Codebases
list_codebases_v1_findings_get 3 params → 200422

Schemas 11

The contract defines 11 schemas that model the data the API accepts and returns. The most detailed are ValidationError (5 properties), FindingStoreRequest (4 properties), FindingSearchRequest (3 properties), FindingPatch (3 properties). Each schema is shown below with its type and property counts.

ValidationError
object
5 properties 3 required
FindingListResponse
object
2 properties
HTTPValidationError
object
1 property
FindingSearchResponse
object
1 property
FindingSearchRequest
object
Body for POST /findings/{codebaseid}/search -- semantic recall query.
3 properties 1 required
FindingInvalidateResponse
object
1 property
FindingStoreResponse
object
2 properties
FindingPatch
object
3 properties
FindingStoreRequest
object
Body for POST /findings/{codebaseid} -- one finding to persist.
4 properties 1 required
FindingInvalidateRequest
object
Invalidate cached findings whose filepath matches one of the listed paths.
1 property
CodebaseListResponse
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

reasonblocks-codebase-findings-api-openapi.yml Raw ↑

Other APIs ReasonBlocks publishes across the network.

ReasonBlocks Billing API
ReasonBlocks Health API
ReasonBlocks monitor API
ReasonBlocks Monitor Telemetry API
ReasonBlocks Monitors API
ReasonBlocks Pattern Library API
ReasonBlocks Patterns & Traces API
ReasonBlocks Scoring API