> ## Documentation Index > Fetch the complete documentation index at: https://docs.korve.dev/llms.txt > Use this file to discover all available pages before exploring further. # Track > Accept a bounded batch of public allowlisted events with a closed low-cardinality property schema per event. Raw network addresses, secrets, personal data, nested objects, arbitrary property names, and authoritative lifecycle claims are rejected. ## OpenAPI ````yaml /openapi.json post /v1/telemetry/events openapi: 3.1.0 info: title: Korve API version: 0.1.0 description: >- Typed control plane for deploying applications and explicitly provisioning their managed infrastructure. servers: - url: https://api.korve.dev security: [] paths: /v1/telemetry/events: post: tags: - productTelemetry summary: Track description: >- Accept a bounded batch of public allowlisted events with a closed low-cardinality property schema per event. Raw network addresses, secrets, personal data, nested objects, arbitrary property names, and authoritative lifecycle claims are rejected. operationId: productTelemetry.track parameters: [] requestBody: required: true x-korve-max-bytes: 65536 content: application/json: schema: type: object additionalProperties: false required: - events properties: events: type: array minItems: 1 maxItems: 20 items: oneOf: - type: object additionalProperties: false required: - name - at - properties properties: name: type: string enum: - cli_installed at: type: string format: date-time description: >- When the event occurred. Events outside the accepted clock window are rejected. anonymousId: type: string format: uuid minLength: 1 maxLength: 80 description: >- Optional random installation UUID. The service stores only a one-way digest. organizationId: type: string format: uuid description: >- Optional post-auth correlation claim. Public claims are digested and never trusted for organization reporting. properties: type: object additionalProperties: false maxProperties: 3 propertyNames: type: string pattern: ^[a-z][a-z0-9_]{0,63}$ required: - channel - os - arch properties: channel: type: string enum: - shell os: type: string enum: - Darwin - Linux arch: type: string enum: - arm64 - aarch64 - x86_64 - type: object additionalProperties: false required: - name - at - properties properties: name: type: string enum: - login_started at: type: string format: date-time description: >- When the event occurred. Events outside the accepted clock window are rejected. anonymousId: type: string format: uuid minLength: 1 maxLength: 80 description: >- Optional random installation UUID. The service stores only a one-way digest. organizationId: type: string format: uuid description: >- Optional post-auth correlation claim. Public claims are digested and never trusted for organization reporting. properties: type: object additionalProperties: false maxProperties: 2 propertyNames: type: string pattern: ^[a-z][a-z0-9_]{0,63}$ required: - method - agent properties: method: type: string enum: - oauth agent: type: string enum: - terminal - codex - cursor - claude-code - windsurf - type: object additionalProperties: false required: - name - at - properties properties: name: type: string enum: - login_succeeded at: type: string format: date-time description: >- When the event occurred. Events outside the accepted clock window are rejected. anonymousId: type: string format: uuid minLength: 1 maxLength: 80 description: >- Optional random installation UUID. The service stores only a one-way digest. organizationId: type: string format: uuid description: >- Optional post-auth correlation claim. Public claims are digested and never trusted for organization reporting. properties: type: object additionalProperties: false maxProperties: 2 propertyNames: type: string pattern: ^[a-z][a-z0-9_]{0,63}$ required: - method - agent properties: method: type: string enum: - oauth agent: type: string enum: - terminal - codex - cursor - claude-code - windsurf - type: object additionalProperties: false required: - name - at - properties properties: name: type: string enum: - login_failed at: type: string format: date-time description: >- When the event occurred. Events outside the accepted clock window are rejected. anonymousId: type: string format: uuid minLength: 1 maxLength: 80 description: >- Optional random installation UUID. The service stores only a one-way digest. organizationId: type: string format: uuid description: >- Optional post-auth correlation claim. Public claims are digested and never trusted for organization reporting. properties: type: object additionalProperties: false maxProperties: 2 propertyNames: type: string pattern: ^[a-z][a-z0-9_]{0,63}$ required: - method - agent properties: method: type: string enum: - oauth agent: type: string enum: - terminal - codex - cursor - claude-code - windsurf - type: object additionalProperties: false required: - name - at - properties properties: name: type: string enum: - link_agent_files at: type: string format: date-time description: >- When the event occurred. Events outside the accepted clock window are rejected. anonymousId: type: string format: uuid minLength: 1 maxLength: 80 description: >- Optional random installation UUID. The service stores only a one-way digest. organizationId: type: string format: uuid description: >- Optional post-auth correlation claim. Public claims are digested and never trusted for organization reporting. properties: type: object additionalProperties: false maxProperties: 2 propertyNames: type: string pattern: ^[a-z][a-z0-9_]{0,63}$ required: - skill_targets - agent properties: skill_targets: type: integer minimum: 0 maximum: 16 agent: type: string enum: - terminal - codex - cursor - claude-code - windsurf - type: object additionalProperties: false required: - name - at - properties properties: name: type: string enum: - init_planned at: type: string format: date-time description: >- When the event occurred. Events outside the accepted clock window are rejected. anonymousId: type: string format: uuid minLength: 1 maxLength: 80 description: >- Optional random installation UUID. The service stores only a one-way digest. organizationId: type: string format: uuid description: >- Optional post-auth correlation claim. Public claims are digested and never trusted for organization reporting. properties: type: object additionalProperties: false maxProperties: 3 propertyNames: type: string pattern: ^[a-z][a-z0-9_]{0,63}$ required: - framework - project_count - agent properties: framework: type: string enum: - Next.js - Remix - TanStack Start - Vite - Rust - Dockerfile - generic application project_count: type: integer minimum: 1 maximum: 1 agent: type: string enum: - terminal - codex - cursor - claude-code - windsurf - type: object additionalProperties: false required: - name - at - properties properties: name: type: string enum: - checkout_link_shown at: type: string format: date-time description: >- When the event occurred. Events outside the accepted clock window are rejected. anonymousId: type: string format: uuid minLength: 1 maxLength: 80 description: >- Optional random installation UUID. The service stores only a one-way digest. organizationId: type: string format: uuid description: >- Optional post-auth correlation claim. Public claims are digested and never trusted for organization reporting. properties: type: object additionalProperties: false maxProperties: 1 propertyNames: type: string pattern: ^[a-z][a-z0-9_]{0,63}$ required: - agent properties: agent: type: string enum: - terminal - codex - cursor - claude-code - windsurf - type: object additionalProperties: false required: - name - at - properties properties: name: type: string enum: - mcp_installed at: type: string format: date-time description: >- When the event occurred. Events outside the accepted clock window are rejected. anonymousId: type: string format: uuid minLength: 1 maxLength: 80 description: >- Optional random installation UUID. The service stores only a one-way digest. organizationId: type: string format: uuid description: >- Optional post-auth correlation claim. Public claims are digested and never trusted for organization reporting. properties: type: object additionalProperties: false maxProperties: 1 propertyNames: type: string pattern: ^[a-z][a-z0-9_]{0,63}$ required: - agent properties: agent: type: string enum: - terminal - codex - cursor - claude-code - windsurf - type: object additionalProperties: false required: - name - at - properties properties: name: type: string enum: - guard_nudged at: type: string format: date-time description: >- When the event occurred. Events outside the accepted clock window are rejected. anonymousId: type: string format: uuid minLength: 1 maxLength: 80 description: >- Optional random installation UUID. The service stores only a one-way digest. organizationId: type: string format: uuid description: >- Optional post-auth correlation claim. Public claims are digested and never trusted for organization reporting. properties: type: object additionalProperties: false maxProperties: 1 propertyNames: type: string pattern: ^[a-z][a-z0-9_]{0,63}$ required: - agent properties: agent: type: string enum: - terminal - codex - cursor - claude-code - windsurf - type: object additionalProperties: false required: - name - at - properties properties: name: type: string enum: - guard_briefed at: type: string format: date-time description: >- When the event occurred. Events outside the accepted clock window are rejected. anonymousId: type: string format: uuid minLength: 1 maxLength: 80 description: >- Optional random installation UUID. The service stores only a one-way digest. organizationId: type: string format: uuid description: >- Optional post-auth correlation claim. Public claims are digested and never trusted for organization reporting. properties: type: object additionalProperties: false maxProperties: 1 propertyNames: type: string pattern: ^[a-z][a-z0-9_]{0,63}$ required: - agent properties: agent: type: string enum: - terminal - codex - cursor - claude-code - windsurf responses: '202': description: The bounded event batch was accepted for first-party storage. content: application/json: schema: type: object additionalProperties: false required: - accepted properties: accepted: type: integer minimum: 1 maximum: 20 '413': description: The encoded request exceeds 65,536 bytes. '422': description: The event batch is malformed or outside the privacy bounds. '429': description: The global or trusted-edge network budget is exhausted. '503': description: The keyed privacy boundary is not configured. security: [] ````