This repository has been archived on 2026-11-17. You can view files and clone it, but cannot push or open issues or pull requests.
caelum0x 49b183818c Unify gitgram + aitimemachine into the monorepo (de-submodule) and merge vendored engines
Convert gitgram/ and aitimemachine/ from embedded git repos (which showed as
opaque submodule gitlinks on GitHub) into fully-tracked first-party content.

AITM now merges its 7 vendored repos as first-party engines:
- memory: beads (Go task DAG) + context7 (docs SDK), unified into saved_contexts
- git: vendored C git (bundled binary) + gitnexus (in-process code intelligence)
- agentic: a2a (@a2a-js/sdk) + pal (AITM-managed Python subprocess)

Includes the full session's product build: Gitgram web/mobile/backend features,
AITM website/CLI/MCP, the unified memory layer, engine build tooling
(scripts/build-engines.sh, Dockerfile, CI), docs (README, ENGINES.md, ARCHITECTURE.md),
and extensive test suites.

Build artifacts, node_modules, external/, and gemini-cli are gitignored.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-23 14:14:09 +03:00

2482 lines
61 KiB
YAML

openapi: 3.1.0
info:
title: AITimeMachine API
description: Cloud sync, checkpoint management, and AI development time-travel API.
version: 1.0.0
contact:
name: AITimeMachine Team
servers:
- url: /v1
description: V1 API (primary)
- url: /api
description: Legacy API (backwards compatibility)
security:
- ApiKeyAuth: []
components:
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: Authorization
description: "Bearer token using an aitm_ prefixed API key"
schemas:
Error:
type: object
properties:
error:
type: string
required: [error]
Success:
type: object
properties:
success:
type: boolean
Pagination:
type: object
properties:
limit:
type: integer
offset:
type: integer
hasMore:
type: boolean
Project:
type: object
properties:
id:
type: string
name:
type: string
rootPath:
type: string
userId:
type: string
lastSyncedAt:
type: string
format: date-time
createdAt:
type: string
format: date-time
updatedAt:
type: string
format: date-time
Checkpoint:
type: object
properties:
id:
type: string
projectId:
type: string
userId:
type: string
parentId:
type: string
name:
type: string
description:
type: string
scope:
type: string
manifestHash:
type: string
rootTreeHash:
type: string
triggerType:
type: string
linkedCheckpointId:
type: string
createdAt:
type: string
format: date-time
metadata:
type: object
Blob:
type: object
properties:
hash:
type: string
userId:
type: string
size:
type: integer
mimeType:
type: string
content:
type: string
description: Base64 encoded content
storageType:
type: string
ChatSession:
type: object
properties:
id:
type: string
projectId:
type: string
userId:
type: string
tool:
type: string
startedAt:
type: string
format: date-time
endedAt:
type: string
format: date-time
metadata:
type: object
ChatMessage:
type: object
properties:
id:
type: string
sessionId:
type: string
projectId:
type: string
role:
type: string
enum: [user, assistant, system]
content:
type: string
timestamp:
type: string
format: date-time
AuditLog:
type: object
properties:
id:
type: string
action:
type: string
resourceType:
type: string
resourceId:
type: string
ipAddress:
type: string
userAgent:
type: string
metadata:
type: object
createdAt:
type: string
format: date-time
ApiKey:
type: object
properties:
id:
type: string
name:
type: string
keyPrefix:
type: string
scopes:
type: array
items:
type: string
expiresAt:
type: string
format: date-time
allowedIps:
type: array
items:
type: string
lastUsedAt:
type: string
format: date-time
createdAt:
type: string
format: date-time
status:
type: string
enum: [active, revoked, expired]
Webhook:
type: object
properties:
id:
type: string
url:
type: string
events:
type: array
items:
type: string
isActive:
type: boolean
createdAt:
type: string
format: date-time
lastTriggeredAt:
type: string
format: date-time
failureCount:
type: integer
Organization:
type: object
properties:
id:
type: string
name:
type: string
slug:
type: string
ownerId:
type: string
plan:
type: string
createdAt:
type: string
format: date-time
updatedAt:
type: string
format: date-time
Consent:
type: object
properties:
id:
type: string
consentType:
type: string
enum: [operational_capture, training_export]
granted:
type: boolean
projectId:
type: string
organizationId:
type: string
grantedByUserId:
type: string
effectiveFrom:
type: string
format: date-time
effectiveTo:
type: string
format: date-time
metadata:
type: object
createdAt:
type: string
format: date-time
RetentionPolicy:
type: object
properties:
id:
type: string
dataClass:
type: string
retentionDays:
type: integer
hardDelete:
type: boolean
projectId:
type: string
organizationId:
type: string
createdAt:
type: string
format: date-time
updatedAt:
type: string
format: date-time
TreeEntry:
type: object
properties:
hash:
type: string
parentPath:
type: string
entries:
type: array
items:
type: object
ExportJob:
type: object
properties:
id:
type: string
status:
type: string
enum: [pending, processing, completed, failed]
type:
type: string
enum: [training, analytics, full]
format:
type: string
createdAt:
type: string
format: date-time
completedAt:
type: string
format: date-time
downloadUrl:
type: string
stats:
type: object
error:
type: string
paths:
# ===========================================================================
# Health
# ===========================================================================
/health:
get:
tags: [Health]
summary: Basic health check
security: []
operationId: getHealth
responses:
"200":
description: Server is healthy
content:
application/json:
schema:
type: object
properties:
status:
type: string
timestamp:
type: string
version:
type: string
uptime:
type: number
uptimeFormatted:
type: string
/health/live:
get:
tags: [Health]
summary: Liveness probe
security: []
operationId: getHealthLive
responses:
"200":
description: Process is running
/health/ready:
get:
tags: [Health]
summary: Readiness probe (checks DB connectivity)
security: []
operationId: getHealthReady
responses:
"200":
description: Server is ready to accept traffic
"503":
description: Server is not ready
# ===========================================================================
# Auth
# ===========================================================================
/v1/auth/me:
get:
tags: [Auth]
summary: Get authenticated user info
operationId: getAuthMe
responses:
"200":
description: Authenticated user info
content:
application/json:
schema:
type: object
properties:
userId:
type: string
email:
type: string
plan:
type: string
# ===========================================================================
# API Keys
# ===========================================================================
/v1/keys:
get:
tags: [Keys]
summary: List all API keys
operationId: listKeys
responses:
"200":
description: List of API keys
content:
application/json:
schema:
type: object
properties:
keys:
type: array
items:
$ref: "#/components/schemas/ApiKey"
total:
type: integer
post:
tags: [Keys]
summary: Create a new API key
operationId: createKey
requestBody:
content:
application/json:
schema:
type: object
properties:
name:
type: string
scopes:
type: array
items:
type: string
expiresAt:
type: string
format: date-time
allowedIps:
type: array
items:
type: string
responses:
"201":
description: API key created (key shown only once)
/v1/keys/{id}:
get:
tags: [Keys]
summary: Get API key details
operationId: getKey
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
"200":
description: API key details
"404":
description: Key not found
delete:
tags: [Keys]
summary: Revoke an API key
operationId: revokeKey
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
"200":
description: Key revoked
"404":
description: Key not found
patch:
tags: [Keys]
summary: Update API key metadata (name, expiration, IPs)
operationId: updateKey
parameters:
- name: id
in: path
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
type: object
properties:
name:
type: string
expiresAt:
type: string
format: date-time
allowedIps:
type: array
items:
type: string
responses:
"200":
description: Key updated
/v1/keys/{id}/scopes:
patch:
tags: [Keys]
summary: Update API key scopes
operationId: updateKeyScopes
parameters:
- name: id
in: path
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
type: object
required: [scopes]
properties:
scopes:
type: array
items:
type: string
responses:
"200":
description: Scopes updated
/v1/keys/scopes/available:
get:
tags: [Keys]
summary: List available scopes
operationId: listAvailableScopes
responses:
"200":
description: Available scopes
# ===========================================================================
# Sessions
# ===========================================================================
/v1/sessions:
get:
tags: [Sessions]
summary: List active sessions
operationId: listSessions
responses:
"200":
description: List of sessions
/v1/sessions/{id}:
delete:
tags: [Sessions]
summary: Delete a session
operationId: deleteSession
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
"200":
description: Session deleted
/v1/sessions/cleanup:
post:
tags: [Sessions]
summary: Cleanup expired sessions
operationId: cleanupSessions
responses:
"200":
description: Sessions cleaned up
# ===========================================================================
# Audit
# ===========================================================================
/v1/audit:
get:
tags: [Audit]
summary: List audit logs with filtering and pagination
operationId: listAuditLogs
parameters:
- name: action
in: query
schema:
type: string
- name: resource_type
in: query
schema:
type: string
- name: resource_id
in: query
schema:
type: string
- name: start_date
in: query
schema:
type: string
- name: end_date
in: query
schema:
type: string
- name: limit
in: query
schema:
type: integer
default: 50
- name: offset
in: query
schema:
type: integer
default: 0
responses:
"200":
description: Paginated list of audit logs
content:
application/json:
schema:
type: object
properties:
logs:
type: array
items:
$ref: "#/components/schemas/AuditLog"
pagination:
$ref: "#/components/schemas/Pagination"
/v1/audit/summary:
get:
tags: [Audit]
summary: Get audit activity summary
operationId: getAuditSummary
parameters:
- name: days
in: query
schema:
type: integer
default: 30
responses:
"200":
description: Audit activity summary
/v1/audit/actions:
get:
tags: [Audit]
summary: List available audit action types
operationId: listAuditActions
responses:
"200":
description: Available audit action types
/v1/audit/{logId}:
get:
tags: [Audit]
summary: Get a specific audit log entry
operationId: getAuditLog
parameters:
- name: logId
in: path
required: true
schema:
type: string
responses:
"200":
description: Audit log entry
"404":
description: Log not found
# ===========================================================================
# Sync
# ===========================================================================
/v1/sync/projects:
post:
tags: [Sync]
summary: Sync a project
operationId: syncProject
requestBody:
required: true
content:
application/json:
schema:
type: object
required: [id, name]
properties:
id:
type: string
name:
type: string
rootPath:
type: string
responses:
"200":
description: Project synced
/v1/sync/checkpoints:
post:
tags: [Sync]
summary: Sync a checkpoint
operationId: syncCheckpoint
requestBody:
required: true
content:
application/json:
schema:
type: object
required: [id, projectId, name, manifestHash]
properties:
id:
type: string
projectId:
type: string
parentId:
type: string
name:
type: string
description:
type: string
scope:
type: string
manifestHash:
type: string
rootTreeHash:
type: string
triggerType:
type: string
linkedCheckpointId:
type: string
createdAt:
type: string
metadata:
type: object
files:
type: array
items:
type: object
properties:
path:
type: string
hash:
type: string
size:
type: number
mode:
type: number
responses:
"200":
description: Checkpoint synced
/v1/sync/checkpoints/batch:
post:
tags: [Sync]
summary: Batch sync checkpoints
operationId: batchSyncCheckpoints
requestBody:
required: true
content:
application/json:
schema:
type: object
required: [checkpoints]
properties:
checkpoints:
type: array
items:
type: object
responses:
"200":
description: Batch sync results
/v1/sync/blobs:
post:
tags: [Sync]
summary: Sync a blob (file content)
operationId: syncBlob
requestBody:
required: true
content:
application/json:
schema:
type: object
required: [hash, size, content]
properties:
hash:
type: string
size:
type: integer
mimeType:
type: string
content:
type: string
description: Base64 encoded
responses:
"200":
description: Blob synced
/v1/sync/blobs/check:
post:
tags: [Sync]
summary: Check which blobs already exist
operationId: checkBlobs
requestBody:
required: true
content:
application/json:
schema:
type: object
required: [hashes]
properties:
hashes:
type: array
items:
type: string
responses:
"200":
description: Existing and missing blob hashes
/v1/sync/sessions:
post:
tags: [Sync]
summary: Sync a chat session
operationId: syncSession
requestBody:
required: true
content:
application/json:
schema:
type: object
required: [id, projectId, tool]
properties:
id:
type: string
projectId:
type: string
tool:
type: string
startedAt:
type: string
endedAt:
type: string
metadata:
type: object
responses:
"200":
description: Session synced
/v1/sync/messages:
post:
tags: [Sync]
summary: Sync a chat message
operationId: syncMessage
requestBody:
required: true
content:
application/json:
schema:
type: object
required: [sessionId, projectId, role, content]
properties:
sessionId:
type: string
projectId:
type: string
checkpointId:
type: string
role:
type: string
enum: [user, assistant, system]
content:
type: string
contentHash:
type: string
isContextInjection:
type: boolean
timestamp:
type: string
metadata:
type: object
responses:
"200":
description: Message synced
/v1/sync/messages/batch:
post:
tags: [Sync]
summary: Batch sync messages
operationId: batchSyncMessages
responses:
"200":
description: Batch sync results
/v1/sync/tool-calls:
post:
tags: [Sync]
summary: Sync a tool call
operationId: syncToolCall
responses:
"200":
description: Tool call synced
/v1/sync/terminal-events:
post:
tags: [Sync]
summary: Sync a terminal event
operationId: syncTerminalEvent
responses:
"200":
description: Terminal event synced
/v1/sync/events:
post:
tags: [Sync]
summary: Sync a generic event
operationId: syncEvent
responses:
"200":
description: Event synced
/v1/sync/quota:
get:
tags: [Sync]
summary: Get current storage quota and usage
operationId: getQuota
responses:
"200":
description: Storage quota info
/v1/sync/quota/recalculate:
post:
tags: [Sync]
summary: Recalculate storage usage
operationId: recalculateQuota
responses:
"200":
description: Quota recalculated
# ===========================================================================
# Restore
# ===========================================================================
/v1/restore/projects:
get:
tags: [Restore]
summary: List user projects
operationId: listProjects
responses:
"200":
description: List of projects
/v1/restore/projects/{projectId}:
get:
tags: [Restore]
summary: Get project details
operationId: getProject
parameters:
- name: projectId
in: path
required: true
schema:
type: string
responses:
"200":
description: Project details
"404":
description: Project not found
/v1/restore/projects/{projectId}/checkpoints:
get:
tags: [Restore]
summary: List checkpoints for a project
operationId: listCheckpoints
parameters:
- name: projectId
in: path
required: true
schema:
type: string
- name: limit
in: query
schema:
type: integer
default: 50
- name: offset
in: query
schema:
type: integer
default: 0
responses:
"200":
description: List of checkpoints
/v1/restore/projects/{projectId}/checkpoints/last-green:
get:
tags: [Restore]
summary: Find last passing checkpoint
operationId: getLastGreenCheckpoint
parameters:
- name: projectId
in: path
required: true
schema:
type: string
responses:
"200":
description: Last green checkpoint
"404":
description: No green checkpoint found
/v1/restore/projects/{projectId}/checkpoints/{checkpointId}:
get:
tags: [Restore]
summary: Get checkpoint details
operationId: getCheckpoint
parameters:
- name: projectId
in: path
required: true
schema:
type: string
- name: checkpointId
in: path
required: true
schema:
type: string
responses:
"200":
description: Checkpoint details
"404":
description: Checkpoint not found
/v1/restore/projects/{projectId}/checkpoints/{checkpointId}/manifest:
get:
tags: [Restore]
summary: Get checkpoint manifest for restore
operationId: getCheckpointManifest
parameters:
- name: projectId
in: path
required: true
schema:
type: string
- name: checkpointId
in: path
required: true
schema:
type: string
responses:
"200":
description: Checkpoint with manifest
/v1/restore/projects/{projectId}/checkpoints/{checkpointId}/full:
get:
tags: [Restore]
summary: Full context restore (checkpoint + messages + terminal events)
operationId: getFullRestore
parameters:
- name: projectId
in: path
required: true
schema:
type: string
- name: checkpointId
in: path
required: true
schema:
type: string
- name: includeMessages
in: query
schema:
type: string
default: "true"
- name: messageLimit
in: query
schema:
type: string
default: "20"
responses:
"200":
description: Full restore data
/v1/restore/blobs/{hash}:
get:
tags: [Restore]
summary: Get a blob by hash
operationId: getBlob
parameters:
- name: hash
in: path
required: true
schema:
type: string
responses:
"200":
description: Blob content
"404":
description: Blob not found
/v1/restore/blobs/batch:
post:
tags: [Restore]
summary: Batch get blobs
operationId: batchGetBlobs
requestBody:
required: true
content:
application/json:
schema:
type: object
required: [hashes]
properties:
hashes:
type: array
items:
type: string
responses:
"200":
description: Batch blob results
/v1/restore/projects/{projectId}/sessions:
get:
tags: [Restore]
summary: List chat sessions for a project
operationId: listProjectSessions
parameters:
- name: projectId
in: path
required: true
schema:
type: string
responses:
"200":
description: List of sessions
/v1/restore/projects/{projectId}/sessions/{sessionId}/messages:
get:
tags: [Restore]
summary: Get messages for a session
operationId: getSessionMessages
parameters:
- name: projectId
in: path
required: true
schema:
type: string
- name: sessionId
in: path
required: true
schema:
type: string
responses:
"200":
description: List of messages
/v1/restore/projects/{projectId}/messages:
get:
tags: [Restore]
summary: Get recent messages for a project
operationId: getProjectMessages
parameters:
- name: projectId
in: path
required: true
schema:
type: string
responses:
"200":
description: List of messages
/v1/restore/projects/{projectId}/tool-calls:
get:
tags: [Restore]
summary: Get tool calls for a project
operationId: getProjectToolCalls
parameters:
- name: projectId
in: path
required: true
schema:
type: string
responses:
"200":
description: List of tool calls
/v1/restore/projects/{projectId}/terminal-events:
get:
tags: [Restore]
summary: Get terminal events for a project
operationId: getProjectTerminalEvents
parameters:
- name: projectId
in: path
required: true
schema:
type: string
responses:
"200":
description: List of terminal events
# ===========================================================================
# Time (Advanced Restore)
# ===========================================================================
/v1/time/restore:
post:
tags: [Time]
summary: Restore to a checkpoint (project/folder/file scope)
operationId: timeRestore
requestBody:
required: true
content:
application/json:
schema:
type: object
required: [projectId]
properties:
projectId:
type: string
checkpointId:
type: string
restoreTime:
type: string
format: date-time
scopeType:
type: string
enum: [project, folder, file]
default: project
scopePath:
type: string
includeContext:
type: boolean
default: true
messageLimit:
type: integer
default: 50
responses:
"200":
description: Restore result
"404":
description: Project or checkpoint not found
/v1/time/restore-file:
post:
tags: [Time]
summary: Restore a single file
operationId: timeRestoreFile
responses:
"200":
description: File restore result
/v1/time/restore-folder:
post:
tags: [Time]
summary: Restore a folder
operationId: timeRestoreFolder
responses:
"200":
description: Folder restore result
/v1/time/undo:
post:
tags: [Time]
summary: Undo the last action
operationId: timeUndo
requestBody:
required: true
content:
application/json:
schema:
type: object
required: [projectId]
properties:
projectId:
type: string
includeContext:
type: boolean
default: true
messageLimit:
type: integer
default: 50
responses:
"200":
description: Undo result
/v1/time/preview:
post:
tags: [Time]
summary: Preview diff between checkpoints
operationId: timePreview
responses:
"200":
description: Preview diff results
/v1/time/restore-preview:
post:
tags: [Time]
summary: Detailed restore preview without executing
operationId: timeRestorePreview
responses:
"200":
description: Detailed restore preview
/v1/time/diff:
get:
tags: [Time]
summary: Get diff between checkpoints
operationId: timeDiff
parameters:
- name: projectId
in: query
required: true
schema:
type: string
- name: toCheckpointId
in: query
required: true
schema:
type: string
- name: fromCheckpointId
in: query
schema:
type: string
- name: scopeType
in: query
schema:
type: string
enum: [project, folder, file]
- name: scopePath
in: query
schema:
type: string
responses:
"200":
description: Diff results
/v1/time/timeline:
get:
tags: [Time]
summary: Get checkpoint timeline
operationId: timeTimeline
parameters:
- name: projectId
in: query
required: true
schema:
type: string
- name: triggerType
in: query
schema:
type: string
- name: from
in: query
schema:
type: string
format: date-time
- name: to
in: query
schema:
type: string
format: date-time
- name: limit
in: query
schema:
type: integer
default: 50
- name: offset
in: query
schema:
type: integer
default: 0
responses:
"200":
description: Timeline entries
/v1/time/restore-events:
get:
tags: [Time]
summary: List restore events
operationId: timeRestoreEvents
parameters:
- name: projectId
in: query
required: true
schema:
type: string
responses:
"200":
description: List of restore events
# ===========================================================================
# Actions (Before/After)
# ===========================================================================
/v1/actions/before:
post:
tags: [Actions]
summary: Create a before-action checkpoint
operationId: beforeAction
requestBody:
required: true
content:
application/json:
schema:
type: object
required: [projectId, sessionId, action]
properties:
projectId:
type: string
sessionId:
type: string
action:
type: string
args:
type: object
message:
type: object
properties:
role:
type: string
content:
type: string
files:
type: array
items:
type: object
idempotencyKey:
type: string
responses:
"200":
description: Before action checkpoint created
/v1/actions/after:
post:
tags: [Actions]
summary: Create an after-action checkpoint
operationId: afterAction
requestBody:
required: true
content:
application/json:
schema:
type: object
required: [projectId, sessionId, action, beforeCheckpointId]
properties:
projectId:
type: string
sessionId:
type: string
action:
type: string
actionId:
type: string
beforeCheckpointId:
type: string
files:
type: array
items:
type: object
result:
type: object
success:
type: boolean
error:
type: string
idempotencyKey:
type: string
responses:
"200":
description: After action checkpoint created
# ===========================================================================
# Trees
# ===========================================================================
/v1/trees/{checkpointId}:
get:
tags: [Trees]
summary: Get root tree entries for a checkpoint
operationId: getTreeForCheckpoint
parameters:
- name: checkpointId
in: path
required: true
schema:
type: string
- name: projectId
in: query
required: true
schema:
type: string
responses:
"200":
description: Root tree entries
"404":
description: Tree not found
/v1/trees/{checkpointId}/path/{path}:
get:
tags: [Trees]
summary: Get tree entries at a directory path
operationId: getTreeAtPath
parameters:
- name: checkpointId
in: path
required: true
schema:
type: string
- name: path
in: path
required: true
schema:
type: string
- name: projectId
in: query
required: true
schema:
type: string
responses:
"200":
description: Tree entries at path
/v1/trees/hash/{hash}:
get:
tags: [Trees]
summary: Get tree by content hash
operationId: getTreeByHash
parameters:
- name: hash
in: path
required: true
schema:
type: string
- name: projectId
in: query
required: true
schema:
type: string
responses:
"200":
description: Tree object
"404":
description: Tree not found
# ===========================================================================
# Consent
# ===========================================================================
/v1/consent:
post:
tags: [Consent]
summary: Create or update a consent record
operationId: createConsent
requestBody:
required: true
content:
application/json:
schema:
type: object
required: [consentType, granted]
properties:
consentType:
type: string
enum: [operational_capture, training_export]
granted:
type: boolean
projectId:
type: string
organizationId:
type: string
effectiveFrom:
type: string
format: date-time
effectiveTo:
type: string
format: date-time
metadata:
type: object
responses:
"201":
description: Consent record created
get:
tags: [Consent]
summary: List active consent records
operationId: listConsents
parameters:
- name: projectId
in: query
schema:
type: string
- name: organizationId
in: query
schema:
type: string
- name: consentType
in: query
schema:
type: string
- name: includeExpired
in: query
schema:
type: boolean
default: false
responses:
"200":
description: List of consent records
/v1/consent/history:
get:
tags: [Consent]
summary: Get full consent history
operationId: getConsentHistory
responses:
"200":
description: Consent history
# ===========================================================================
# Retention
# ===========================================================================
/v1/retention:
post:
tags: [Retention]
summary: Create or update a retention policy
operationId: upsertRetentionPolicy
requestBody:
required: true
content:
application/json:
schema:
type: object
required: [dataClass, retentionDays]
properties:
dataClass:
type: string
retentionDays:
type: integer
hardDelete:
type: boolean
default: false
projectId:
type: string
organizationId:
type: string
responses:
"201":
description: Retention policy created/updated
get:
tags: [Retention]
summary: List retention policies
operationId: listRetentionPolicies
responses:
"200":
description: List of retention policies
/v1/retention/apply:
post:
tags: [Retention]
summary: Apply retention policies to a project
operationId: applyRetention
requestBody:
required: true
content:
application/json:
schema:
type: object
required: [projectId]
properties:
projectId:
type: string
dataClass:
type: string
dryRun:
type: boolean
default: true
responses:
"200":
description: Retention applied
# ===========================================================================
# Data (Deletion Requests)
# ===========================================================================
/v1/data/delete-request:
post:
tags: [Data]
summary: Create a data deletion request
operationId: createDeleteRequest
requestBody:
required: true
content:
application/json:
schema:
type: object
required: [scope]
properties:
scope:
type: string
enum: [project, user]
projectId:
type: string
reason:
type: string
responses:
"202":
description: Delete request created
get:
tags: [Data]
summary: List deletion requests
operationId: listDeleteRequests
responses:
"200":
description: List of delete requests
/v1/data/delete-request/{requestId}:
get:
tags: [Data]
summary: Get delete request status
operationId: getDeleteRequest
parameters:
- name: requestId
in: path
required: true
schema:
type: string
responses:
"200":
description: Delete request details
/v1/data/delete-request/{requestId}/process:
post:
tags: [Data]
summary: Process a delete request
operationId: processDeleteRequest
parameters:
- name: requestId
in: path
required: true
schema:
type: string
responses:
"200":
description: Delete request processed
/v1/data/delete-request/process-pending:
post:
tags: [Data]
summary: Process all pending delete requests
operationId: processPendingDeleteRequests
responses:
"200":
description: Pending requests processed
# ===========================================================================
# Export
# ===========================================================================
/v1/export/training:
post:
tags: [Export]
summary: Export training data (JSONL)
operationId: exportTraining
requestBody:
content:
application/json:
schema:
type: object
properties:
format:
type: string
enum: [openai, anthropic, generic]
default: generic
includeTools:
type: boolean
default: true
includeErrors:
type: boolean
default: true
redact:
type: boolean
default: true
since:
type: string
format: date-time
projectId:
type: string
destination:
type: string
s3_bucket:
type: string
s3_prefix:
type: string
responses:
"202":
description: Export job created
/v1/export/analytics:
post:
tags: [Export]
summary: Export analytics data
operationId: exportAnalytics
responses:
"202":
description: Export job created
/v1/export/status/{id}:
get:
tags: [Export]
summary: Check export job status
operationId: getExportStatus
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
"200":
description: Export job status
/v1/export/download/{id}:
get:
tags: [Export]
summary: Download export data
operationId: downloadExport
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
"200":
description: Export data download
"409":
description: Export not ready
/v1/export/jobs:
get:
tags: [Export]
summary: List export jobs
operationId: listExportJobs
responses:
"200":
description: List of export jobs
# ===========================================================================
# Webhooks
# ===========================================================================
/v1/webhooks/register:
post:
tags: [Webhooks]
summary: Register a webhook
operationId: registerWebhook
requestBody:
required: true
content:
application/json:
schema:
type: object
required: [url, events]
properties:
url:
type: string
events:
type: array
items:
type: string
secret:
type: string
responses:
"200":
description: Webhook registered
/v1/webhooks/list:
get:
tags: [Webhooks]
summary: List webhooks
operationId: listWebhooks
responses:
"200":
description: List of webhooks
/v1/webhooks/test:
post:
tags: [Webhooks]
summary: Test a webhook (simple)
operationId: testWebhookSimple
responses:
"200":
description: Test result
/v1/webhooks/events:
get:
tags: [Webhooks]
summary: SSE stream for real-time events
operationId: webhookSSE
responses:
"200":
description: SSE event stream
/v1/webhooks/{webhookId}:
delete:
tags: [Webhooks]
summary: Delete a webhook
operationId: deleteWebhook
parameters:
- name: webhookId
in: path
required: true
schema:
type: string
responses:
"200":
description: Webhook deleted
patch:
tags: [Webhooks]
summary: Update a webhook
operationId: updateWebhook
parameters:
- name: webhookId
in: path
required: true
schema:
type: string
responses:
"200":
description: Webhook updated
/v1/webhooks/{webhookId}/test:
post:
tags: [Webhooks]
summary: Test a specific webhook (reliable delivery)
operationId: testWebhook
parameters:
- name: webhookId
in: path
required: true
schema:
type: string
responses:
"200":
description: Test delivery result
/v1/webhooks/{webhookId}/deliveries:
get:
tags: [Webhooks]
summary: List webhook deliveries
operationId: listWebhookDeliveries
parameters:
- name: webhookId
in: path
required: true
schema:
type: string
responses:
"200":
description: List of deliveries
/v1/webhooks/{webhookId}/deliveries/{deliveryId}:
get:
tags: [Webhooks]
summary: Get delivery details
operationId: getWebhookDelivery
parameters:
- name: webhookId
in: path
required: true
schema:
type: string
- name: deliveryId
in: path
required: true
schema:
type: string
responses:
"200":
description: Delivery details
/v1/webhooks/{webhookId}/deliveries/{deliveryId}/retry:
post:
tags: [Webhooks]
summary: Retry a failed delivery
operationId: retryWebhookDelivery
parameters:
- name: webhookId
in: path
required: true
schema:
type: string
- name: deliveryId
in: path
required: true
schema:
type: string
responses:
"200":
description: Retry result
/v1/webhooks/{webhookId}/stats:
get:
tags: [Webhooks]
summary: Get webhook delivery stats
operationId: getWebhookStats
parameters:
- name: webhookId
in: path
required: true
schema:
type: string
responses:
"200":
description: Delivery stats
# ===========================================================================
# Search
# ===========================================================================
/v1/search/universal:
post:
tags: [Search]
summary: Search across all sources
operationId: searchUniversal
responses:
"200":
description: Universal search results
/v1/search/checkpoints:
post:
tags: [Search]
summary: Search checkpoint history
operationId: searchCheckpoints
responses:
"200":
description: Checkpoint search results
/v1/search/conversations:
post:
tags: [Search]
summary: Search conversation history
operationId: searchConversations
responses:
"200":
description: Conversation search results
/v1/search/code:
post:
tags: [Search]
summary: Search code across repositories
operationId: searchCode
responses:
"200":
description: Code search results
/v1/search/symbols:
post:
tags: [Search]
summary: Search for symbols (functions, classes)
operationId: searchSymbols
responses:
"200":
description: Symbol search results
/v1/search/find-definition:
post:
tags: [Search]
summary: Find definition of a symbol
operationId: findDefinition
responses:
"200":
description: Symbol definition
/v1/search/find-usages:
post:
tags: [Search]
summary: Find all usages of a symbol
operationId: findUsages
responses:
"200":
description: Symbol usage results
# ===========================================================================
# Dashboard
# ===========================================================================
/v1/dashboard/overview:
get:
tags: [Dashboard]
summary: Get dashboard overview
operationId: getDashboardOverview
responses:
"200":
description: Dashboard overview data
/v1/dashboard/activity:
get:
tags: [Dashboard]
summary: Get recent activity
operationId: getDashboardActivity
responses:
"200":
description: Activity data
/v1/dashboard/search:
get:
tags: [Dashboard]
summary: Dashboard search
operationId: dashboardSearch
responses:
"200":
description: Dashboard search results
/v1/dashboard/projects/{projectId}/stats:
get:
tags: [Dashboard]
summary: Get project stats
operationId: getProjectStats
parameters:
- name: projectId
in: path
required: true
schema:
type: string
responses:
"200":
description: Project statistics
# ===========================================================================
# Usage
# ===========================================================================
/v1/usage:
get:
tags: [Usage]
summary: Get current usage metrics
operationId: getUsage
responses:
"200":
description: Usage metrics
/v1/usage/history:
get:
tags: [Usage]
summary: Get usage history
operationId: getUsageHistory
responses:
"200":
description: Usage history
/v1/usage/breakdown:
get:
tags: [Usage]
summary: Get usage breakdown by category
operationId: getUsageBreakdown
responses:
"200":
description: Usage breakdown
/v1/usage/limits:
get:
tags: [Usage]
summary: Get usage limits
operationId: getUsageLimits
responses:
"200":
description: Usage limits
# ===========================================================================
# Billing
# ===========================================================================
/v1/billing/checkout:
post:
tags: [Billing]
summary: Create a checkout session
operationId: createCheckout
responses:
"200":
description: Checkout session created
/v1/billing/portal:
get:
tags: [Billing]
summary: Get billing portal URL
operationId: getBillingPortal
responses:
"200":
description: Portal URL
/v1/billing/webhooks:
post:
tags: [Billing]
summary: Handle billing webhooks
operationId: handleBillingWebhook
security: []
responses:
"200":
description: Webhook processed
# ===========================================================================
# Contexts
# ===========================================================================
/v1/contexts:
get:
tags: [Contexts]
summary: List contexts
operationId: listContexts
responses:
"200":
description: List of contexts
post:
tags: [Contexts]
summary: Create a context
operationId: createContext
responses:
"200":
description: Context created
# ===========================================================================
# Repositories
# ===========================================================================
/v1/repositories:
post:
tags: [Repositories]
summary: Index a repository
operationId: indexRepository
responses:
"200":
description: Repository indexed
get:
tags: [Repositories]
summary: List repositories
operationId: listRepositories
responses:
"200":
description: List of repositories
# ===========================================================================
# Research
# ===========================================================================
/v1/research:
post:
tags: [Research]
summary: Start a research job
operationId: startResearch
responses:
"200":
description: Research job started
get:
tags: [Research]
summary: List research jobs
operationId: listResearchJobs
responses:
"200":
description: List of research jobs
# ===========================================================================
# Oracle / Deep Research
# ===========================================================================
/v1/oracle/query:
post:
tags: [Oracle]
summary: Submit an oracle query
operationId: oracleQuery
responses:
"200":
description: Oracle query result
# ===========================================================================
# Universal Search / Query
# ===========================================================================
/v1/universal-search:
post:
tags: [UniversalSearch]
summary: Universal semantic search
operationId: universalSearch
responses:
"200":
description: Universal search results
# ===========================================================================
# Web Search
# ===========================================================================
/v1/web-search:
post:
tags: [WebSearch]
summary: Perform a web search
operationId: webSearch
responses:
"200":
description: Web search results
# ===========================================================================
# Package Search
# ===========================================================================
/v1/package-search:
get:
tags: [PackageSearch]
summary: Search packages
operationId: searchPackages
responses:
"200":
description: Package search results
# ===========================================================================
# Shared Checkpoints
# ===========================================================================
/v1/shared-checkpoints:
get:
tags: [SharedCheckpoints]
summary: List shared checkpoints
operationId: listSharedCheckpoints
responses:
"200":
description: List of shared checkpoints
post:
tags: [SharedCheckpoints]
summary: Share a checkpoint
operationId: shareCheckpoint
responses:
"200":
description: Checkpoint shared
# ===========================================================================
# SSO
# ===========================================================================
/v1/sso/config:
get:
tags: [SSO]
summary: Get SSO configuration
operationId: getSSOConfig
responses:
"200":
description: SSO configuration
post:
tags: [SSO]
summary: Create SSO configuration
operationId: createSSOConfig
responses:
"200":
description: SSO configuration created
# ===========================================================================
# Research Papers
# ===========================================================================
/v1/research-papers:
get:
tags: [ResearchPapers]
summary: List research papers
operationId: listResearchPapers
responses:
"200":
description: List of research papers
post:
tags: [ResearchPapers]
summary: Submit a research paper
operationId: submitResearchPaper
responses:
"200":
description: Paper submitted
# ===========================================================================
# Pipeline
# ===========================================================================
/v1/pipeline:
post:
tags: [Pipeline]
summary: Create a pipeline
operationId: createPipeline
responses:
"200":
description: Pipeline created
get:
tags: [Pipeline]
summary: List pipelines
operationId: listPipelines
responses:
"200":
description: List of pipelines
# ===========================================================================
# Knowledge Base
# ===========================================================================
/v1/knowledge-base:
get:
tags: [KnowledgeBase]
summary: List knowledge base artifacts
operationId: listKnowledgeBase
responses:
"200":
description: List of artifacts
# ===========================================================================
# Data Sources
# ===========================================================================
/v1/data-sources:
get:
tags: [DataSources]
summary: List data sources
operationId: listDataSources
responses:
"200":
description: List of data sources
post:
tags: [DataSources]
summary: Register a data source
operationId: registerDataSource
responses:
"200":
description: Data source registered
# ===========================================================================
# Context (checkpoint context)
# ===========================================================================
/v1/context/{checkpointId}:
get:
tags: [Context]
summary: Get checkpoint context
operationId: getCheckpointContext
parameters:
- name: checkpointId
in: path
required: true
schema:
type: string
responses:
"200":
description: Checkpoint context data
# ===========================================================================
# Gitgram Social (AITM integration)
# ===========================================================================
/v1/gitgram/repos/import:
post:
tags: [Gitgram]
summary: Import repositories
operationId: importRepos
responses:
"200":
description: Repositories imported
/v1/gitgram/posts:
post:
tags: [Gitgram]
summary: Create a social post
operationId: createGitgramPost
responses:
"200":
description: Post created
get:
tags: [Gitgram]
summary: List social posts
operationId: listGitgramPosts
responses:
"200":
description: List of posts
/v1/gitgram/trending:
get:
tags: [Gitgram]
summary: Get trending content
operationId: getGitgramTrending
responses:
"200":
description: Trending content
# ===========================================================================
# V1 Info
# ===========================================================================
/v1:
get:
tags: [Info]
summary: API version and endpoint listing
security: []
operationId: getApiInfo
responses:
"200":
description: API info and available endpoints