generated: '2026-10-18'
method: derived
generator: derive-vocabulary.py
source: openapi/latitude-so-openapi.json
vocabulary:
  name: Latitude Domain Vocabulary
  description: 'Terms declared by Latitude''s own API contract: its resource groups, objects and enumerations, with the contract''s definitions.
    Derived, not authored.'
  version: '2026-10-18'
  terms:
  - term: HealthResponse
    definition: 'Object declared by the contract with fields: service, status.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/HealthResponse
  - term: OAuthProtectedResourceMetadata
    definition: 'Object declared by the contract with fields: resource, authorization_servers.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/OAuthProtectedResourceMetadata
  - term: BootstrapAccountResponse
    definition: 'Object declared by the contract with fields: organizationSlug, projectSlug, apiKey, claimUrl, claimEmail, claimExpiresAt.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/BootstrapAccountResponse
  - term: Error
    definition: 'Object declared by the contract with fields: error.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/Error
  - term: BootstrapAccountBody
    definition: 'Object declared by the contract with fields: organizationName, projectName, userEmail.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/BootstrapAccountBody
  - term: Project
    definition: 'Object declared by the contract with fields: id, organizationId, name, slug, settings, firstTraceAt, deletedAt, lastEditedAt,
      createdAt, updatedAt.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/Project
  - term: ProjectSettings
    definition: Per-project settings overrides. `null` means inherit from the organization.
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/ProjectSettings
  - term: RedactionSetting
    definition: Server-side PII redaction applied before spans are stored. An organization-wide policy can override this one; when the organization
      locks its policy, project values are ignored entirely rather than merged.
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/RedactionSetting
  - term: NotificationsSetting
    definition: Per-group project-level notification toggles (`incidents`, `destinations`).
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/NotificationsSetting
  - term: IncidentNotificationsSetting
    definition: Per-alert-kind opt-out for incident notifications.
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/IncidentNotificationsSetting
  - term: DestinationNotificationsSetting
    definition: Project-level opt-out for data-destination notifications.
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/DestinationNotificationsSetting
  - term: EscalationSetting
    definition: Tuning parameters for the escalation detector. Affects detector behaviour regardless of whether notifications are enabled.
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/EscalationSetting
  - term: CreateProjectBody
    definition: 'Object declared by the contract with fields: name.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/CreateProjectBody
  - term: PaginatedProjects
    definition: 'Object declared by the contract with fields: items, nextCursor, hasMore.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/PaginatedProjects
  - term: UpdateProjectBody
    definition: 'Object declared by the contract with fields: name, settings, flaggers.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/UpdateProjectBody
  - term: ProjectSettingsPatch
    definition: Patch the project's settings overrides. Only the fields you send are changed; omitted fields keep their stored values. To clear
      overrides entirely, edit via the web UI.
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/ProjectSettingsPatch
  - term: CustomScoreResponse
    definition: 'Object declared by the contract with fields: id, organizationId, projectId, sessionId, traceId, spanId, simulationId, signalId,
      value, passed, feedback, error. (11 more)'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/CustomScoreResponse
  - term: EvaluationScoreResponse
    definition: 'Object declared by the contract with fields: id, organizationId, projectId, sessionId, traceId, spanId, simulationId, signalId,
      value, passed, feedback, error. (11 more)'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/EvaluationScoreResponse
  - term: EvaluationScoreMetadata
    definition: Evaluation-specific metadata.
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/EvaluationScoreMetadata
  - term: CreateCustomScoreBody
    definition: 'Object declared by the contract with fields: simulationId, value, passed, feedback, error, duration, tokens, cost, trace, sourceId,
      metadata, _evaluation.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/CreateCustomScoreBody
  - term: TraceRef
    definition: Target trace. Either an explicit id or a filter set matching exactly one trace.
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/TraceRef
  - term: FilterSet
    definition: Filter set keyed by field name. Each entry holds an array of conditions ANDed together for that field; field-level groups are
      also ANDed across the set.
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/FilterSet
  - term: FilterCondition
    definition: 'Object declared by the contract with fields: op, value.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/FilterCondition
  - term: CreateEvaluationScoreBody
    definition: Internal, don't use
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/CreateEvaluationScoreBody
  - term: Annotation
    definition: 'Object declared by the contract with fields: id, organizationId, projectId, sessionId, traceId, spanId, simulationId, signalId,
      value, passed, feedback, error. (11 more)'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/Annotation
  - term: AnnotationMetadata
    definition: 'Annotation-specific metadata: `rawFeedback` plus a snapshot of the anchor at write time.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/AnnotationMetadata
  - term: CreateAnnotationBody
    definition: 'Object declared by the contract with fields: simulationId, signalId, value, passed, feedback, anchor, trace.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/CreateAnnotationBody
  - term: AnnotationAnchor
    definition: Optional anchor pinning the annotation to a specific message / part / offset range inside the trace.
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/AnnotationAnchor
  - term: UpdateAnnotationBody
    definition: 'Object declared by the contract with fields: value, passed, feedback.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/UpdateAnnotationBody
  - term: PaginatedTraces
    definition: 'Object declared by the contract with fields: items, nextCursor, hasMore.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/PaginatedTraces
  - term: Trace
    definition: 'Object declared by the contract with fields: organizationId, projectId, traceId, spanCount, errorCount, startTime, endTime, durationNs,
      timeToFirstTokenNs, tokensInput, tokensOutput, tokensCacheRead. (17 more)'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/Trace
  - term: ListTracesBody
    definition: 'Object declared by the contract with fields: cursor, limit, sortBy, sortDirection, query, filters.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/ListTracesBody
  - term: TraceFilterSet
    definition: 'Filter set keyed by trace field. Each entry holds an array of conditions ANDed together for that field; field-level groups are
      ANDed across the set. Valid fields: status, name, traceId, sessionId, simulationId, userId, tags, models, providers, serviceNames, tools,
      definedTools, duration, ttft, cost, spanCount, errorCount, tokensInput, tokensOutput, cacheHitRate, startTime, endTime; score-derived k'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/TraceFilterSet
  - term: TraceAnalyticsResponse
    definition: 'Object declared by the contract with fields: traces, cost, duration, tokens, timeToFirstToken, spans.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/TraceAnalyticsResponse
  - term: TraceAnalyticsTraces
    definition: 'Object declared by the contract with fields: total, buckets.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/TraceAnalyticsTraces
  - term: TraceAnalyticsBucket
    definition: 'Object declared by the contract with fields: bucket, value.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/TraceAnalyticsBucket
  - term: TraceAnalyticsCost
    definition: 'Object declared by the contract with fields: total, buckets.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/TraceAnalyticsCost
  - term: TraceAnalyticsDuration
    definition: 'Object declared by the contract with fields: median, buckets.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/TraceAnalyticsDuration
  - term: TraceAnalyticsTokens
    definition: 'Object declared by the contract with fields: total, buckets.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/TraceAnalyticsTokens
  - term: TraceAnalyticsTimeToFirstToken
    definition: 'Object declared by the contract with fields: median, buckets.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/TraceAnalyticsTimeToFirstToken
  - term: TraceAnalyticsSpans
    definition: 'Object declared by the contract with fields: total, buckets.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/TraceAnalyticsSpans
  - term: TraceDetail
    definition: 'Object declared by the contract with fields: organizationId, projectId, traceId, spanCount, errorCount, startTime, endTime, durationNs,
      timeToFirstTokenNs, tokensInput, tokensOutput, tokensCacheRead. (19 more)'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/TraceDetail
  - term: GenAIMessage
    definition: Message in OpenTelemetry GenAI format (`role` + content parts + optional tool calls).
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/GenAIMessage
  - term: TraceSpans
    definition: 'Object declared by the contract with fields: items.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/TraceSpans
  - term: Span
    definition: 'Object declared by the contract with fields: organizationId, projectId, traceId, spanId, parentSpanId, sessionId, userId, simulationId,
      apiKeyId, startTime, endTime, name. (30 more)'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/Span
  - term: SpanDetail
    definition: 'Object declared by the contract with fields: organizationId, projectId, traceId, spanId, parentSpanId, sessionId, userId, simulationId,
      apiKeyId, startTime, endTime, name. (46 more)'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/SpanDetail
  - term: GenAISpanSystem
    definition: System instructions in OpenTelemetry GenAI format — an array of part objects.
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/GenAISpanSystem
  - term: GenAISpanMessage
    definition: Message in OpenTelemetry GenAI format (`role` + content parts + optional tool calls).
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/GenAISpanMessage
  - term: ToolDefinition
    definition: 'Object declared by the contract with fields: name, description, parameters.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/ToolDefinition
  - term: PaginatedTraceAnnotations
    definition: 'Object declared by the contract with fields: items, nextCursor, hasMore.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/PaginatedTraceAnnotations
  - term: SessionMemorySummary
    definition: 'Object declared by the contract with fields: records, total.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/SessionMemorySummary
  - term: MemoryRecordSummary
    definition: 'Object declared by the contract with fields: storeId, recordId, readTokens, tokensAdded, tokensRemoved.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/MemoryRecordSummary
  - term: SessionMemoryChanges
    definition: 'Object declared by the contract with fields: records.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/SessionMemoryChanges
  - term: SessionMemoryChange
    definition: 'Object declared by the contract with fields: storeId, recordId, kind, beforeBody, afterBody, tokensAdded, tokensRemoved, degraded,
      lastChangeSpanId.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/SessionMemoryChange
  - term: ExportTracesResponse
    definition: 'Object declared by the contract with fields: status.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/ExportTracesResponse
  - term: ExportTracesBody
    definition: 'Object declared by the contract with fields: traces, recipient.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/ExportTracesBody
  - term: TracesRef
    definition: Which traces to include in the export — either explicit ids or a filter set.
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/TracesRef
  - term: ToolsAnalyticsResponse
    definition: 'Object declared by the contract with fields: totals, tools.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/ToolsAnalyticsResponse
  - term: ToolsAnalyticsTotals
    definition: Project-wide denominators for the range.
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/ToolsAnalyticsTotals
  - term: ToolSummary
    definition: 'Object declared by the contract with fields: name, metrics, offeredCount, offeredTraces, lastOffered, selectionRate, trend.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/ToolSummary
  - term: ToolUsageMetrics
    definition: Call-side usage metrics. `null` when the tool was defined but never called in the range.
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/ToolUsageMetrics
  - term: ToolCallHistogramBucket
    definition: 'Object declared by the contract with fields: bucketStart, calls, errors, p50DurationNs.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/ToolCallHistogramBucket
  - term: ToolHistogramResponse
    definition: 'Object declared by the contract with fields: items.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/ToolHistogramResponse
  - term: ToolParameterStatsResponse
    definition: 'Object declared by the contract with fields: stats, sampleSize.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/ToolParameterStatsResponse
  - term: ToolParameterStat
    definition: 'Object declared by the contract with fields: key, occurrences, topValues.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/ToolParameterStat
  - term: ToolParameterValueStat
    definition: 'Object declared by the contract with fields: value, count.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/ToolParameterValueStat
  - term: ToolContextBreakdownResponse
    definition: 'Object declared by the contract with fields: items.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/ToolContextBreakdownResponse
  - term: ToolContextBreakdownRow
    definition: 'Object declared by the contract with fields: value, traces, occurrences.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/ToolContextBreakdownRow
  - term: ToolCoOccurrenceResponse
    definition: 'Object declared by the contract with fields: items.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/ToolCoOccurrenceResponse
  - term: ToolCoOccurrenceRow
    definition: 'Object declared by the contract with fields: otherTool, sharedTraces.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/ToolCoOccurrenceRow
  - term: ToolErrorBreakdownResponse
    definition: 'Object declared by the contract with fields: items.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/ToolErrorBreakdownResponse
  - term: ToolErrorBreakdownRow
    definition: 'Object declared by the contract with fields: key, sample, errorType, calls.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/ToolErrorBreakdownRow
  - term: PaginatedToolCalls
    definition: 'Object declared by the contract with fields: items, nextCursor, hasMore.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/PaginatedToolCalls
  - term: RecentToolCall
    definition: 'Object declared by the contract with fields: spanId, traceId, sessionId, startTime, durationNs, statusCode, statusMessage, errorType,
      toolCallId, toolInput, toolOutput, toolInputTruncated. (1 more)'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/RecentToolCall
  - term: ToolDetailResponse
    definition: 'Object declared by the contract with fields: definition, usage, errorsUsage.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/ToolDetailResponse
  - term: ToolDefinitionDetail
    definition: Latest definition seen for the tool. `null` when never offered in the range.
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/ToolDefinitionDetail
  - term: UserListResponse
    definition: 'Object declared by the contract with fields: items, totalCount, hasMore, limit, offset, costRollup.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/UserListResponse
  - term: ProjectUser
    definition: 'Object declared by the contract with fields: userId, userEmail, firstSeenAt, lastSeenAt, traceCount, sessionCount, errorSessionCount,
      tokensTotal, costTotalMicrocents, costAvgMicrocents, costMedianMicrocents.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/ProjectUser
  - term: UserCostRollup
    definition: Cost aggregates across every matching user, not just this page.
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/UserCostRollup
  - term: UsersOverviewResponse
    definition: 'Object declared by the contract with fields: uniqueUsers, newUsers, identifiedTraces, totalTraces, identifiedSessions, totalSessions,
      histogram, bucketSeconds, fromIso, toIso.'
    tags:
    - Object
    source: openapi/latitude-so-openapi.json#/components/schemas/UsersOverviewResponse