{"openapi":"3.0.0","info":{"description":"Daytona Analytics API - Read-only telemetry and usage data. Authenticated via Daytona API keys or JWT tokens.","title":"Daytona Analytics API","contact":{},"version":"v0.4.0"},"paths":{"/organization/{organizationId}/sandbox/{sandboxId}/telemetry/logs":{"get":{"security":[{"Bearer":[]}],"description":"Returns paginated log entries with optional severity and search filters","tags":["Telemetry"],"summary":"Get sandbox logs","parameters":[{"description":"Organization ID","name":"organizationId","in":"path","required":true,"schema":{"type":"string"}},{"description":"Sandbox ID","name":"sandboxId","in":"path","required":true,"schema":{"type":"string"}},{"description":"Start time (RFC3339)","name":"from","in":"query","required":true,"schema":{"type":"string"}},{"description":"End time (RFC3339)","name":"to","in":"query","required":true,"schema":{"type":"string"}},{"description":"Comma-separated severity levels","name":"severity","in":"query","schema":{"type":"string"}},{"description":"Search text (ILIKE)","name":"search","in":"query","schema":{"type":"string"}},{"description":"Page size","name":"limit","in":"query","schema":{"type":"integer","default":100}},{"description":"Offset","name":"offset","in":"query","schema":{"type":"integer","default":0}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/models.LogEntry"}}}}}},"operationId":"getSandboxLogs"}},"/organization/{organizationId}/sandbox/{sandboxId}/telemetry/metrics":{"get":{"security":[{"Bearer":[]}],"description":"Returns gauge metrics aggregated in 1-minute intervals","tags":["Telemetry"],"summary":"Get sandbox metrics","parameters":[{"description":"Organization ID","name":"organizationId","in":"path","required":true,"schema":{"type":"string"}},{"description":"Sandbox ID","name":"sandboxId","in":"path","required":true,"schema":{"type":"string"}},{"description":"Start time (RFC3339)","name":"from","in":"query","required":true,"schema":{"type":"string"}},{"description":"End time (RFC3339)","name":"to","in":"query","required":true,"schema":{"type":"string"}},{"description":"Comma-separated metric names","name":"metricNames","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/models.MetricPoint"}}}}}},"operationId":"getSandboxMetrics"}},"/organization/{organizationId}/sandbox/{sandboxId}/telemetry/traces":{"get":{"security":[{"Bearer":[]}],"description":"Returns paginated trace summaries with span counts and root span info","tags":["Telemetry"],"summary":"Get sandbox traces","parameters":[{"description":"Organization ID","name":"organizationId","in":"path","required":true,"schema":{"type":"string"}},{"description":"Sandbox ID","name":"sandboxId","in":"path","required":true,"schema":{"type":"string"}},{"description":"Start time (RFC3339)","name":"from","in":"query","required":true,"schema":{"type":"string"}},{"description":"End time (RFC3339)","name":"to","in":"query","required":true,"schema":{"type":"string"}},{"description":"Page size","name":"limit","in":"query","schema":{"type":"integer","default":100}},{"description":"Offset","name":"offset","in":"query","schema":{"type":"integer","default":0}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/models.TraceSummary"}}}}}},"operationId":"getSandboxTraces"}},"/organization/{organizationId}/sandbox/{sandboxId}/telemetry/traces/{traceId}":{"get":{"security":[{"Bearer":[]}],"description":"Returns all spans belonging to a specific trace ID","tags":["Telemetry"],"summary":"Get trace spans","parameters":[{"description":"Organization ID","name":"organizationId","in":"path","required":true,"schema":{"type":"string"}},{"description":"Sandbox ID","name":"sandboxId","in":"path","required":true,"schema":{"type":"string"}},{"description":"Trace ID","name":"traceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/models.Span"}}}}}},"operationId":"getTraceSpans"}},"/organization/{organizationId}/sandbox/{sandboxId}/usage":{"get":{"security":[{"Bearer":[]}],"description":"Returns individual usage records for a specific sandbox within a time range","tags":["Usage"],"summary":"Get sandbox usage periods","parameters":[{"description":"Organization ID","name":"organizationId","in":"path","required":true,"schema":{"type":"string"}},{"description":"Sandbox ID","name":"sandboxId","in":"path","required":true,"schema":{"type":"string"}},{"description":"Start time (RFC3339)","name":"from","in":"query","required":true,"schema":{"type":"string"}},{"description":"End time (RFC3339)","name":"to","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/models.UsagePeriod"}}}}}},"operationId":"getSandboxUsagePeriods"}},"/organization/{organizationId}/usage/aggregated":{"get":{"security":[{"Bearer":[]}],"description":"Returns organization-level resource usage totals for a given time period","tags":["Usage"],"summary":"Get aggregated usage","parameters":[{"description":"Organization ID","name":"organizationId","in":"path","required":true,"schema":{"type":"string"}},{"description":"Start time (RFC3339)","name":"from","in":"query","required":true,"schema":{"type":"string"}},{"description":"End time (RFC3339)","name":"to","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/models.AggregatedUsage"}}}}},"operationId":"getAggregatedUsage"}},"/organization/{organizationId}/usage/chart":{"get":{"security":[{"Bearer":[]}],"description":"Returns resource usage data points for a given time period with auto-scaled resolution","tags":["Usage"],"summary":"Get usage chart data","parameters":[{"description":"Organization ID","name":"organizationId","in":"path","required":true,"schema":{"type":"string"}},{"description":"Start time (RFC3339)","name":"from","in":"query","required":true,"schema":{"type":"string"}},{"description":"End time (RFC3339)","name":"to","in":"query","required":true,"schema":{"type":"string"}},{"description":"Region filter","name":"region","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/models.UsageChartPoint"}}}}}},"operationId":"getUsageChartData"}},"/organization/{organizationId}/usage/sandbox":{"get":{"security":[{"Bearer":[]}],"description":"Returns resource usage aggregated per sandbox for a given time period","tags":["Usage"],"summary":"Get per-sandbox usage","parameters":[{"description":"Organization ID","name":"organizationId","in":"path","required":true,"schema":{"type":"string"}},{"description":"Start time (RFC3339)","name":"from","in":"query","required":true,"schema":{"type":"string"}},{"description":"End time (RFC3339)","name":"to","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/models.SandboxUsage"}}}}}},"operationId":"getPerSandboxUsage"}}},"servers":[{"url":"https://analytics.app.daytona.io"}],"components":{"securitySchemes":{"Bearer":{"description":"JWT token or Admin API key","type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"models.AggregatedUsage":{"type":"object","properties":{"firstStart":{"type":"string"},"lastEnd":{"type":"string"},"sandboxCount":{"type":"integer"},"totalCPUSeconds":{"type":"integer"},"totalDiskGBSeconds":{"type":"integer"},"totalGPUSeconds":{"type":"integer"},"totalPrice":{"type":"number"},"totalRAMGBSeconds":{"type":"integer"}}},"models.LogEntry":{"type":"object","properties":{"body":{"type":"string"},"logAttributes":{"type":"object","additionalProperties":{"type":"string"}},"resourceAttributes":{"type":"object","additionalProperties":{"type":"string"}},"serviceName":{"type":"string"},"severityNumber":{"type":"integer"},"severityText":{"type":"string"},"spanId":{"type":"string"},"timestamp":{"type":"string"},"traceId":{"type":"string"}}},"models.MetricPoint":{"type":"object","properties":{"metricName":{"type":"string"},"timestamp":{"type":"string"},"value":{"type":"number","format":"double"}}},"models.SandboxUsage":{"type":"object","properties":{"firstStart":{"type":"string"},"lastEnd":{"type":"string"},"sandboxId":{"type":"string"},"totalCPUSeconds":{"type":"integer"},"totalDiskGBSeconds":{"type":"integer"},"totalGPUSeconds":{"type":"integer"},"totalPrice":{"type":"number"},"totalRAMGBSeconds":{"type":"integer"}}},"models.Span":{"type":"object","properties":{"durationMs":{"type":"number"},"parentSpanId":{"type":"string"},"spanAttributes":{"type":"object","additionalProperties":{"type":"string"}},"spanId":{"type":"string"},"spanName":{"type":"string"},"statusCode":{"type":"string"},"statusMessage":{"type":"string"},"timestamp":{"type":"string"},"traceId":{"type":"string"}}},"models.TraceSummary":{"type":"object","properties":{"endTime":{"type":"string"},"rootSpanName":{"type":"string"},"spanCount":{"type":"integer"},"startTime":{"type":"string"},"statusCode":{"type":"string"},"totalDurationMs":{"type":"number"},"traceId":{"type":"string"}}},"models.UsageChartPoint":{"type":"object","properties":{"cpu":{"type":"integer"},"cpuPrice":{"type":"number"},"diskGB":{"type":"integer"},"diskPrice":{"type":"number"},"ramGB":{"type":"integer"},"ramPrice":{"type":"number"},"time":{"type":"string"}}},"models.UsagePeriod":{"type":"object","properties":{"cpu":{"type":"integer"},"diskGB":{"type":"integer"},"endAt":{"type":"string"},"gpu":{"type":"integer"},"price":{"type":"number"},"ramGB":{"type":"integer"},"startAt":{"type":"string"}}}}},"tags":[{"name":"Telemetry"},{"name":"Usage"}]}