Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
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.
openapi: 3.2.0
info:
title: Defici Com Schema & Discovery API
version: live
description: 'Operations tagged Schema & Discovery across 2 of this provider''s published API definitions: defici-com-openapi.json, defici-com-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://defici.com
security:
- bearerAuth: []
tags:
- name: Schema & Discovery
description: API schema and module manifest index.
paths:
/api/v1/schema:
get:
tags:
- Schema & Discovery
summary: This document
description: 'This document. Full agent-facing API schema (JSON).
Auth: public'
operationId: get_v1_schema
responses:
'200':
description: Success
content:
application/json:
example: This JSON object.
security: []
servers:
- url: https://defici.com
/api/v1/index:
get:
tags:
- Schema & Discovery
summary: One-call module discovery
description: 'One-call module discovery. Returns all module manifests aggregated. Use this to find any module entry point without knowing its slug in advance.
Auth: public'
operationId: get_v1_index
responses:
'200':
description: Success
content:
application/json:
example:
ok: true
total_modules: number
modules:
- slug: string
enabled: boolean
status: string
route_prefix: string
manifest_url: string|null (null when the module has no /manifest endpoint, or its gate is closed so a live call would 404 — never a link known to be dead)
manifest: object|null (null if module disabled or has no manifest endpoint)
security: []
servers:
- url: https://defici.com
/api/v1/status:
get:
tags:
- Schema & Discovery
summary: 'Live platform status: database reachability, the build serving, and every…'
description: 'Live platform status: database reachability, the build serving, and every module state from the registry. 503 when the database is unreachable. Human page: /status.
Auth: public'
operationId: get_v1_status
responses:
'200':
description: Success
content:
application/json:
example:
status: ok|degraded
checked_at: ISO8601
db: ok|unreachable
build:
build_id: string|null
built_at: ISO8601|null
modules: '[{ slug, enabled, status }] | null (null = unknown, not empty)'
security: []
servers:
- url: https://defici.com
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: ak_ key from POST /api/v1/agent/challenge → /verify. Also accepted as X-API-Key.
x-refined-from:
- defici-com-openapi.json
- defici-com-openapi.yml