Sageox Public API
Unauthenticated endpoints for public-facing data. Returns team profiles, public recording metadata, shared conventions, and repository status without requiring authentication. Rate limited per IP.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/sageox-public-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: SageOx Public API
version: 1.0.0
description: '# API Reference
## Overview
SageOx is a platform that captures team knowledge from discussions, decisions, and work context into a Ledger (per-repo historical record) and Team Context (team-wide shared knowledge).'
contact:
name: SageOx Team
license:
name: MIT
servers:
- url: http://localhost:3000
description: Devcontainer
- url: https://test.sageox.ai
description: Test
- url: https://sageox.ai
description: Production
security:
- bearerAuth: []
tags:
- name: Public
description: Unauthenticated endpoints for public-facing data. Returns team profiles, public recording metadata, shared conventions, and repository status without requiring authentication. Rate limited per IP.
paths:
/api/v1/public/repos/{repo_id}:
get:
operationId: getPublicRepo
summary: Get public repository information
description: 'Retrieves basic public information about a repository.
Does not include sensitive team information or access control details.
**Authentication:** Not required (public endpoint)
**Rate limit:** Tiered per IP (60 req/min unauthenticated, 300 req/min authenticated)'
tags:
- Public
security: []
parameters:
- in: path
name: repo_id
required: true
schema:
type: string
pattern: ^repo_[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
example: repo_01934f5a-8b9c-7def-b012-3456789abcde
description: Repository ID to retrieve
responses:
'200':
description: Repository information retrieved
content:
application/json:
schema:
type: object
required:
- id
- type
properties:
id:
type: string
example: repo_01934f5a-8b9c-7def-b012-3456789abcde
type:
type: string
enum:
- git
example: git
created_at:
type: string
format: date-time
example: '2025-12-18T10:30:00Z'
is_public:
type: boolean
example: false
'404':
description: Repository not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'500':
description: Server error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
/api/v1/public/repos/{repo_id}/merge-candidates:
get:
operationId: getRepoMergeCandidates
summary: Get repositories that could be merged
description: 'Returns a list of repositories with matching remote hashes that could be merged
into this repository. Respects `is_public` flag for fork protection.
**Use case:** Help users identify duplicate registrations that should be consolidated.
**Authentication:** Not required
**Rate limit:** Tiered per IP'
tags:
- Public
security: []
parameters:
- in: path
name: repo_id
required: true
schema:
type: string
pattern: ^repo_[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
example: repo_01934f5a-8b9c-7def-b012-3456789abcde
description: Repository ID to find merge candidates for
responses:
'200':
description: List of merge candidates
content:
application/json:
schema:
type: array
items:
type: object
properties:
repo_id:
type: string
example: repo_01934f5b-1234-7abc-9012-def456789012
team_id:
type: string
example: team_def456uvw
created_at:
type: string
format: date-time
example: '2025-12-10T08:15:00Z'
'404':
description: Repository not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'500':
description: Server error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
/api/v1/public/repos/{repo_id}/has-merge-candidates:
get:
operationId: hasRepoMergeCandidates
summary: Check if merge candidates exist
description: 'Lightweight check to determine if this repository has merge candidates.
Returns a boolean without fetching full candidate details.
**Use case:** Show UI indication of potential merges without expensive list fetch.
**Authentication:** Not required
**Rate limit:** Tiered per IP'
tags:
- Public
security: []
parameters:
- in: path
name: repo_id
required: true
schema:
type: string
pattern: ^repo_[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
example: repo_01934f5a-8b9c-7def-b012-3456789abcde
description: Repository ID to check
responses:
'200':
description: Merge candidate status determined
content:
application/json:
schema:
type: object
required:
- has_candidates
properties:
has_candidates:
type: boolean
description: Whether merge candidates exist for this repo
example: true
'404':
description: Repository not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'500':
description: Server error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
/api/v1/public/repos/{repo_id}/doctor:
get:
operationId: getRepoDoctorInfo
summary: Run repository diagnostics
description: 'Runs diagnostic checks on a repository including health status,
configuration validation, and merge analysis.
**Diagnostics included:**
- Repository status and metadata
- Team associations
- Merge candidate analysis
- Git configuration validation
- Feature availability
**Authentication:** Not required
**Rate limit:** Tiered per IP'
tags:
- Public
security: []
parameters:
- in: path
name: repo_id
required: true
schema:
type: string
pattern: ^repo_[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
example: repo_01934f5a-8b9c-7def-b012-3456789abcde
description: Repository ID to diagnose
responses:
'200':
description: Diagnostic results retrieved
content:
application/json:
schema:
type: object
properties:
repo_id:
type: string
example: repo_01934f5a-8b9c-7def-b012-3456789abcde
status:
type: string
enum:
- healthy
- degraded
- error
example: healthy
checks:
type: object
properties:
metadata_valid:
type: boolean
example: true
teams_accessible:
type: boolean
example: true
merge_analysis:
type: object
properties:
has_candidates:
type: boolean
example: true
candidate_count:
type: integer
example: 1
'404':
description: Repository not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'500':
description: Server error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
/api/v1/public/teams/{team_id}:
get:
operationId: getPublicTeam
summary: Get public team information
description: 'Retrieves basic public information about a team.
Does not include sensitive member or access control information.
**Authentication:** Not required
**Rate limit:** Tiered per IP'
tags:
- Public
security: []
parameters:
- in: path
name: team_id
required: true
schema:
type: string
pattern: ^team_
example: team_abc123xyz
description: Team ID to retrieve
responses:
'200':
description: Team information retrieved
content:
application/json:
schema:
type: object
required:
- id
- slug
- name
properties:
id:
type: string
example: team_abc123xyz
slug:
type: string
description: URL-safe team identifier
example: my-team
name:
type: string
example: My Team
created_at:
type: string
format: date-time
example: '2025-12-18T10:30:00Z'
'404':
description: Team not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'500':
description: Server error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
/api/v1/public/teams/{team_id}/repos:
get:
operationId: getTeamRepos
summary: Get team's repositories
description: 'Lists all repositories associated with a team (public view).
Does not include private or access-controlled repository details.
**Authentication:** Not required
**Rate limit:** Tiered per IP'
tags:
- Public
security: []
parameters:
- in: path
name: team_id
required: true
schema:
type: string
pattern: ^team_
example: team_abc123xyz
description: Team ID to list repositories for
responses:
'200':
description: List of team repositories
content:
application/json:
schema:
type: array
items:
type: object
properties:
repo_id:
type: string
example: repo_01934f5a-8b9c-7def-b012-3456789abcde
type:
type: string
enum:
- git
example: git
created_at:
type: string
format: date-time
example: '2025-12-18T10:30:00Z'
'404':
description: Team not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'500':
description: Server error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
/api/v1/public/teams/{team_id}/merge-candidates:
get:
operationId: getTeamMergeCandidates
summary: Get team's merge candidates
description: 'Returns repositories from this team that have merge candidates
(duplicate registrations that could be consolidated).
**Authentication:** Not required
**Rate limit:** Tiered per IP'
tags:
- Public
security: []
parameters:
- in: path
name: team_id
required: true
schema:
type: string
pattern: ^team_
example: team_abc123xyz
description: Team ID to analyze for merge candidates
responses:
'200':
description: List of repositories with merge candidates
content:
application/json:
schema:
type: array
items:
type: object
properties:
repo_id:
type: string
example: repo_01934f5a-8b9c-7def-b012-3456789abcde
merge_candidates:
type: array
items:
type: object
properties:
repo_id:
type: string
example: repo_01934f5b-1234-7abc-9012-def456789012
team_id:
type: string
example: team_def456uvw
'404':
description: Team not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'500':
description: Server error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
/api/v1/public/teams/{team_id}/info:
get:
operationId: getTeamPublicInfo
summary: Get team public info for join page
description: 'Returns information needed for team join/signup page.
Includes team name, member count, and visibility status.
**Use case:** Public join page showing team details without authentication.
**Authentication:** Not required
**Rate limit:** Tiered per IP'
tags:
- Public
security: []
parameters:
- in: path
name: team_id
required: true
schema:
type: string
pattern: ^team_
example: team_abc123xyz
description: Team ID to retrieve info for
responses:
'200':
description: Team public information retrieved
content:
application/json:
schema:
type: object
required:
- name
- slug
- member_count
properties:
name:
type: string
description: Team display name
example: Product Engineering
slug:
type: string
description: URL-safe team identifier
example: product-engineering
member_count:
type: integer
description: Number of team members
example: 12
description:
type: string
description: Team description or tagline
nullable: true
example: Building the next generation platform
'404':
description: Team not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'500':
description: Server error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
components:
schemas:
ErrorResponse:
type: object
description: Standard error response returned by all endpoints on failure.
required:
- success
- error
properties:
success:
type: boolean
description: Always `false` for error responses.
enum:
- false
error:
type: string
description: Human-readable error message describing what went wrong. Do not parse this programmatically — use HTTP status codes for control flow.
example: Invalid request parameters
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: 'JWT token obtained from the auth service (/api/auth/token).
Token is validated using JWKS from the auth service.
Required claims: sub (user_id), email, name, tier.
'