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

Radicle Source API

Commits, trees, blobs and READMEs

Radicle Source API is one of 7 APIs that Radicle publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

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

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

Requests are made against 2 base URLs: https://seed.radicle.xyz/api/v1, https://{node}/api/v1.

5 operations 5 paths 4 schemas 5 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
6.1.0
Base URL
https://seed.radicle.xyz/api/v1
Contact
License
MIT OR Apache-2.0
Resource Areas
1

Paths & Operations 5

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

Source 5

Commits, trees, blobs and READMEs

GET
/repos/{rid}/commits
List commits
listCommits 6 params → 200
GET
/repos/{rid}/commits/{sha}
Get a commit
getCommit 2 params → 200404
GET
/repos/{rid}/tree/{sha}/{path}
Get a source tree
getTree 3 params → 200400
GET
/repos/{rid}/blob/{sha}/{path}
Get a file blob
getBlob 3 params → 200400
GET
/repos/{rid}/readme/{sha}
Get the repository README at a revision
getReadme 2 params → 200400

Schemas 4

The contract defines 4 schemas that model the data the API accepts and returns. The most detailed are Commit (6 properties), Blob (5 properties), Tree (4 properties), Error (2 properties). Each schema is shown below with its type and property counts.

Blob
object
5 properties
Commit
object
6 properties
Tree
object
4 properties
Error
object
Error envelope returned by radicle-httpd.
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

radicle-source-api-openapi.yml Raw ↑

Other APIs Radicle publishes across the network.

Radicle Issues API
Radicle Node API
Radicle Patches API
Radicle Repositories API
Radicle Service API
Radicle Stats API