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>
2482 lines
61 KiB
YAML
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
|