generated: '2026-10-08'
method: derived
generator: derive-vocabulary.py
source: openapi/_original/openapi.json
vocabulary:
  name: Citra Space Domain Vocabulary
  description: 'Terms declared by Citra Space''s own API contract: its resource groups, objects and enumerations, with the contract''s definitions.
    Derived, not authored.'
  version: '2026-10-08'
  terms:
  - term: ActionModality
    definition: 'Enumeration declared by the contract with values: optical, radar, doa.'
    tags:
    - Enumeration
    source: openapi/_original/openapi.json#/components/schemas/ActionModality
  - term: AddUserToGroupRequest
    definition: 'Object declared by the contract with fields: username.'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/AddUserToGroupRequest
  - term: AdminUserRead
    definition: 'Object declared by the contract with fields: creationEpoch, group, id, imageUploadQuotaBytes, imageUploadUsageBytes, isgroupadmin,
      preferences, tier, tierExpirationEpoch, uploadQuotaOverrideBytes, username.'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/AdminUserRead
  - term: AdvancedStateBundleResponse
    definition: 'Object declared by the contract with fields: cartesianState, dragCoefficient, epoch, meanBrouwerXp, meanKozaiGp, noradCatId,
      osculatingKeplerian, referenceFrame, satelliteName, srpCoefficient.'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/AdvancedStateBundleResponse
  - term: Alert
    definition: 'Object declared by the contract with fields: alertType, creationEpoch, eventEpoch, eventType, id, isRead, maneuverId, maneuverStatus,
      message, missionId, missionName, newValue. (14 more)'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/Alert
  - term: AlertSubscription
    definition: 'Object declared by the contract with fields: alertType, creationEpoch, id, isActive, maneuverStatusFilter, missionEventTypeFilter,
      missionId, missionName, satelliteEventTypeFilter, satelliteGroupId, satelliteGroupTitle, satelliteId. (6 more)'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/AlertSubscription
  - term: AlertSubscriptionCreate
    definition: 'Object declared by the contract with fields: alertType, maneuverStatusFilter, missionEventTypeFilter, missionId, satelliteEventTypeFilter,
      satelliteGroupId, satelliteId, scenarioId, targetType, userGroupIds.'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/AlertSubscriptionCreate
  - term: AlertSubscriptionUpdate
    definition: 'Object declared by the contract with fields: isActive, maneuverStatusFilter, missionEventTypeFilter, satelliteEventTypeFilter,
      userGroupIds.'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/AlertSubscriptionUpdate
  - term: AlertType
    definition: 'Enumeration declared by the contract with values: maneuver, new_uct, duplicate_uct, satellite_event, mission_event, launch_warning,
      launch_confirmed, phase_transition_recommended, custody_loss, risk_category_change, threat_object_correlated, threat_assessment_stale.'
    tags:
    - Enumeration
    source: openapi/_original/openapi.json#/components/schemas/AlertType
  - term: Antenna
    definition: 'Object declared by the contract with fields: activeStatus, automatedScheduling, calibrationAuditType, calibrationEvaluatedAt,
      calibrationStatus, captureTimeSeconds, creationEpoch, edgeSensorId, groundStationId, halfPowerBeamWidth, homeAzimuth, homeElevation. (17
      more)'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/Antenna
  - term: AntennaCreate
    definition: 'Object declared by the contract with fields: automatedScheduling, captureTimeSeconds, edgeSensorId, groundStationId, halfPowerBeamWidth,
      homeAzimuth, homeElevation, lastConnectionEpoch, maxFrequency, maxSlewRate, minElevation, minFrequency. (3 more)'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/AntennaCreate
  - term: AntennaUpdate
    definition: 'Object declared by the contract with fields: automatedScheduling, captureTimeSeconds, edgeSensorId, groundStationId, halfPowerBeamWidth,
      homeAzimuth, homeElevation, id, lastConnectionEpoch, maxFrequency, maxSlewRate, minElevation. (4 more)'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/AntennaUpdate
  - term: AntennaUpsert
    definition: 'Object declared by the contract with fields: automatedScheduling, captureTimeSeconds, edgeSensorId, groundStationId, halfPowerBeamWidth,
      homeAzimuth, homeElevation, id, lastConnectionEpoch, maxFrequency, maxSlewRate, minElevation. (4 more)'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/AntennaUpsert
  - term: AssociationCandidate
    definition: 'Object declared by the contract with fields: bestConfidence, elsetEpoch, matchCount, meanResidualKm, name, reviewStatus, satelliteId.'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/AssociationCandidate
  - term: AssociationCandidateScreeningRequest
    definition: 'Object declared by the contract with fields: excludeSatelliteId, maxElsetAgeDays, observations, scope.'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/AssociationCandidateScreeningRequest
  - term: AssociationCandidateScreeningResponse
    definition: 'Object declared by the contract with fields: candidates, observationCount, screenedSatellites.'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/AssociationCandidateScreeningResponse
  - term: AssociationClass
    definition: 'Classification of an observation relative to a subject satellite. Matches the domain glossary''s association classes: tagged
      (attributed to the subject), untagged (satellite_id IS NULL but gate-passing against the subject''s orbit), cross_tagged (attributed to
      another satellite while gate-passing).'
    tags:
    - Enumeration
    source: openapi/_original/openapi.json#/components/schemas/AssociationClass
  - term: AssociationJobState
    definition: 'Enumeration declared by the contract with values: running, complete, failed.'
    tags:
    - Enumeration
    source: openapi/_original/openapi.json#/components/schemas/AssociationJobState
  - term: AssociationJobStatus
    definition: 'Object declared by the contract with fields: detail, jobId, result, status.'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/AssociationJobStatus
  - term: AssociationJobSubmitted
    definition: 'Object declared by the contract with fields: jobId.'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/AssociationJobSubmitted
  - term: AssociationPoint
    definition: 'Object declared by the contract with fields: associationClass, confidence, crossTrackKm, epoch, inTrackKm, modality, observationId,
      provider, radialKm, residualKm, sensorId, taggedSatelliteAliases. (2 more)'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/AssociationPoint
  - term: AuditStatus
    definition: 'Enumeration declared by the contract with values: nominal, degraded.'
    tags:
    - Enumeration
    source: openapi/_original/openapi.json#/components/schemas/AuditStatus
  - term: AuditType
    definition: 'Enumeration declared by the contract with values: baseline, trend.'
    tags:
    - Enumeration
    source: openapi/_original/openapi.json#/components/schemas/AuditType
  - term: BatchCollectionRequestCreate
    definition: 'Schema for batch creation of collection requests across multiple satellites: one request per satellite a selected sensor sees,
      over the span it sees it, placed by the scheduler.'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/BatchCollectionRequestCreate
  - term: BatchCollectionRequestResponse
    definition: Response schema for batch collection request creation.
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/BatchCollectionRequestResponse
  - term: BoundSensor
    definition: A telescope or antenna bound to the device that asked.
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/BoundSensor
  - term: BoxApprovalRequest
    definition: 'Which box: by the token in its setup link, or by box id when the caller''s boxes see it.'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/BoxApprovalRequest
  - term: BoxApprovalResponse
    definition: 'Object declared by the contract with fields: name, short_id.'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/BoxApprovalResponse
  - term: BoxAssignment
    definition: A box given to a group that has not enrolled yet.
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/BoxAssignment
  - term: BoxAssignmentOutcome
    definition: What an assignment did.
    tags:
    - Enumeration
    source: openapi/_original/openapi.json#/components/schemas/BoxAssignmentOutcome
  - term: BoxAssignmentRequest
    definition: 'Give a box to a group: `null` assigns it to the admin alone. A limelink device is given the telescopes and antennas it is to
      serve (ADR 0011): the group''s, or the admin''s own for no group. A citra-sense box links its own and takes none.'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/BoxAssignmentRequest
  - term: BoxAssignmentResult
    definition: 'Object declared by the contract with fields: expires_at, outcome.'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/BoxAssignmentResult
  - term: BoxAssignments
    definition: What an admin sees to assign boxes (plan §3.8).
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/BoxAssignments
  - term: BoxCommandAnswer
    definition: A box's answer to a setup command.
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/BoxCommandAnswer
  - term: BoxCommandName
    definition: A setup command for a box itself, rather than for one of its sensors (plan WP-C6).
    tags:
    - Enumeration
    source: openapi/_original/openapi.json#/components/schemas/BoxCommandName
  - term: BoxCommandRequest
    definition: 'Object declared by the contract with fields: command, params.'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/BoxCommandRequest
  - term: BoxForApproval
    definition: A box the consent page shows before Allow.
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/BoxForApproval
  - term: BoxModality
    definition: A sensor type a box has installed (`citra-sense install --optical`, `--rf`), or a third-party sensor's kind under limelink.
    tags:
    - Enumeration
    source: openapi/_original/openapi.json#/components/schemas/BoxModality
  - term: BoxOwnerGroup
    definition: A group the caller may give a box to.
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/BoxOwnerGroup
  - term: BoxProduct
    definition: 'What a box runs (monorepo ADR 0011): citra-sense, or limelink, the device side of the link for a sensor that does not run citra-sense.
      Omitted means citra-sense.'
    tags:
    - Enumeration
    source: openapi/_original/openapi.json#/components/schemas/BoxProduct
  - term: Build
    definition: A build of a release for one hardware class and OS.
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/Build
  - term: CalibrationChannel
    definition: A measurement channel a sensor can be calibrated on (`sensor_calibration_audit` column family).
    tags:
    - Enumeration
    source: openapi/_original/openapi.json#/components/schemas/CalibrationChannel
  - term: CalibrationQuantity
    definition: Which statistic of a channel a calibration value describes.
    tags:
    - Enumeration
    source: openapi/_original/openapi.json#/components/schemas/CalibrationQuantity
  - term: CalibrationState
    definition: Whether a sensor's observations may be consumed by orbit determination; absence denies.
    tags:
    - Enumeration
    source: openapi/_original/openapi.json#/components/schemas/CalibrationState
  - term: CandidateMergeRequest
    definition: Body for merging a UCT candidate into an approved satellite.
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/CandidateMergeRequest
  - term: CartesianStateOut
    definition: 'Object declared by the contract with fields: positionKm, velocityKmS.'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/CartesianStateOut
  - term: CartesianVectorOut
    definition: 'Object declared by the contract with fields: x, y, z.'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/CartesianVectorOut
  - term: CatalogNumberResolveRequest
    definition: A batch of catalog-number tokens to resolve. Tokens are accepted as strings rather than integers because Alpha-5 catalog numbers
      (``A0001``) are not numeric, and because echoing the token the user actually typed back in the response is what makes the preview legible.
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/CatalogNumberResolveRequest
  - term: CatalogNumberResolveResponse
    definition: Resolution outcome, partitioned so the caller can preview both sides.
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/CatalogNumberResolveResponse
  - term: Channel
    definition: A release train a box follows for one product.
    tags:
    - Enumeration
    source: openapi/_original/openapi.json#/components/schemas/Channel
  - term: ChannelRollout
    definition: 'One product''s channel: what its signed plan names, and how far the rollout has got.'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/ChannelRollout
  - term: CharacterizationType
    definition: What a Characterization collects (keplime ADR 0079).
    tags:
    - Enumeration
    source: openapi/_original/openapi.json#/components/schemas/CharacterizationType
  - term: ChatFeedback
    definition: 'Object declared by the contract with fields: comment, conversationId, createdAt, environment, feedbackType, id, messageId, userId.'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/ChatFeedback
  - term: ChatFeedbackCreate
    definition: 'Object declared by the contract with fields: comment, feedbackType, messageId.'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/ChatFeedbackCreate
  - term: CitraElsetType
    definition: 'Enumeration declared by the contract with values: SGP4 with Kozai mean motion, SGP4 with Brouwer mean motion, SGP4-XP with Brouwer
      mean motion, SP with Brouwer mean motion.'
    tags:
    - Enumeration
    source: openapi/_original/openapi.json#/components/schemas/CitraElsetType
  - term: CitraObservationType
    definition: 'Enumeration declared by the contract with values: optical, radar, doa, rf.'
    tags:
    - Enumeration
    source: openapi/_original/openapi.json#/components/schemas/CitraObservationType
  - term: CitraSensors
    definition: 'Object declared by the contract with fields: antennas, telescopes.'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/CitraSensors
  - term: CloseApproach
    definition: 'Object declared by the contract with fields: distance, epoch, id, primarySatelliteId, primarySatelliteMeanMotion, primarySatelliteName,
      secondarySatelliteId, secondarySatelliteName.'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/CloseApproach
  - term: CollectionMode
    definition: 'Enumeration declared by the contract with values: Sample, Dwell, TimeSearch, GridSearch, Resolve.'
    tags:
    - Enumeration
    source: openapi/_original/openapi.json#/components/schemas/CollectionMode
  - term: CollectionRequest
    definition: CollectionRequest schema for reading
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/CollectionRequest
  - term: CollectionRequestCreate
    definition: CollectionRequest schema for creation
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/CollectionRequestCreate
  - term: CollectionRequestStatus
    definition: 'Status of a collection request. A collection request goes through these states: - PENDING: Initial state, waiting for window
      generation - SCHEDULED: Tasks have been created and are being scheduled/executed - READY_TO_PROCESS: All tasks succeeded, awaiting post-task
      processing - COMPLETED: All tasks and any post-task processing have completed successfully - FAILED: All tasks failed or window genera'
    tags:
    - Enumeration
    source: openapi/_original/openapi.json#/components/schemas/CollectionRequestStatus
  - term: CollectionRequestType
    definition: 'What a collection request asks for: one look (Sample, Dwell, TimeSearch, GridSearch or Resolve), or a Characterization or TDOA
      collection.'
    tags:
    - Enumeration
    source: openapi/_original/openapi.json#/components/schemas/CollectionRequestType
  - term: ConnectProduct
    definition: The device software asking for access. It names the minted token and the consent copy.
    tags:
    - Enumeration
    source: openapi/_original/openapi.json#/components/schemas/ConnectProduct
  - term: Conversation
    definition: 'Object declared by the contract with fields: createdAt, id, metadata, title, updatedAt, userId.'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/Conversation
  - term: ConversationCreate
    definition: 'Object declared by the contract with fields: metadata, title.'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/ConversationCreate
  - term: ConversationMessageResponse
    definition: 'Object declared by the contract with fields: inputTokens, message, outputTokens, stopReason.'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/ConversationMessageResponse
  - term: CoordinatedAccessWindow
    definition: A coordinated observation window where multiple ground stations can observe a satellite. For single-station access, the `accesses`
      list contains exactly one HorizonAccess. For multi-station/TDOA access, it contains one HorizonAccess per participating ground station,
      each with its own correct viewing geometry (azimuth, elevation, range). The overlap_start and overlap_end represent when ALL stations
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/CoordinatedAccessWindow
  - term: CorridorSnapshot
    definition: A corridor frozen onto a launch definition.
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/CorridorSnapshot
  - term: CounterIsrPreferences
    definition: 'Object declared by the contract with fields: satelliteGroupIds.'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/CounterIsrPreferences
  - term: CounterIsrPreferencesUpdate
    definition: 'Object declared by the contract with fields: satelliteGroupIds.'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/CounterIsrPreferencesUpdate
  - term: CountryOption
    definition: Country option for filtering.
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/CountryOption
  - term: CountryOptionList
    definition: List of country options.
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/CountryOptionList
  - term: CreateGroupRequest
    definition: 'Object declared by the contract with fields: adminUserId, maxSeats, name, tier, tierExpirationEpoch.'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/CreateGroupRequest
  - term: CurrentWeather
    definition: 'Object declared by the contract with fields: clouds, dewPoint, dt, feelsLike, humidity, pressure, sunrise, sunset, temp, uvi,
      visibility, weather. (3 more)'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/CurrentWeather
  - term: CustodyGrade
    definition: 'Enumeration declared by the contract with values: lost, degraded, tentative, confirmed.'
    tags:
    - Enumeration
    source: openapi/_original/openapi.json#/components/schemas/CustodyGrade
  - term: DOAObservationHistoryResponse
    definition: Response containing historical DOA observation data (hot/PostgreSQL only).
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/DOAObservationHistoryResponse
  - term: DOAObservationRead
    definition: 'Object declared by the contract with fields: creationEpoch, epoch, fdoa, fdoaNoise, frequency, id, migrationId, primaryAntennaId,
      primarySensorAltitude, primarySensorLatitude, primarySensorLongitude, reviewStatus. (11 more)'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/DOAObservationRead
  - term: DailyFeelsLike
    definition: 'Object declared by the contract with fields: day, eve, morn, night.'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/DailyFeelsLike
  - term: DailyForecast
    definition: 'Object declared by the contract with fields: astronomicalTwilightBegin, astronomicalTwilightEnd, clouds, dewPoint, dt, feelsLike,
      humidity, moonPhase, moonrise, moonset, pop, pressure. (10 more)'
    tags:
    - Object
    source: openapi/_original/openapi.json#/components/schemas/DailyForecast