Blue API Reference

Docs

REST reference for the Blue API.

128REST paths
213Schemas
159Operations
6Guide pages

REST API

Updated 8/25/2026, 2:44:05 AM
API Keys3 operations
GET/api/api-keys/Apikeyrouter.List Api Keys

List API keys with the actual key value redacted for security reasons.

Parameters

This endpoint does not declare parameters or a request body.

Responses

NameInTypeRequiredDescription
200application/jsonarray<ApiKey>NoSuccessful Response

Response body

200application/jsonarray<ApiKey>
NameInTypeRequiredDescription
bodybodyarray<ApiKey>YesNone
body[].idbodystringYesNone
body[].created_atbodystringYesNone
body[].updated_atbodystring | nullYesNone
body[].deleted_atbodystring | nullYesNone
body[].user_idbodystringYesNone
body[].prefixbodystringNoNone
body[].suffixbodystringYesNone
body[].namebodystringYesNone
body[].scopesbodyarray<AuthScope>YesNone
body[].device_idbodystring | nullNoNone
body[].expires_atbodystringYesNone
body[].last_used_atbodystring | nullNoNone
POST/api/api-keys/Apikeyrouter.Create Api Key

Create a new api key and returns it in full.

Parameters

NameInTypeRequiredDescription
user_idbodystring | nullNoNone
prefixbodystring | nullNoNone
namebodystring | nullNoNone
scopesbodyarray<AuthScope>NoNone
device_idbodystring | nullNoNone
time_to_live_secondsbodyinteger | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonCreateApiKeyResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonCreateApiKeyResponse
NameInTypeRequiredDescription
api_keybodyApiKeyYesFull API key model
api_key.idbodystringYesNone
api_key.created_atbodystringYesNone
api_key.updated_atbodystring | nullYesNone
api_key.deleted_atbodystring | nullYesNone
api_key.user_idbodystringYesNone
api_key.prefixbodystringNoNone
api_key.suffixbodystringYesNone
api_key.namebodystringYesNone
api_key.scopesbodyarray<AuthScope>YesNone
api_key.device_idbodystring | nullNoNone
api_key.expires_atbodystringYesNone
api_key.last_used_atbodystring | nullNoNone
raw_valuebodystringYesNone
DELETE/api/api-keys/{api_key_id}Apikeyrouter.Delete Api Key

Delete an API key by its ID. Returns the deleted API key.

Parameters

NameInTypeRequiredDescription
api_key_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonApiKeyNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonApiKey
NameInTypeRequiredDescription
idbodystringYesNone
created_atbodystringYesNone
updated_atbodystring | nullYesNone
deleted_atbodystring | nullYesNone
user_idbodystringYesNone
prefixbodystringNoNone
suffixbodystringYesNone
namebodystringYesNone
scopesbodyarray<AuthScope>YesNone
device_idbodystring | nullNoNone
expires_atbodystringYesNone
last_used_atbodystring | nullNoNone
Authentication3 operations
GET/api/auth/callbackAuthrouter.Browser Login Callback

Parameters

NameInTypeRequiredDescription
codequerystringYesNone
statequerystringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/auth/loginAuthrouter.Begin Browser Login

Parameters

This endpoint does not declare parameters or a request body.

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
POST/api/auth/logoutAuthrouter.Logout

Parameters

This endpoint does not declare parameters or a request body.

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
Blue Data Access2 operations
POST/api/auth/tile-sessionsCreate Tile Session

Parameters

This endpoint does not declare parameters or a request body.

Responses

NameInTypeRequiredDescription
204responseunknownNoSuccessful Response
GET/api/data-access/collections/{collection_id}/displays/{display_id}/tilejsonCollection Tilejson

Resolve a stable catalog display identity to runtime TileJSON.

Parameters

NameInTypeRequiredDescription
collection_idpathstringYesNone
display_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
Blue Feature Creation1 operations
POST/api/maps/{map_id}/featuresCreate a map feature collection

Creates user-authored geographic content backed by a Blue map layer. Use the request body's `type` discriminator to choose one of the documented feature schemas, then read the result through the returned OGC API Features links.

Parameters

NameInTypeRequiredDescription
map_idpathstringYesNone
bodyapplication/jsonBoundaryFeatureCreateRequest | NamedAreaInterestFeatureCreateRequest | AnnotationFeatureCreateRequest | GeoJsonFeatureCreateRequest | PositionAreaArtilleryFeatureCreateRequest | LogisticReleasePointFeatureCreateRequestYesNone

Request variants

Select a schema with the request body's type discriminator.

NameInTypeRequiredDescription
boundarytype discriminatorBoundaryFeatureCreateRequestYesCreate the map's area-of-operations boundary.
named_area_interesttype discriminatorNamedAreaInterestFeatureCreateRequestYesCreate a named rectangular area used by terrain and planning workflows.
annotationtype discriminatorAnnotationFeatureCreateRequestYesCreate user-authored point, line, or polygon map annotations.
geojsontype discriminatorGeoJsonFeatureCreateRequestYesCreate a general-purpose custom GeoJSON collection.
position_area_artillerytype discriminatorPositionAreaArtilleryFeatureCreateRequestYesCreate artillery position-area features used by planning workflows.
logistic_release_pointtype discriminatorLogisticReleasePointFeatureCreateRequestYesCreate logistics release-point features used by planning workflows.
boundary example
{
  "feature_collection": {
    "features": [
      {
        "geometry": {
          "coordinates": [
            [
              [
                -93.1213,
                31.1275
              ],
              [
                -93.1207,
                31.089
              ],
              [
                -93.0442,
                31.088
              ],
              [
                -93.0439,
                31.1283
              ],
              [
                -93.1213,
                31.1275
              ]
            ]
          ],
          "type": "Polygon"
        },
        "properties": {},
        "type": "Feature"
      }
    ],
    "type": "FeatureCollection"
  },
  "title": "Area of Operations",
  "type": "boundary"
}
named_area_interest example
{
  "description": "Primary observation area",
  "feature_collection": {
    "features": [
      {
        "geometry": {
          "coordinates": [
            [
              [
                -104.9,
                38.8
              ],
              [
                -104.7,
                38.8
              ],
              [
                -104.7,
                38.95
              ],
              [
                -104.9,
                38.95
              ],
              [
                -104.9,
                38.8
              ]
            ]
          ],
          "type": "Polygon"
        },
        "properties": {},
        "type": "Feature"
      }
    ],
    "type": "FeatureCollection"
  },
  "title": "Named Area of Interest 1",
  "type": "named_area_interest"
}
annotation example
{
  "feature_collection": {
    "features": [
      {
        "geometry": {
          "coordinates": [
            -104.8,
            38.88
          ],
          "type": "Point"
        },
        "properties": {
          "label": "Observation post"
        },
        "type": "Feature"
      }
    ],
    "type": "FeatureCollection"
  },
  "title": "Observation Notes",
  "type": "annotation"
}
geojson example
{
  "feature_collection": {
    "features": [
      {
        "geometry": {
          "coordinates": [
            -104.8,
            38.88
          ],
          "type": "Point"
        },
        "properties": {
          "source": "partner"
        },
        "type": "Feature"
      }
    ],
    "type": "FeatureCollection"
  },
  "title": "Partner Data",
  "type": "geojson"
}
position_area_artillery example
{
  "feature_collection": {
    "features": [
      {
        "geometry": {
          "coordinates": [
            [
              [
                -93.1213,
                31.1275
              ],
              [
                -93.1207,
                31.089
              ],
              [
                -93.0442,
                31.088
              ],
              [
                -93.0439,
                31.1283
              ],
              [
                -93.1213,
                31.1275
              ]
            ]
          ],
          "type": "Polygon"
        },
        "properties": {},
        "type": "Feature"
      }
    ],
    "type": "FeatureCollection"
  },
  "title": "Artillery Position Areas",
  "type": "position_area_artillery"
}
logistic_release_point example
{
  "feature_collection": {
    "features": [
      {
        "geometry": {
          "coordinates": [
            -104.8,
            38.88
          ],
          "type": "Point"
        },
        "properties": {
          "name": "LRP 1"
        },
        "type": "Feature"
      }
    ],
    "type": "FeatureCollection"
  },
  "title": "Logistic Release Points",
  "type": "logistic_release_point"
}

Responses

NameInTypeRequiredDescription
201application/jsonCreateMapFeatureResponseNoThe feature collection was created.
422application/jsonHTTPValidationErrorNoValidation Error

Response headers

NameInTypeRequiredDescription
Location201 headerstringNoAbsolute URL of the created OGC feature collection.

Response body

201application/jsonCreateMapFeatureResponse
NameInTypeRequiredDescription
map_layer_idbodystringYesBlue layer identifier backing this feature collection.
collection_idbodystringYesOGC collection identifier, formatted as layer--{map_layer_id}.
typebodyboundary | named_area_interest | annotation | geojson | position_area_artillery | logistic_release_pointYesSemantic feature type that was created.
titlebodystringYesHuman-readable OGC collection title.
feature_collectionbodyGeoJsonFeatureCollectionYesA GeoJSON FeatureCollection in CRS84 longitude/latitude coordinates.
feature_collection.typebodystringYesGeoJSON object type. Feature creation always accepts a FeatureCollection.
feature_collection.featuresbodyarray<object>YesGeoJSON Feature objects in [longitude, latitude] coordinate order.
linksbodyarray<MapFeatureLink>YesNone
links[].relbodycollection | itemsYesNone
links[].hrefbodystringYesNone
Blue Layer Management10 operations
POST/api/maps/{map_id}/layer-imports/annotationsMaplayerrouter.Upload Annotation Layer

Parameters

NameInTypeRequiredDescription
map_idpathstringYesNone
upload_filebodystringYesNone
namebodystring | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonBaseMapLayerSchemaNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonBaseMapLayerSchema
NameInTypeRequiredDescription
idbodystringYesNone
created_atbodystringYesNone
updated_atbodystring | nullYesNone
deleted_atbodystring | nullYesNone
user_idbodystringYesNone
map_idbodystringYesNone
namebodystringYesNone
json_databodyobject | string | nullYesNone
layer_typebodyMapLayerTypeYesNone
availabilitybodystringNoNone
POST/api/maps/{map_id}/layer-imports/flight-eventsMaplayerrouter.Upload Flight Events

Parameters

NameInTypeRequiredDescription
map_idpathstringYesNone
upload_filesbodyarray<string>YesNone
namebodystring | nullNoNone
class_color_mapbodystring | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonFlightEventImportResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonFlightEventImportResponse
NameInTypeRequiredDescription
layer_idbodystringYesNone
imported_eventsbodyintegerYesNone
imported_imagesbodyintegerYesNone
skipped_eventsbodyintegerYesNone
ignored_filesbodyintegerYesNone
warningsbodyarray<FlightEventImportWarningResponse>YesNone
warnings[].file_namebodystringYesNone
warnings[].codebodystringYesNone
warnings[].messagebodystringYesNone
GET/api/maps/{map_id}/layer-presentationMaplayerpresentationrouter.Get Layer Presentation

Parameters

NameInTypeRequiredDescription
map_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonLayerPresentationNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonLayerPresentation
NameInTypeRequiredDescription
schemaVersionbodyintegerNoNone
sectionsbodyobjectNoNone
sections.{key}bodyLayerSectionPresentationNoNone
sections.{key}.collapsedbodybooleanYesNone
sections.{key}.orderbodyarray<string>YesNone
nodesbodyobjectNoNone
nodes.{key}bodyLayerNodePresentationNoNone
nodes.{key}.visiblebodybooleanYesNone
nodes.{key}.expandedbodybooleanYesNone
nodes.{key}.opacitybodynumber | nullNoNone
PUT/api/maps/{map_id}/layer-presentationMaplayerpresentationrouter.Put Layer Presentation

Parameters

NameInTypeRequiredDescription
map_idpathstringYesNone
schemaVersionbodyintegerNoNone
sectionsbodyobjectNoNone
nodesbodyobjectNoNone

Responses

NameInTypeRequiredDescription
200application/jsonLayerPresentationNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonLayerPresentation
NameInTypeRequiredDescription
schemaVersionbodyintegerNoNone
sectionsbodyobjectNoNone
sections.{key}bodyLayerSectionPresentationNoNone
sections.{key}.collapsedbodybooleanYesNone
sections.{key}.orderbodyarray<string>YesNone
nodesbodyobjectNoNone
nodes.{key}bodyLayerNodePresentationNoNone
nodes.{key}.visiblebodybooleanYesNone
nodes.{key}.expandedbodybooleanYesNone
nodes.{key}.opacitybodynumber | nullNoNone
GET/api/maps/{map_id}/layersMaplayerrouter.Get Map Layers

Parameters

NameInTypeRequiredDescription
map_idpathstringYesNone
layer_typequeryMapLayerType | nullNoNone
sizequeryinteger | nullNoNone
pagequeryinteger | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonListMapLayerResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonListMapLayerResponse
NameInTypeRequiredDescription
map_layersbodyarray<BaseMapLayerSchema>YesNone
map_layers[].idbodystringYesNone
map_layers[].created_atbodystringYesNone
map_layers[].updated_atbodystring | nullYesNone
map_layers[].deleted_atbodystring | nullYesNone
map_layers[].user_idbodystringYesNone
map_layers[].map_idbodystringYesNone
map_layers[].namebodystringYesNone
map_layers[].json_databodyobject | string | nullYesNone
map_layers[].layer_typebodyMapLayerTypeYesNone
map_layers[].availabilitybodystringNoNone
paginationbodyPaginationResponseYesNone
pagination.current_pagebodyinteger | nullNoNone
pagination.total_pagesbodyinteger | nullNoNone
pagination.total_recordsbodyinteger | nullNoNone
POST/api/maps/{map_id}/layersMaplayerrouter.Create Layer

Parameters

NameInTypeRequiredDescription
map_idpathstringYesNone
namebodystringNoNone
layer_typebodyMapLayerTypeNoNone
json_databodyobject | nullNoNone
extra_databodyobject | nullNoNone

Responses

NameInTypeRequiredDescription
201application/jsonBaseMapLayerSchemaNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

201application/jsonBaseMapLayerSchema
NameInTypeRequiredDescription
idbodystringYesNone
created_atbodystringYesNone
updated_atbodystring | nullYesNone
deleted_atbodystring | nullYesNone
user_idbodystringYesNone
map_idbodystringYesNone
namebodystringYesNone
json_databodyobject | string | nullYesNone
layer_typebodyMapLayerTypeYesNone
availabilitybodystringNoNone
GET/api/maps/{map_id}/layers/{layer_id}Maplayerrouter.Get Map Layer

Parameters

NameInTypeRequiredDescription
map_idpathstringYesNone
layer_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonBaseMapLayerSchemaNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonBaseMapLayerSchema
NameInTypeRequiredDescription
idbodystringYesNone
created_atbodystringYesNone
updated_atbodystring | nullYesNone
deleted_atbodystring | nullYesNone
user_idbodystringYesNone
map_idbodystringYesNone
namebodystringYesNone
json_databodyobject | string | nullYesNone
layer_typebodyMapLayerTypeYesNone
availabilitybodystringNoNone
PATCH/api/maps/{map_id}/layers/{layer_id}Maplayerrouter.Update Map Layer

Parameters

NameInTypeRequiredDescription
map_idpathstringYesNone
layer_idpathstringYesNone
namebodystring | nullNoNone
layer_typebodyMapLayerType | nullNoNone
json_databodyobject | nullNoNone
extra_databodyobject | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonBaseMapLayerSchemaNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonBaseMapLayerSchema
NameInTypeRequiredDescription
idbodystringYesNone
created_atbodystringYesNone
updated_atbodystring | nullYesNone
deleted_atbodystring | nullYesNone
user_idbodystringYesNone
map_idbodystringYesNone
namebodystringYesNone
json_databodyobject | string | nullYesNone
layer_typebodyMapLayerTypeYesNone
availabilitybodystringNoNone
DELETE/api/maps/{map_id}/layers/{layer_id}Maplayerrouter.Delete Map Layer

Parameters

NameInTypeRequiredDescription
map_idpathstringYesNone
layer_idpathstringYesNone

Responses

NameInTypeRequiredDescription
204responseunknownNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error
GET/api/maps/{map_id}/layers/{layer_id}/flight-events/{event_id}/image-urlMaplayerrouter.Get Flight Event Image Url

Parameters

NameInTypeRequiredDescription
map_idpathstringYesNone
layer_idpathstringYesNone
event_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonFlightEventImageUrlResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonFlightEventImageUrlResponse
NameInTypeRequiredDescription
urlbodystringYesNone
expires_in_secondsbodyintegerYesNone
Documents4 operations
POST/api/documents/Documentrouter.Upload Documents

Parameters

NameInTypeRequiredDescription
filesbodyarray<string>YesNone
operation_idbodystringYesNone
typebodyDocumentTypeYesNone

Responses

NameInTypeRequiredDescription
200application/jsonListDocumentResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonListDocumentResponse
NameInTypeRequiredDescription
documentsbodyarray<DocumentResponse>YesNone
documents[].idbodystringYesNone
documents[].operation_idbodystringYesNone
documents[].namebodystringYesNone
documents[].typebodyDocumentTypeYesNone
documents[].file_typebodystringYesNone
documents[].sizebodyintegerYesNone
documents[].pathbodystringYesNone
documents[].num_tokensbodyintegerYesNone
documents[].statusbodyDocumentStatus | nullYesNone
documents[].created_atbodystring | nullNoNone
documents[].updated_atbodystring | nullNoNone
documents[].opened_atbodystring | nullNoNone
paginationbodyPaginationResponseYesNone
pagination.current_pagebodyinteger | nullNoNone
pagination.total_pagesbodyinteger | nullNoNone
pagination.total_recordsbodyinteger | nullNoNone
GET/api/documents/Documentrouter.Get Documents

Parameters

NameInTypeRequiredDescription
operation_idquerystringYesNone
sizequeryinteger | nullNoNone
pagequeryinteger | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonListDocumentResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonListDocumentResponse
NameInTypeRequiredDescription
documentsbodyarray<DocumentResponse>YesNone
documents[].idbodystringYesNone
documents[].operation_idbodystringYesNone
documents[].namebodystringYesNone
documents[].typebodyDocumentTypeYesNone
documents[].file_typebodystringYesNone
documents[].sizebodyintegerYesNone
documents[].pathbodystringYesNone
documents[].num_tokensbodyintegerYesNone
documents[].statusbodyDocumentStatus | nullYesNone
documents[].created_atbodystring | nullNoNone
documents[].updated_atbodystring | nullNoNone
documents[].opened_atbodystring | nullNoNone
paginationbodyPaginationResponseYesNone
pagination.current_pagebodyinteger | nullNoNone
pagination.total_pagesbodyinteger | nullNoNone
pagination.total_recordsbodyinteger | nullNoNone
DELETE/api/documents/{document_id}Documentrouter.Delete Document

Parameters

NameInTypeRequiredDescription
document_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonDocumentResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonDocumentResponse
NameInTypeRequiredDescription
idbodystringYesNone
operation_idbodystringYesNone
namebodystringYesNone
typebodyDocumentTypeYesNone
file_typebodystringYesNone
sizebodyintegerYesNone
pathbodystringYesNone
num_tokensbodyintegerYesNone
statusbodyDocumentStatus | nullYesNone
created_atbodystring | nullNoNone
updated_atbodystring | nullNoNone
opened_atbodystring | nullNoNone
GET/api/documents/{document_id}/presigned-urlDocumentrouter.Presigned Url

Parameters

NameInTypeRequiredDescription
document_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonstringNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonstring
NameInTypeRequiredDescription
bodybodystringYesNone
Entities6 operations
GET/api/operations/{operation_id}/entities/List operation entities

Lists active entities in the operation. Send If-None-Match with a prior ETag to receive 304 when unchanged.

Parameters

NameInTypeRequiredDescription
operation_idpathstringYesNone
if-none-matchheaderstring | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonEntityListResponseNoSuccessful Response
304responseunknownNoThe operation entity roster has not changed.
403responseunknownNoOperation access was denied or the API key lacks the ENTITIES scope.
422application/jsonHTTPValidationErrorNoValidation Error

Response headers

NameInTypeRequiredDescription
ETag200 headerstringNoValidator derived from entity IDs and revisions.

Response body

200application/jsonEntityListResponse
NameInTypeRequiredDescription
entitiesbodyarray<EntityResponse>YesNone
entities[].idbodystringYesNone
entities[].operation_idbodystringYesNone
entities[].revisionbodyintegerYesNone
entities[].profilebodyEntityProfile-OutputYesNone
entities[].current_statebodyEntityCurrentState-Output | nullNoNone
entities[].metadatabodyobjectYesNone
entities[].created_atbodystringYesNone
entities[].updated_atbodystring | nullNoNone
entities[].deleted_atbodystring | nullNoNone
POST/api/operations/{operation_id}/entities/Create an operation entity

Creates a typed operation entity. Known radio catalog defaults are completed and stored by the server.

Parameters

NameInTypeRequiredDescription
operation_idpathstringYesNone
profilebodyEntityProfile-InputYesNone
current_statebodyEntityCurrentState-Input | nullNoNone
metadatabodyobjectNoNone

Responses

NameInTypeRequiredDescription
201application/jsonEntityResponseNoSuccessful Response
403responseunknownNoOperation access was denied or the API key lacks the ENTITIES scope.
422application/jsonHTTPValidationErrorNoValidation Error

Response headers

NameInTypeRequiredDescription
ETag201 headerstringNoValidator for the created entity revision.

Response body

201application/jsonEntityResponse
NameInTypeRequiredDescription
idbodystringYesNone
operation_idbodystringYesNone
revisionbodyintegerYesNone
profilebodyEntityProfile-OutputYesNone
profile.unit_namebodystringYesHuman-readable unit or entity name.
profile.sidcbodystringYesMIL-STD-2525 symbol identification code.
profile.descriptionbodystring | nullNoFree-text entity description.
profile.affiliationbodyfriendly | hostile | neutral | unknown | nullNoOperational affiliation used by map styling and planning.
profile.higher_hqbodystring | nullNoName or identifier of the parent headquarters.
profile.support_prioritybodyinteger | nullNoRelative support priority; lower positive numbers represent higher priority.
profile.capabilitiesbodyarray<PersonnelCapability | EffectivenessPowerCapability | GroundMobilityCapability-Output | RadarCapability | NonRadarSensorCapability | ArtilleryCapability | UASCapability | CounterUASCapability | OrbitalLaunchCapability | GeneratorCapability | RadioCapability-Output | SuppliesCapability-Output | MedicalRosterCapability-Output>NoTyped optional behaviors and domain data attached to this entity. Capability IDs must be stable and unique. Unknown models are accepted, but capability types and fields must match the documented schema.
current_statebodyEntityCurrentState-Output | nullNoNone
current_state.observed_atbodystring | nullNoTime this state was observed; defaults to server receipt time when omitted.
current_state.locationbodyGeoJSONPoint | GeoJSONPointFeature | nullNoCanonical GeoJSON location using [longitude, latitude] coordinate order.
current_state.location.typebodystringNoNone
current_state.location.coordinatesbodyarray<unknown>YesGeoJSON coordinate pair in [longitude, latitude] order.
current_state.statsbodyOperationalStatsNoNone
current_state.stats.readinessbodynumberNoReadiness fraction from 0 to 1.
current_state.stats.equipment_conditionbodynumberNoEquipment-condition fraction from 0 to 1.
current_state.stats.ammunitionbodynumberNoAmmunition fraction from 0 to 1.
current_state.stats.fatiguebodynumberNoFatigue fraction from 0 to 1.
current_state.capability_statesbodyarray<GroundMobilityState | SuppliesState-Output | MedicalRosterState-Output>NoTyped changing state for capabilities referenced by capability_id.
metadatabodyobjectYesNone
created_atbodystringYesNone
updated_atbodystring | nullNoNone
deleted_atbodystring | nullNoNone
GET/api/operations/{operation_id}/entities/{entity_id}Get an operation entity

Parameters

NameInTypeRequiredDescription
operation_idpathstringYesNone
entity_idpathstringYesNone
if-none-matchheaderstring | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonEntityResponseNoSuccessful Response
304responseunknownNoThe entity revision has not changed.
403responseunknownNoAccess denied.
404responseunknownNoEntity not found.
422application/jsonHTTPValidationErrorNoValidation Error

Response headers

NameInTypeRequiredDescription
ETag200 headerstringNoValidator for this entity revision.

Response body

200application/jsonEntityResponse
NameInTypeRequiredDescription
idbodystringYesNone
operation_idbodystringYesNone
revisionbodyintegerYesNone
profilebodyEntityProfile-OutputYesNone
profile.unit_namebodystringYesHuman-readable unit or entity name.
profile.sidcbodystringYesMIL-STD-2525 symbol identification code.
profile.descriptionbodystring | nullNoFree-text entity description.
profile.affiliationbodyfriendly | hostile | neutral | unknown | nullNoOperational affiliation used by map styling and planning.
profile.higher_hqbodystring | nullNoName or identifier of the parent headquarters.
profile.support_prioritybodyinteger | nullNoRelative support priority; lower positive numbers represent higher priority.
profile.capabilitiesbodyarray<PersonnelCapability | EffectivenessPowerCapability | GroundMobilityCapability-Output | RadarCapability | NonRadarSensorCapability | ArtilleryCapability | UASCapability | CounterUASCapability | OrbitalLaunchCapability | GeneratorCapability | RadioCapability-Output | SuppliesCapability-Output | MedicalRosterCapability-Output>NoTyped optional behaviors and domain data attached to this entity. Capability IDs must be stable and unique. Unknown models are accepted, but capability types and fields must match the documented schema.
current_statebodyEntityCurrentState-Output | nullNoNone
current_state.observed_atbodystring | nullNoTime this state was observed; defaults to server receipt time when omitted.
current_state.locationbodyGeoJSONPoint | GeoJSONPointFeature | nullNoCanonical GeoJSON location using [longitude, latitude] coordinate order.
current_state.location.typebodystringNoNone
current_state.location.coordinatesbodyarray<unknown>YesGeoJSON coordinate pair in [longitude, latitude] order.
current_state.statsbodyOperationalStatsNoNone
current_state.stats.readinessbodynumberNoReadiness fraction from 0 to 1.
current_state.stats.equipment_conditionbodynumberNoEquipment-condition fraction from 0 to 1.
current_state.stats.ammunitionbodynumberNoAmmunition fraction from 0 to 1.
current_state.stats.fatiguebodynumberNoFatigue fraction from 0 to 1.
current_state.capability_statesbodyarray<GroundMobilityState | SuppliesState-Output | MedicalRosterState-Output>NoTyped changing state for capabilities referenced by capability_id.
metadatabodyobjectYesNone
created_atbodystringYesNone
updated_atbodystring | nullNoNone
deleted_atbodystring | nullNoNone
PUT/api/operations/{operation_id}/entities/{entity_id}Replace or restore an operation entity

Upserts the entity at the requested ID. Replacing an archived entity restores it.

Parameters

NameInTypeRequiredDescription
operation_idpathstringYesNone
entity_idpathstringYesNone
profilebodyEntityProfile-InputYesNone
current_statebodyEntityCurrentState-Input | nullNoNone
metadatabodyobjectNoNone

Responses

NameInTypeRequiredDescription
200application/jsonEntityResponseNoSuccessful Response
403responseunknownNoAccess denied.
422responseunknownNoEntity or capability data is invalid.

Response headers

NameInTypeRequiredDescription
ETag200 headerstringNoValidator for the stored entity revision.

Response body

200application/jsonEntityResponse
NameInTypeRequiredDescription
idbodystringYesNone
operation_idbodystringYesNone
revisionbodyintegerYesNone
profilebodyEntityProfile-OutputYesNone
profile.unit_namebodystringYesHuman-readable unit or entity name.
profile.sidcbodystringYesMIL-STD-2525 symbol identification code.
profile.descriptionbodystring | nullNoFree-text entity description.
profile.affiliationbodyfriendly | hostile | neutral | unknown | nullNoOperational affiliation used by map styling and planning.
profile.higher_hqbodystring | nullNoName or identifier of the parent headquarters.
profile.support_prioritybodyinteger | nullNoRelative support priority; lower positive numbers represent higher priority.
profile.capabilitiesbodyarray<PersonnelCapability | EffectivenessPowerCapability | GroundMobilityCapability-Output | RadarCapability | NonRadarSensorCapability | ArtilleryCapability | UASCapability | CounterUASCapability | OrbitalLaunchCapability | GeneratorCapability | RadioCapability-Output | SuppliesCapability-Output | MedicalRosterCapability-Output>NoTyped optional behaviors and domain data attached to this entity. Capability IDs must be stable and unique. Unknown models are accepted, but capability types and fields must match the documented schema.
current_statebodyEntityCurrentState-Output | nullNoNone
current_state.observed_atbodystring | nullNoTime this state was observed; defaults to server receipt time when omitted.
current_state.locationbodyGeoJSONPoint | GeoJSONPointFeature | nullNoCanonical GeoJSON location using [longitude, latitude] coordinate order.
current_state.location.typebodystringNoNone
current_state.location.coordinatesbodyarray<unknown>YesGeoJSON coordinate pair in [longitude, latitude] order.
current_state.statsbodyOperationalStatsNoNone
current_state.stats.readinessbodynumberNoReadiness fraction from 0 to 1.
current_state.stats.equipment_conditionbodynumberNoEquipment-condition fraction from 0 to 1.
current_state.stats.ammunitionbodynumberNoAmmunition fraction from 0 to 1.
current_state.stats.fatiguebodynumberNoFatigue fraction from 0 to 1.
current_state.capability_statesbodyarray<GroundMobilityState | SuppliesState-Output | MedicalRosterState-Output>NoTyped changing state for capabilities referenced by capability_id.
metadatabodyobjectYesNone
created_atbodystringYesNone
updated_atbodystring | nullNoNone
deleted_atbodystring | nullNoNone
PATCH/api/operations/{operation_id}/entities/{entity_id}Patch an operation entity

Deep-merges objects, replaces arrays, and replaces metadata when metadata is supplied.

Parameters

NameInTypeRequiredDescription
operation_idpathstringYesNone
entity_idpathstringYesNone
profilebodyEntityProfilePatch | nullNoNone
current_statebodyEntityCurrentStatePatch | nullNoNone
metadatabodyobject | nullNoNone
expected_revisionbodyinteger | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonEntityResponseNoSuccessful Response
403responseunknownNoAccess denied.
404responseunknownNoEntity not found.
409responseunknownNoexpected_revision does not match the stored revision.
422application/jsonHTTPValidationErrorNoValidation Error

Response headers

NameInTypeRequiredDescription
ETag200 headerstringNoValidator for the updated entity revision.

Response body

200application/jsonEntityResponse
NameInTypeRequiredDescription
idbodystringYesNone
operation_idbodystringYesNone
revisionbodyintegerYesNone
profilebodyEntityProfile-OutputYesNone
profile.unit_namebodystringYesHuman-readable unit or entity name.
profile.sidcbodystringYesMIL-STD-2525 symbol identification code.
profile.descriptionbodystring | nullNoFree-text entity description.
profile.affiliationbodyfriendly | hostile | neutral | unknown | nullNoOperational affiliation used by map styling and planning.
profile.higher_hqbodystring | nullNoName or identifier of the parent headquarters.
profile.support_prioritybodyinteger | nullNoRelative support priority; lower positive numbers represent higher priority.
profile.capabilitiesbodyarray<PersonnelCapability | EffectivenessPowerCapability | GroundMobilityCapability-Output | RadarCapability | NonRadarSensorCapability | ArtilleryCapability | UASCapability | CounterUASCapability | OrbitalLaunchCapability | GeneratorCapability | RadioCapability-Output | SuppliesCapability-Output | MedicalRosterCapability-Output>NoTyped optional behaviors and domain data attached to this entity. Capability IDs must be stable and unique. Unknown models are accepted, but capability types and fields must match the documented schema.
current_statebodyEntityCurrentState-Output | nullNoNone
current_state.observed_atbodystring | nullNoTime this state was observed; defaults to server receipt time when omitted.
current_state.locationbodyGeoJSONPoint | GeoJSONPointFeature | nullNoCanonical GeoJSON location using [longitude, latitude] coordinate order.
current_state.location.typebodystringNoNone
current_state.location.coordinatesbodyarray<unknown>YesGeoJSON coordinate pair in [longitude, latitude] order.
current_state.statsbodyOperationalStatsNoNone
current_state.stats.readinessbodynumberNoReadiness fraction from 0 to 1.
current_state.stats.equipment_conditionbodynumberNoEquipment-condition fraction from 0 to 1.
current_state.stats.ammunitionbodynumberNoAmmunition fraction from 0 to 1.
current_state.stats.fatiguebodynumberNoFatigue fraction from 0 to 1.
current_state.capability_statesbodyarray<GroundMobilityState | SuppliesState-Output | MedicalRosterState-Output>NoTyped changing state for capabilities referenced by capability_id.
metadatabodyobjectYesNone
created_atbodystringYesNone
updated_atbodystring | nullNoNone
deleted_atbodystring | nullNoNone
DELETE/api/operations/{operation_id}/entities/{entity_id}Archive an operation entity

Soft-archives the entity and returns its final archived representation.

Parameters

NameInTypeRequiredDescription
operation_idpathstringYesNone
entity_idpathstringYesNone
expected_revisionqueryinteger | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonEntityResponseNoSuccessful Response
403responseunknownNoAccess denied.
404responseunknownNoEntity not found.
409responseunknownNoexpected_revision does not match the stored revision.
422application/jsonHTTPValidationErrorNoValidation Error

Response headers

NameInTypeRequiredDescription
ETag200 headerstringNoValidator for the archived entity revision.

Response body

200application/jsonEntityResponse
NameInTypeRequiredDescription
idbodystringYesNone
operation_idbodystringYesNone
revisionbodyintegerYesNone
profilebodyEntityProfile-OutputYesNone
profile.unit_namebodystringYesHuman-readable unit or entity name.
profile.sidcbodystringYesMIL-STD-2525 symbol identification code.
profile.descriptionbodystring | nullNoFree-text entity description.
profile.affiliationbodyfriendly | hostile | neutral | unknown | nullNoOperational affiliation used by map styling and planning.
profile.higher_hqbodystring | nullNoName or identifier of the parent headquarters.
profile.support_prioritybodyinteger | nullNoRelative support priority; lower positive numbers represent higher priority.
profile.capabilitiesbodyarray<PersonnelCapability | EffectivenessPowerCapability | GroundMobilityCapability-Output | RadarCapability | NonRadarSensorCapability | ArtilleryCapability | UASCapability | CounterUASCapability | OrbitalLaunchCapability | GeneratorCapability | RadioCapability-Output | SuppliesCapability-Output | MedicalRosterCapability-Output>NoTyped optional behaviors and domain data attached to this entity. Capability IDs must be stable and unique. Unknown models are accepted, but capability types and fields must match the documented schema.
current_statebodyEntityCurrentState-Output | nullNoNone
current_state.observed_atbodystring | nullNoTime this state was observed; defaults to server receipt time when omitted.
current_state.locationbodyGeoJSONPoint | GeoJSONPointFeature | nullNoCanonical GeoJSON location using [longitude, latitude] coordinate order.
current_state.location.typebodystringNoNone
current_state.location.coordinatesbodyarray<unknown>YesGeoJSON coordinate pair in [longitude, latitude] order.
current_state.statsbodyOperationalStatsNoNone
current_state.stats.readinessbodynumberNoReadiness fraction from 0 to 1.
current_state.stats.equipment_conditionbodynumberNoEquipment-condition fraction from 0 to 1.
current_state.stats.ammunitionbodynumberNoAmmunition fraction from 0 to 1.
current_state.stats.fatiguebodynumberNoFatigue fraction from 0 to 1.
current_state.capability_statesbodyarray<GroundMobilityState | SuppliesState-Output | MedicalRosterState-Output>NoTyped changing state for capabilities referenced by capability_id.
metadatabodyobjectYesNone
created_atbodystringYesNone
updated_atbodystring | nullNoNone
deleted_atbodystring | nullNoNone
Entity Resolution4 operations
GET/api/entity-resolution/entities/{entity_id}/historyEntityresolutionrouter.List Entity History

Parameters

NameInTypeRequiredDescription
entity_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/entity-resolution/entities/{entity_id}/observationsEntityresolutionrouter.List Entity Observations

Parameters

NameInTypeRequiredDescription
entity_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
DELETE/api/entity-resolution/entities/clearEntityresolutionrouter.Clear Entity Resolution

Parameters

This endpoint does not declare parameters or a request body.

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/entity-resolution/entities/currentEntityresolutionrouter.List Current Entities

Parameters

This endpoint does not declare parameters or a request body.

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
entropy5 operations
GET/api/entropy/v1/flight-operationsList Flight Operations

Parameters

This endpoint does not declare parameters or a request body.

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/entropy/v1/flight-operations/{flight_op_id}/vehiclesList Vehicles

Parameters

NameInTypeRequiredDescription
flight_op_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
PUT/api/entropy/v1/flight-operations/{flight_op_id}/vehicles/{vehicle_id}/missions/{mission_id}Upload Mission

Parameters

NameInTypeRequiredDescription
flight_op_idpathstringYesNone
vehicle_idpathstringYesNone
mission_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
POST/api/entropy/v1/flight-operations/{flight_op_id}/vehicles/{vehicle_id}/missions/{mission_id}/executionStart Mission Execution

Parameters

NameInTypeRequiredDescription
flight_op_idpathstringYesNone
vehicle_idpathstringYesNone
mission_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/entropy/v1/flight-operations/{flight_op_id}/vehicles/{vehicle_id}/statusGet Vehicle Status

Parameters

NameInTypeRequiredDescription
flight_op_idpathstringYesNone
vehicle_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
Groups7 operations
POST/api/groups/Grouprouter.Create Group

Parameters

NameInTypeRequiredDescription
namebodystringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonGroupResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonGroupResponse
NameInTypeRequiredDescription
idbodystringYesNone
namebodystringYesNone
number_membersbodyintegerYesNone
created_atbodystring | nullNoNone
updated_atbodystring | nullNoNone
GET/api/groups/Grouprouter.Get Groups

Parameters

NameInTypeRequiredDescription
not_in_operation_idquerystring | nullNoNone
sizequeryinteger | nullNoNone
pagequeryinteger | nullNoNone
queryquerystring | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonListGroupResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonListGroupResponse
NameInTypeRequiredDescription
groupsbodyarray<GroupResponse>YesNone
groups[].idbodystringYesNone
groups[].namebodystringYesNone
groups[].number_membersbodyintegerYesNone
groups[].created_atbodystring | nullNoNone
groups[].updated_atbodystring | nullNoNone
paginationbodyPaginationResponseYesNone
pagination.current_pagebodyinteger | nullNoNone
pagination.total_pagesbodyinteger | nullNoNone
pagination.total_recordsbodyinteger | nullNoNone
PUT/api/groups/{group_id}Grouprouter.Update Group

Parameters

NameInTypeRequiredDescription
group_idpathstringYesNone
namebodystring | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonMessageResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonMessageResponse
NameInTypeRequiredDescription
messagebodystringNoNone
GET/api/groups/{group_id}/membersGroupmemberrouter.Get Group Members By Group

Parameters

NameInTypeRequiredDescription
group_idpathstringYesNone
sizequeryinteger | nullNoNone
pagequeryinteger | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonListMemberInGroupResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonListMemberInGroupResponse
NameInTypeRequiredDescription
membersbodyarray<MemberInGroupResponse>YesNone
members[].group_member_idbodystringYesNone
members[].member_idbodystringYesNone
members[].namebodystringYesNone
members[].rolebodyUserRoleYesNone
members[].picture_urlbodystring | nullNoNone
members[].emailbodystringYesNone
members[].created_atbodystring | nullNoNone
members[].updated_atbodystring | nullNoNone
paginationbodyPaginationResponseYesNone
pagination.current_pagebodyinteger | nullNoNone
pagination.total_pagesbodyinteger | nullNoNone
pagination.total_recordsbodyinteger | nullNoNone
POST/api/groups/membersGroupmemberrouter.Create Group Member

Parameters

NameInTypeRequiredDescription
group_idbodystringYesNone
member_idbodystringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonMessageResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonMessageResponse
NameInTypeRequiredDescription
messagebodystringNoNone
GET/api/groups/membersGroupmemberrouter.Get Group Members

Parameters

NameInTypeRequiredDescription
sizequeryinteger | nullNoNone
pagequeryinteger | nullNoNone
queryquerystring | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonListGroupMemberResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonListGroupMemberResponse
NameInTypeRequiredDescription
group_membersbodyarray<GroupMemberResponse>YesNone
group_members[].member_idbodystringYesNone
group_members[].namebodystringYesNone
group_members[].emailbodystringYesNone
group_members[].rolebodyUserRoleYesNone
group_members[].picture_urlbodystring | nullNoNone
group_members[].groupsbodyarray<Group>YesNone
group_members[].created_atbodystring | nullNoNone
group_members[].updated_atbodystring | nullNoNone
paginationbodyPaginationResponseYesNone
pagination.current_pagebodyinteger | nullNoNone
pagination.total_pagesbodyinteger | nullNoNone
pagination.total_recordsbodyinteger | nullNoNone
DELETE/api/groups/members/{group_member_id}Groupmemberrouter.Delete Group Member

Parameters

NameInTypeRequiredDescription
group_member_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonMessageResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonMessageResponse
NameInTypeRequiredDescription
messagebodystringNoNone
Health1 operations
GET/api/health/Healthrouter.Health

Parameters

This endpoint does not declare parameters or a request body.

Responses

NameInTypeRequiredDescription
200application/jsonMessageResponseNoSuccessful Response

Response body

200application/jsonMessageResponse
NameInTypeRequiredDescription
messagebodystringNoNone
Jobs3 operations
POST/api/jobs/Jobsrouter.Create Job

Parameters

NameInTypeRequiredDescription
job_typebodyintegerYesNone
namebodystringYesNone
input_databodyobjectYesNone
retriesbodyinteger | nullNoNone
timeout_secondsbodyinteger | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonJobResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonJobResponse
NameInTypeRequiredDescription
idbodystringYesNone
created_atbodystringYesNone
updated_atbodystring | nullYesNone
deleted_atbodystring | nullYesNone
user_idbodystring | nullYesNone
parent_job_idbodystring | nullNoNone
namebodystringYesNone
job_typebodyintegerYesNone
input_databodyobject | nullYesNone
statusbodyJobStatusYesNone
resultbodyJobResultYesNone
result_contextbodyobject | nullYesNone
progress_contextbodyobject | nullNoNone
retries_remainingbodyintegerYesNone
worker_idbodystring | nullYesNone
started_atbodystring | nullYesNone
cancel_requested_atbodystring | nullNoNone
available_atbodystringYesNone
timeout_secondsbodyintegerYesNone
GET/api/jobs/Jobsrouter.Get Jobs

Parameters

NameInTypeRequiredDescription
sizequeryinteger | nullNoNone
pagequeryinteger | nullNoNone
job_idquerystring | nullNoNone
namequerystring | nullNoNone
job_typequeryintegerYesNone
statusqueryJobStatus | nullNoNone
resultqueryJobResult | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonListJobsResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonListJobsResponse
NameInTypeRequiredDescription
jobsbodyarray<JobResponse>YesNone
jobs[].idbodystringYesNone
jobs[].created_atbodystringYesNone
jobs[].updated_atbodystring | nullYesNone
jobs[].deleted_atbodystring | nullYesNone
jobs[].user_idbodystring | nullYesNone
jobs[].parent_job_idbodystring | nullNoNone
jobs[].namebodystringYesNone
jobs[].job_typebodyintegerYesNone
jobs[].input_databodyobject | nullYesNone
jobs[].statusbodyJobStatusYesNone
jobs[].resultbodyJobResultYesNone
jobs[].result_contextbodyobject | nullYesNone
jobs[].progress_contextbodyobject | nullNoNone
jobs[].retries_remainingbodyintegerYesNone
jobs[].worker_idbodystring | nullYesNone
jobs[].started_atbodystring | nullYesNone
jobs[].cancel_requested_atbodystring | nullNoNone
jobs[].available_atbodystringYesNone
jobs[].timeout_secondsbodyintegerYesNone
paginationbodyPaginationResponse | nullYesNone
pagination.current_pagebodyinteger | nullNoNone
pagination.total_pagesbodyinteger | nullNoNone
pagination.total_recordsbodyinteger | nullNoNone
POST/api/jobs/cancel/{job_id}Jobsrouter.Cancel Job

Parameters

NameInTypeRequiredDescription
job_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonJobResponse | nullNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonJobResponse | null
NameInTypeRequiredDescription
idbodystringYesNone
created_atbodystringYesNone
updated_atbodystring | nullYesNone
deleted_atbodystring | nullYesNone
user_idbodystring | nullYesNone
parent_job_idbodystring | nullNoNone
namebodystringYesNone
job_typebodyintegerYesNone
input_databodyobject | nullYesNone
statusbodyJobStatusYesNone
resultbodyJobResultYesNone
result_contextbodyobject | nullYesNone
progress_contextbodyobject | nullNoNone
retries_remainingbodyintegerYesNone
worker_idbodystring | nullYesNone
started_atbodystring | nullYesNone
cancel_requested_atbodystring | nullNoNone
available_atbodystringYesNone
timeout_secondsbodyintegerYesNone
Landing Zones1 operations
POST/api/landing-zones/Landingzonerouter.Survey Landing Zones

Parameters

NameInTypeRequiredDescription
map_idbodystringYesNone
boundary_shapebodyobjectYesNone
platformbodyAircraftPlatformYesNone
mobility_configbodyPathfindingMobilityConfig | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonBaseMapLayerSchemaNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonBaseMapLayerSchema
NameInTypeRequiredDescription
idbodystringYesNone
created_atbodystringYesNone
updated_atbodystring | nullYesNone
deleted_atbodystring | nullYesNone
user_idbodystringYesNone
map_idbodystringYesNone
namebodystringYesNone
json_databodyobject | string | nullYesNone
layer_typebodyMapLayerTypeYesNone
availabilitybodystringNoNone
Maps4 operations
POST/api/maps/Maprouter.Create Map

Parameters

NameInTypeRequiredDescription
operation_idbodystringYesNone
namebodystring | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonMapSchemaNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonMapSchema
NameInTypeRequiredDescription
idbodystringYesNone
created_atbodystringYesNone
updated_atbodystring | nullYesNone
deleted_atbodystring | nullYesNone
user_idbodystringYesNone
operation_idbodystringYesNone
namebodystringYesNone
GET/api/maps/Maprouter.Get Maps

Parameters

NameInTypeRequiredDescription
operation_idquerystringYesNone
sizequeryinteger | nullNoNone
pagequeryinteger | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonListMapResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonListMapResponse
NameInTypeRequiredDescription
mapsbodyarray<MapSchema>YesNone
maps[].idbodystringYesNone
maps[].created_atbodystringYesNone
maps[].updated_atbodystring | nullYesNone
maps[].deleted_atbodystring | nullYesNone
maps[].user_idbodystringYesNone
maps[].operation_idbodystringYesNone
maps[].namebodystringYesNone
paginationbodyPaginationResponseYesNone
pagination.current_pagebodyinteger | nullNoNone
pagination.total_pagesbodyinteger | nullNoNone
pagination.total_recordsbodyinteger | nullNoNone
PUT/api/maps/{map_id}Maprouter.Update Map

Parameters

NameInTypeRequiredDescription
map_idpathstringYesNone
namebodystringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonMessageResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonMessageResponse
NameInTypeRequiredDescription
messagebodystringNoNone
DELETE/api/maps/{map_id}Maprouter.Delete Map

Parameters

NameInTypeRequiredDescription
map_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonMessageResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonMessageResponse
NameInTypeRequiredDescription
messagebodystringNoNone
MSS4 operations
POST/api/mss/Mssrouter.Generate Mss

Parameters

NameInTypeRequiredDescription
enginequeryobject | nullNoNone
session_factoryqueryobject | nullNoNone
pool_sizequeryinteger | nullNoNone
max_overflowqueryinteger | nullNoNone
inputsbodyobjectYesNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/mss/Mssrouter.Get Mss

Parameters

NameInTypeRequiredDescription
map_idquerystring | nullYesNone
enginequeryobject | nullNoNone
session_factoryqueryobject | nullNoNone
pool_sizequeryinteger | nullNoNone
max_overflowqueryinteger | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonMessageResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonMessageResponse
NameInTypeRequiredDescription
messagebodystringNoNone
POST/api/mss/cancelMssrouter.Cancel Mss

Parameters

NameInTypeRequiredDescription
map_idquerystringYesNone
enginequeryobject | nullNoNone
session_factoryqueryobject | nullNoNone
pool_sizequeryinteger | nullNoNone
max_overflowqueryinteger | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
POST/api/mss/rankMssrouter.Mss Rank

Parameters

NameInTypeRequiredDescription
enginequeryobject | nullNoNone
session_factoryqueryobject | nullNoNone
pool_sizequeryinteger | nullNoNone
max_overflowqueryinteger | nullNoNone
map_idbodystringYesNone
weightsbodyobjectYesNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
odin2 operations
GET/api/odin/unitsOdinrouter.Search Units

Search ODIN units by name and return the complete result set.

Parameters

NameInTypeRequiredDescription
namequerystringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/odin/units/{unit_id}/hierarchyOdinrouter.Get Unit Hierarchy

Get the ODIN order of battle rooted at a unit.

Parameters

NameInTypeRequiredDescription
unit_idpathintegerYesNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
OGC — Global Directory2 operations
GET/api/ogcGlobal Ogc Directory

Parameters

This endpoint does not declare parameters or a request body.

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/ogc/Global Ogc Directory

Parameters

This endpoint does not declare parameters or a request body.

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
OGC — Map Directory2 operations
GET/api/maps/{map_id}/ogcMap Ogc Directory

Parameters

NameInTypeRequiredDescription
map_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/maps/{map_id}/ogc/Map Ogc Directory

Parameters

NameInTypeRequiredDescription
map_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
OGC — STAC12 operations
GET/api/ogc/stacLanding Page

Parameters

This endpoint does not declare parameters or a request body.

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/ogc/stac/Landing Page

Parameters

This endpoint does not declare parameters or a request body.

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/ogc/stac/apiService Description

Parameters

This endpoint does not declare parameters or a request body.

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/ogc/stac/catalogs/{source_id}Source Catalog

Parameters

NameInTypeRequiredDescription
source_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/ogc/stac/collectionsCollections

Parameters

NameInTypeRequiredDescription
qquerystring | nullNoNone
sourcequerystring | nullNoNone
access_scopequerystring | nullNoNone
has_displayqueryboolean | nullNoNone
limitqueryintegerNoNone
tokenquerystring | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/ogc/stac/collections/{collection_id}Collection

Parameters

NameInTypeRequiredDescription
collection_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/ogc/stac/collections/{collection_id}/itemsCollection Items

Parameters

NameInTypeRequiredDescription
collection_idpathstringYesNone
limitqueryintegerNoNone
tokenquerystring | nullNoNone
bboxquerystring | nullNoNone
datetimequerystring | nullNoNone

Responses

NameInTypeRequiredDescription
200application/geo+jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/geo+jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/ogc/stac/collections/{collection_id}/items/{item_id}Item

Parameters

NameInTypeRequiredDescription
collection_idpathstringYesNone
item_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/geo+jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/geo+jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/ogc/stac/conformanceConformance

Parameters

This endpoint does not declare parameters or a request body.

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
{key}bodyarray<string>NoNone
GET/api/ogc/stac/extensions/blue/v1.0.0/schema.jsonBlue Extension Schema

Parameters

This endpoint does not declare parameters or a request body.

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
POST/api/ogc/stac/searchSearch Post

Parameters

NameInTypeRequiredDescription
bodyapplication/jsonobjectYesNone

Responses

NameInTypeRequiredDescription
200application/geo+jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/geo+jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
OGC API — Global Tiles9 operations
GET/api/ogc/tilesGlobal Landing Page Without Redirect

Parameters

This endpoint does not declare parameters or a request body.

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/ogc/tiles/Globalogctilesrouter.Landing Page

Parameters

This endpoint does not declare parameters or a request body.

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/ogc/tiles/apiGlobalogctilesrouter.Api Definition

Parameters

This endpoint does not declare parameters or a request body.

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/ogc/tiles/collectionsGlobalogctilesrouter.Collections

Parameters

This endpoint does not declare parameters or a request body.

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/ogc/tiles/collections/{collection_id}Globalogctilesrouter.Collection

Parameters

NameInTypeRequiredDescription
collection_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/ogc/tiles/collections/{collection_id}/tilesGlobalogctilesrouter.Tilesets

Parameters

NameInTypeRequiredDescription
collection_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonTileSetsListNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonTileSetsList
NameInTypeRequiredDescription
tilesetsbodyarray<TileSetMetadata>YesNone
tilesets[].titlebodystringYesNone
tilesets[].descriptionbodystringYesNone
tilesets[].dataTypebodymap | vector | coverageYesNone
tilesets[].crsbodystringYesNone
tilesets[].mediaTypesbodyarray<string>YesNone
tilesets[].tileMatrixSetURIbodystringYesNone
tilesets[].tileMatrixSetLimitsbodyarray<TileMatrixLimit>YesNone
tilesets[].linksbodyarray<OgcLink>YesNone
tilesets[].blue:source_layerbodystring | nullNoNone
tilesets[].blue:encodingbodystring | nullNoNone
GET/api/ogc/tiles/collections/{collection_id}/tiles/{tile_matrix_set_id}Globalogctilesrouter.Tileset

Parameters

NameInTypeRequiredDescription
collection_idpathstringYesNone
tile_matrix_set_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonTileSetMetadataNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonTileSetMetadata
NameInTypeRequiredDescription
titlebodystringYesNone
descriptionbodystringYesNone
dataTypebodymap | vector | coverageYesNone
crsbodystringYesNone
mediaTypesbodyarray<string>YesNone
tileMatrixSetURIbodystringYesNone
tileMatrixSetLimitsbodyarray<TileMatrixLimit>YesNone
tileMatrixSetLimits[].tileMatrixbodystringYesNone
tileMatrixSetLimits[].minTileRowbodyintegerYesNone
tileMatrixSetLimits[].maxTileRowbodyintegerYesNone
tileMatrixSetLimits[].minTileColbodyintegerYesNone
tileMatrixSetLimits[].maxTileColbodyintegerYesNone
linksbodyarray<OgcLink>YesNone
links[].hrefbodystringYesNone
links[].relbodystringYesNone
links[].typebodystring | nullNoNone
links[].titlebodystring | nullNoNone
links[].templatedbodyboolean | nullNoNone
blue:source_layerbodystring | nullNoNone
blue:encodingbodystring | nullNoNone
GET/api/ogc/tiles/collections/{collection_id}/tiles/{tile_matrix_set_id}/{tile_matrix}/{tile_row}/{tile_col}.{tile_format}Globalogctilesrouter.Tile

Parameters

NameInTypeRequiredDescription
collection_idpathstringYesNone
tile_matrix_set_idpathstringYesNone
tile_matrixpathstringYesNone
tile_rowpathstringYesNone
tile_colpathstringYesNone
tile_formatpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/ogc/tiles/conformanceGlobalogctilesrouter.Conformance

Parameters

This endpoint does not declare parameters or a request body.

Responses

NameInTypeRequiredDescription
200application/jsonConformanceDeclarationNoSuccessful Response

Response body

200application/jsonConformanceDeclaration
NameInTypeRequiredDescription
conformsTobodyarray<string>YesNone
OGC API — Map Features8 operations
GET/api/maps/{map_id}/ogc/featuresLanding Page Without Redirect

Parameters

NameInTypeRequiredDescription
map_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/maps/{map_id}/ogc/features/Ogcfeaturesrouter.Landing Page

Parameters

NameInTypeRequiredDescription
map_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/maps/{map_id}/ogc/features/apiOgcfeaturesrouter.Api Definition

Parameters

NameInTypeRequiredDescription
map_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/maps/{map_id}/ogc/features/collectionsOgcfeaturesrouter.Collections

Parameters

NameInTypeRequiredDescription
map_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/maps/{map_id}/ogc/features/collections/{collection_id}Ogcfeaturesrouter.Collection

Parameters

NameInTypeRequiredDescription
map_idpathstringYesNone
collection_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/maps/{map_id}/ogc/features/collections/{collection_id}/itemsOgcfeaturesrouter.Items

Parameters

NameInTypeRequiredDescription
map_idpathstringYesNone
collection_idpathstringYesNone
bboxquerystring | nullNoNone
datetimequerystring | nullNoNone
limitquerystring | nullNoNone
offsetquerystring | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/maps/{map_id}/ogc/features/collections/{collection_id}/items/{feature_id}Ogcfeaturesrouter.Item

Parameters

NameInTypeRequiredDescription
map_idpathstringYesNone
collection_idpathstringYesNone
feature_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/maps/{map_id}/ogc/features/conformanceOgcfeaturesrouter.Conformance

Parameters

NameInTypeRequiredDescription
map_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
OGC API — Map Tiles9 operations
GET/api/maps/{map_id}/ogc/tilesMap Landing Page Without Redirect

Parameters

NameInTypeRequiredDescription
map_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/maps/{map_id}/ogc/tiles/Mapogctilesrouter.Landing Page

Parameters

NameInTypeRequiredDescription
map_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/maps/{map_id}/ogc/tiles/apiMapogctilesrouter.Api Definition

Parameters

NameInTypeRequiredDescription
map_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/maps/{map_id}/ogc/tiles/collectionsMapogctilesrouter.Collections

Parameters

NameInTypeRequiredDescription
map_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/maps/{map_id}/ogc/tiles/collections/{collection_id}Mapogctilesrouter.Collection

Parameters

NameInTypeRequiredDescription
map_idpathstringYesNone
collection_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/maps/{map_id}/ogc/tiles/collections/{collection_id}/tilesMapogctilesrouter.Tilesets

Parameters

NameInTypeRequiredDescription
map_idpathstringYesNone
collection_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonTileSetsListNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonTileSetsList
NameInTypeRequiredDescription
tilesetsbodyarray<TileSetMetadata>YesNone
tilesets[].titlebodystringYesNone
tilesets[].descriptionbodystringYesNone
tilesets[].dataTypebodymap | vector | coverageYesNone
tilesets[].crsbodystringYesNone
tilesets[].mediaTypesbodyarray<string>YesNone
tilesets[].tileMatrixSetURIbodystringYesNone
tilesets[].tileMatrixSetLimitsbodyarray<TileMatrixLimit>YesNone
tilesets[].linksbodyarray<OgcLink>YesNone
tilesets[].blue:source_layerbodystring | nullNoNone
tilesets[].blue:encodingbodystring | nullNoNone
GET/api/maps/{map_id}/ogc/tiles/collections/{collection_id}/tiles/{tile_matrix_set_id}Mapogctilesrouter.Tileset

Parameters

NameInTypeRequiredDescription
map_idpathstringYesNone
collection_idpathstringYesNone
tile_matrix_set_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonTileSetMetadataNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonTileSetMetadata
NameInTypeRequiredDescription
titlebodystringYesNone
descriptionbodystringYesNone
dataTypebodymap | vector | coverageYesNone
crsbodystringYesNone
mediaTypesbodyarray<string>YesNone
tileMatrixSetURIbodystringYesNone
tileMatrixSetLimitsbodyarray<TileMatrixLimit>YesNone
tileMatrixSetLimits[].tileMatrixbodystringYesNone
tileMatrixSetLimits[].minTileRowbodyintegerYesNone
tileMatrixSetLimits[].maxTileRowbodyintegerYesNone
tileMatrixSetLimits[].minTileColbodyintegerYesNone
tileMatrixSetLimits[].maxTileColbodyintegerYesNone
linksbodyarray<OgcLink>YesNone
links[].hrefbodystringYesNone
links[].relbodystringYesNone
links[].typebodystring | nullNoNone
links[].titlebodystring | nullNoNone
links[].templatedbodyboolean | nullNoNone
blue:source_layerbodystring | nullNoNone
blue:encodingbodystring | nullNoNone
GET/api/maps/{map_id}/ogc/tiles/collections/{collection_id}/tiles/{tile_matrix_set_id}/{tile_matrix}/{tile_row}/{tile_col}.{tile_format}Mapogctilesrouter.Tile

Parameters

NameInTypeRequiredDescription
map_idpathstringYesNone
collection_idpathstringYesNone
tile_matrix_set_idpathstringYesNone
tile_matrixpathstringYesNone
tile_rowpathstringYesNone
tile_colpathstringYesNone
tile_formatpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/maps/{map_id}/ogc/tiles/conformanceMapogctilesrouter.Conformance

Parameters

NameInTypeRequiredDescription
map_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonConformanceDeclarationNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonConformanceDeclaration
NameInTypeRequiredDescription
conformsTobodyarray<string>YesNone
Operations10 operations
POST/api/operations/Operationrouter.Create Operation

Parameters

NameInTypeRequiredDescription
unit_idbodystring | nullNoNone
parent_idbodystring | nullNoNone
namebodystringYesNone
unitbodystringYesNone
branchbodystringYesNone
echelonbodystringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonOperationResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonOperationResponse
NameInTypeRequiredDescription
idbodystringYesNone
user_idbodystringYesNone
unit_idbodystring | nullNoNone
parent_idbodystring | nullYesNone
namebodystringYesNone
unitbodystringYesNone
branchbodystringYesNone
echelonbodystringYesNone
policiesbodyarray<string>YesNone
created_atbodystring | nullNoNone
updated_atbodystring | nullNoNone
GET/api/operations/Operationrouter.Get Operations

Parameters

NameInTypeRequiredDescription
unit_idquerystring | nullNoNone
parent_idquerystring | nullNoNone
force_allquerybooleanNoNone
queryquerystring | nullNoNone
sizequeryinteger | nullNoNone
pagequeryinteger | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonListOperationResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonListOperationResponse
NameInTypeRequiredDescription
operationsbodyarray<OperationResponse>YesNone
operations[].idbodystringYesNone
operations[].user_idbodystringYesNone
operations[].unit_idbodystring | nullNoNone
operations[].parent_idbodystring | nullYesNone
operations[].namebodystringYesNone
operations[].unitbodystringYesNone
operations[].branchbodystringYesNone
operations[].echelonbodystringYesNone
operations[].policiesbodyarray<string>YesNone
operations[].created_atbodystring | nullNoNone
operations[].updated_atbodystring | nullNoNone
paginationbodyPaginationResponseYesNone
pagination.current_pagebodyinteger | nullNoNone
pagination.total_pagesbodyinteger | nullNoNone
pagination.total_recordsbodyinteger | nullNoNone
PUT/api/operations/{operation_id}Operationrouter.Update Operation

Parameters

NameInTypeRequiredDescription
operation_idpathstringYesNone
unit_idbodystring | nullNoNone
parent_idbodystring | nullNoNone
namebodystring | nullNoNone
unitbodystring | nullNoNone
branchbodystring | nullNoNone
echelonbodystring | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonMessageResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonMessageResponse
NameInTypeRequiredDescription
messagebodystringNoNone
GET/api/operations/{operation_id}Operationrouter.Get Operation

Parameters

NameInTypeRequiredDescription
operation_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonOperationResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonOperationResponse
NameInTypeRequiredDescription
idbodystringYesNone
user_idbodystringYesNone
unit_idbodystring | nullNoNone
parent_idbodystring | nullYesNone
namebodystringYesNone
unitbodystringYesNone
branchbodystringYesNone
echelonbodystringYesNone
policiesbodyarray<string>YesNone
created_atbodystring | nullNoNone
updated_atbodystring | nullNoNone
DELETE/api/operations/{operation_id}Operationrouter.Delete Operation

Parameters

NameInTypeRequiredDescription
operation_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonOperationResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonOperationResponse
NameInTypeRequiredDescription
idbodystringYesNone
user_idbodystringYesNone
unit_idbodystring | nullNoNone
parent_idbodystring | nullYesNone
namebodystringYesNone
unitbodystringYesNone
branchbodystringYesNone
echelonbodystringYesNone
policiesbodyarray<string>YesNone
created_atbodystring | nullNoNone
updated_atbodystring | nullNoNone
GET/api/operations/{operation_id}/generated-maps/{asset_path}Operationrouter.Get Generated Map

Parameters

NameInTypeRequiredDescription
operation_idpathstringYesNone
asset_pathpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
POST/api/operations/{operation_id}/membersOperationmemberrouter.Create Operation Member

Parameters

NameInTypeRequiredDescription
operation_idpathstringYesNone
membersbodyarray<OperationMember>YesNone

Responses

NameInTypeRequiredDescription
200application/jsonMessageResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonMessageResponse
NameInTypeRequiredDescription
messagebodystringNoNone
GET/api/operations/{operation_id}/membersOperationmemberrouter.Get Operation Members

Parameters

NameInTypeRequiredDescription
operation_idpathstringYesNone
sizequeryinteger | nullNoNone
pagequeryinteger | nullNoNone
queryquerystring | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonListOperationMemberResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonListOperationMemberResponse
NameInTypeRequiredDescription
operation_membersbodyarray<OperationMemberResponse>YesNone
operation_members[].idbodystringYesNone
operation_members[].member_idbodystringYesNone
operation_members[].namebodystringYesNone
operation_members[].emailbodystring | nullNoNone
operation_members[].picture_urlbodystring | nullNoNone
operation_members[].generationbodybooleanYesNone
operation_members[].typebodyOperationMemberTypeYesNone
operation_members[].rolesbodyUserRole | nullNoNone
operation_members[].created_atbodystring | nullNoNone
operation_members[].updated_atbodystring | nullNoNone
paginationbodyPaginationResponseYesNone
pagination.current_pagebodyinteger | nullNoNone
pagination.total_pagesbodyinteger | nullNoNone
pagination.total_recordsbodyinteger | nullNoNone
PUT/api/operations/{operation_id}/members/{operation_member_id}Operationmemberrouter.Update Operation Member

Parameters

NameInTypeRequiredDescription
operation_idpathstringYesNone
operation_member_idpathstringYesNone
generationbodyboolean | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonMessageResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonMessageResponse
NameInTypeRequiredDescription
messagebodystringNoNone
DELETE/api/operations/{operation_id}/members/{operation_member_id}Operationmemberrouter.Delete Operation Member

Parameters

NameInTypeRequiredDescription
operation_idpathstringYesNone
operation_member_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonMessageResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonMessageResponse
NameInTypeRequiredDescription
messagebodystringNoNone
Pathfinding1 operations
POST/api/pathfinding/Pathfindingrouter.Find Path

Parameters

NameInTypeRequiredDescription
map_idbodystringYesNone
echelonbodystringYesNone
formationbodystringYesNone
boundary_shapebodyobjectYesNone
path_startbodyarray<unknown>YesNone
path_endbodyarray<unknown>YesNone
cell_size_metersbodyinteger | nullNoNone
corridor_width_kmbodynumber | nullNoNone
mobility_configbodyPathfindingMobilityConfig | nullNoNone
pathfinding_weightsbodyPathfindingWeights | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonPathfindingResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonPathfindingResponse
NameInTypeRequiredDescription
pathsbodyarray<PathResponseObject>NoNone
paths[].pathbodystringYesNone
paths[].canalizing_polygonsbodystringYesNone
paths[].overwatch_pointsbodystringYesNone
SAPIENT8 operations
POST/api/sapient/v1/eventsReceive a SAPIENT gateway event

Gateway webhook for node lifecycle and BSI Flex 335 v2 messages. Requires a bearer API key with the SAPIENT scope.

Parameters

NameInTypeRequiredDescription
schemaVersionbodystringYesNone
eventIdbodystringYesNone
protocolVersionbodystringYesNone
eventTypebodystringYesNone
occurredAtbodystringYesNone
connectionIdbodystringYesNone
peerAddrbodystringYesNone
nodeIdbodystring | nullNoNone
messageTypebodystring | nullNoNone
messagebodyobject | nullNoNone

Responses

NameInTypeRequiredDescription
204responseunknownNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error
GET/api/sapient/v1/nodesList registered SAPIENT nodes

Lists registered nodes with connectivity, capabilities, current scenario association, position, and latest task state.

Parameters

This endpoint does not declare parameters or a request body.

Responses

NameInTypeRequiredDescription
200application/jsonNodesResponseNoSuccessful Response

Response body

200application/jsonNodesResponse
NameInTypeRequiredDescription
nodesbodyarray<NodeView>YesNone
nodes[].idbodystringYesNone
nodes[].nodeIdbodystringYesNone
nodes[].displayNamebodystringYesNone
nodes[].sidcbodystringYesNone
nodes[].connectedbodybooleanYesNone
nodes[].scenarioIdbodystring | nullYesNone
nodes[].positionbodyPosition | nullNoNone
nodes[].supportedCommandsbodyarray<string>YesNone
nodes[].registrationbodyobject | nullYesNone
nodes[].statusReportbodyobject | nullYesNone
nodes[].latestErrorbodyobject | nullYesNone
nodes[].lastSeenAtbodystringYesNone
nodes[].currentTaskbodyTaskView | nullNoNone
PUT/api/sapient/v1/nodes/{node_id}/scenarioAdd a SAPIENT node to a scenario

Associates a registered node with one Blue scenario so its live state and detections can be rendered there.

Parameters

NameInTypeRequiredDescription
node_idpathstringYesNone
scenarioIdbodystringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonNodeViewNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonNodeView
NameInTypeRequiredDescription
idbodystringYesNone
nodeIdbodystringYesNone
displayNamebodystringYesNone
sidcbodystringYesNone
connectedbodybooleanYesNone
scenarioIdbodystring | nullYesNone
positionbodyPosition | nullNoNone
position.latitudebodynumberYesNone
position.longitudebodynumberYesNone
position.altitudeMbodynumber | nullNoNone
supportedCommandsbodyarray<string>YesNone
registrationbodyobject | nullYesNone
statusReportbodyobject | nullYesNone
latestErrorbodyobject | nullYesNone
lastSeenAtbodystringYesNone
currentTaskbodyTaskView | nullNoNone
currentTask.taskIdbodystringYesNone
currentTask.scenarioIdbodystring | nullYesNone
currentTask.nodeIdbodystringYesNone
currentTask.taskTypebodystringYesNone
currentTask.sapientCommandbodystringYesNone
currentTask.statusbodySapientTaskStatusYesNone
currentTask.waypointsbodyarray<object>YesNone
currentTask.reasonsbodyarray<string>YesNone
currentTask.submittedAtbodystring | nullYesNone
currentTask.acceptedAtbodystring | nullYesNone
currentTask.rejectedAtbodystring | nullYesNone
currentTask.completedAtbodystring | nullYesNone
currentTask.failedAtbodystring | nullYesNone
currentTask.stopRequestedAtbodystring | nullYesNone
currentTask.stoppedAtbodystring | nullYesNone
currentTask.createdAtbodystringYesNone
currentTask.updatedAtbodystring | nullYesNone
DELETE/api/sapient/v1/nodes/{node_id}/scenarioRemove a SAPIENT node from its scenario

Removes the scenario association without deleting the node, its detections, or its task history.

Parameters

NameInTypeRequiredDescription
node_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonNodeViewNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonNodeView
NameInTypeRequiredDescription
idbodystringYesNone
nodeIdbodystringYesNone
displayNamebodystringYesNone
sidcbodystringYesNone
connectedbodybooleanYesNone
scenarioIdbodystring | nullYesNone
positionbodyPosition | nullNoNone
position.latitudebodynumberYesNone
position.longitudebodynumberYesNone
position.altitudeMbodynumber | nullNoNone
supportedCommandsbodyarray<string>YesNone
registrationbodyobject | nullYesNone
statusReportbodyobject | nullYesNone
latestErrorbodyobject | nullYesNone
lastSeenAtbodystringYesNone
currentTaskbodyTaskView | nullNoNone
currentTask.taskIdbodystringYesNone
currentTask.scenarioIdbodystring | nullYesNone
currentTask.nodeIdbodystringYesNone
currentTask.taskTypebodystringYesNone
currentTask.sapientCommandbodystringYesNone
currentTask.statusbodySapientTaskStatusYesNone
currentTask.waypointsbodyarray<object>YesNone
currentTask.reasonsbodyarray<string>YesNone
currentTask.submittedAtbodystring | nullYesNone
currentTask.acceptedAtbodystring | nullYesNone
currentTask.rejectedAtbodystring | nullYesNone
currentTask.completedAtbodystring | nullYesNone
currentTask.failedAtbodystring | nullYesNone
currentTask.stopRequestedAtbodystring | nullYesNone
currentTask.stoppedAtbodystring | nullYesNone
currentTask.createdAtbodystringYesNone
currentTask.updatedAtbodystring | nullYesNone
DELETE/api/sapient/v1/scenarios/{scenario_id}/detections/{detection_id}Delete Detection

Remove a detection that is currently visible in the requested scenario.

Parameters

NameInTypeRequiredDescription
scenario_idpathstringYesNone
detection_idpathstringYesNone

Responses

NameInTypeRequiredDescription
204responseunknownNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error
GET/api/sapient/v1/scenarios/{scenario_id}/stateGet live SAPIENT scenario state

Returns associated nodes, their latest task state, and detections reported by those nodes.

Parameters

NameInTypeRequiredDescription
scenario_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonScenarioStateResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonScenarioStateResponse
NameInTypeRequiredDescription
scenarioIdbodystringYesNone
generatedAtbodystringYesNone
nodesbodyarray<NodeView>YesNone
nodes[].idbodystringYesNone
nodes[].nodeIdbodystringYesNone
nodes[].displayNamebodystringYesNone
nodes[].sidcbodystringYesNone
nodes[].connectedbodybooleanYesNone
nodes[].scenarioIdbodystring | nullYesNone
nodes[].positionbodyPosition | nullNoNone
nodes[].supportedCommandsbodyarray<string>YesNone
nodes[].registrationbodyobject | nullYesNone
nodes[].statusReportbodyobject | nullYesNone
nodes[].latestErrorbodyobject | nullYesNone
nodes[].lastSeenAtbodystringYesNone
nodes[].currentTaskbodyTaskView | nullNoNone
detectionsbodyarray<DetectionView>YesNone
detections[].idbodystringYesNone
detections[].sourceNodeIdbodystringYesNone
detections[].objectIdbodystringYesNone
detections[].reportIdbodystring | nullYesNone
detections[].displayNamebodystringYesNone
detections[].sidcbodystringYesNone
detections[].positionbodyPosition | nullNoNone
detections[].classificationbodystring | nullYesNone
detections[].confidencebodynumber | nullYesNone
detections[].statebodystring | nullNoNone
detections[].taskIdbodystring | nullNoNone
detections[].detectionReportbodyobject | nullYesNone
detections[].lastSeenAtbodystringYesNone
POST/api/sapient/v1/tasksSubmit a reconnaissance task

Sends a tick-1 WGS84 reconnaissance route to an online node that advertises MOVE_TO support. Offline tasks fail immediately and are not queued.

Parameters

NameInTypeRequiredDescription
scenarioIdbodystringYesNone
nodeIdbodystringYesNone
tickbodyintegerYesNone
taskTypebodystringYesNone
waypointsbodyarray<Waypoint>YesNone
namebodystring | nullNoNone
descriptionbodystring | nullNoNone

Responses

NameInTypeRequiredDescription
202application/jsonTaskResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

202application/jsonTaskResponse
NameInTypeRequiredDescription
taskbodyTaskViewYesNone
task.taskIdbodystringYesNone
task.scenarioIdbodystring | nullYesNone
task.nodeIdbodystringYesNone
task.taskTypebodystringYesNone
task.sapientCommandbodystringYesNone
task.statusbodySapientTaskStatusYesNone
task.waypointsbodyarray<object>YesNone
task.reasonsbodyarray<string>YesNone
task.submittedAtbodystring | nullYesNone
task.acceptedAtbodystring | nullYesNone
task.rejectedAtbodystring | nullYesNone
task.completedAtbodystring | nullYesNone
task.failedAtbodystring | nullYesNone
task.stopRequestedAtbodystring | nullYesNone
task.stoppedAtbodystring | nullYesNone
task.createdAtbodystringYesNone
task.updatedAtbodystring | nullYesNone
POST/api/sapient/v1/tasks/{task_id}/stopStop an active SAPIENT task

Sends CONTROL_STOP for a submitted or accepted SAPIENT task and records the resulting lifecycle state.

Parameters

NameInTypeRequiredDescription
task_idpathstringYesNone

Responses

NameInTypeRequiredDescription
202application/jsonTaskResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

202application/jsonTaskResponse
NameInTypeRequiredDescription
taskbodyTaskViewYesNone
task.taskIdbodystringYesNone
task.scenarioIdbodystring | nullYesNone
task.nodeIdbodystringYesNone
task.taskTypebodystringYesNone
task.sapientCommandbodystringYesNone
task.statusbodySapientTaskStatusYesNone
task.waypointsbodyarray<object>YesNone
task.reasonsbodyarray<string>YesNone
task.submittedAtbodystring | nullYesNone
task.acceptedAtbodystring | nullYesNone
task.rejectedAtbodystring | nullYesNone
task.completedAtbodystring | nullYesNone
task.failedAtbodystring | nullYesNone
task.stopRequestedAtbodystring | nullYesNone
task.stoppedAtbodystring | nullYesNone
task.createdAtbodystringYesNone
task.updatedAtbodystring | nullYesNone
Scenarios15 operations
POST/api/scenarios/Scenariorouter.Create

Parameters

NameInTypeRequiredDescription
map_idbodystringYesNone
namebodystring | nullNoNone
json_databodyobject | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonScenarioSchemaNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonScenarioSchema
NameInTypeRequiredDescription
idbodystringYesNone
created_atbodystringYesNone
updated_atbodystring | nullYesNone
deleted_atbodystring | nullYesNone
map_idbodystringYesNone
namebodystringYesNone
json_databodyobject | string | nullYesNone
schema_versionbodyinteger | nullNoNone
revisionbodyintegerNoNone
starts_atbodystring | nullNoNone
snapshot_duration_hoursbodynumber | nullNoNone
GET/api/scenarios/Scenariorouter.Get Scenarios

Parameters

NameInTypeRequiredDescription
map_idquerystring | nullNoNone
sizequeryinteger | nullNoNone
pagequeryinteger | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonListScenarioResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonListScenarioResponse
NameInTypeRequiredDescription
scenariosbodyarray<ScenarioSchema>YesNone
scenarios[].idbodystringYesNone
scenarios[].created_atbodystringYesNone
scenarios[].updated_atbodystring | nullYesNone
scenarios[].deleted_atbodystring | nullYesNone
scenarios[].map_idbodystringYesNone
scenarios[].namebodystringYesNone
scenarios[].json_databodyobject | string | nullYesNone
scenarios[].schema_versionbodyinteger | nullNoNone
scenarios[].revisionbodyintegerNoNone
scenarios[].starts_atbodystring | nullNoNone
scenarios[].snapshot_duration_hoursbodynumber | nullNoNone
paginationbodyPaginationResponseYesNone
pagination.current_pagebodyinteger | nullNoNone
pagination.total_pagesbodyinteger | nullNoNone
pagination.total_recordsbodyinteger | nullNoNone
GET/api/scenarios/{scenario_id}Scenariorouter.Get Scenario

Parameters

NameInTypeRequiredDescription
scenario_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonScenarioSchemaNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonScenarioSchema
NameInTypeRequiredDescription
idbodystringYesNone
created_atbodystringYesNone
updated_atbodystring | nullYesNone
deleted_atbodystring | nullYesNone
map_idbodystringYesNone
namebodystringYesNone
json_databodyobject | string | nullYesNone
schema_versionbodyinteger | nullNoNone
revisionbodyintegerNoNone
starts_atbodystring | nullNoNone
snapshot_duration_hoursbodynumber | nullNoNone
PUT/api/scenarios/{scenario_id}Scenariorouter.Update Scenario

Parameters

NameInTypeRequiredDescription
scenario_idpathstringYesNone
namebodystring | nullNoNone
json_databodyobject | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonScenarioSchemaNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonScenarioSchema
NameInTypeRequiredDescription
idbodystringYesNone
created_atbodystringYesNone
updated_atbodystring | nullYesNone
deleted_atbodystring | nullYesNone
map_idbodystringYesNone
namebodystringYesNone
json_databodyobject | string | nullYesNone
schema_versionbodyinteger | nullNoNone
revisionbodyintegerNoNone
starts_atbodystring | nullNoNone
snapshot_duration_hoursbodynumber | nullNoNone
DELETE/api/scenarios/{scenario_id}Scenariorouter.Delete Scenario

Parameters

NameInTypeRequiredDescription
scenario_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonScenarioSchemaNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonScenarioSchema
NameInTypeRequiredDescription
idbodystringYesNone
created_atbodystringYesNone
updated_atbodystring | nullYesNone
deleted_atbodystring | nullYesNone
map_idbodystringYesNone
namebodystringYesNone
json_databodyobject | string | nullYesNone
schema_versionbodyinteger | nullNoNone
revisionbodyintegerNoNone
starts_atbodystring | nullNoNone
snapshot_duration_hoursbodynumber | nullNoNone
POST/api/scenarios/{scenario_id}/entitiesScenariorouter.Add Scenario Entity

Parameters

NameInTypeRequiredDescription
scenario_idpathstringYesNone
expected_scenario_revisionbodyinteger | nullNoNone
entity_idbodystring | nullNoNone
entitybodyEntityWriteRequest | nullNoNone
expected_entity_revisionbodyinteger | nullNoNone
current_statebodyEntityCurrentStatePatch | nullNoNone
introduced_at_tickbodyintegerNoNone
associated_with_idbodystring | nullNoNone
planning_snapshotbodyScenarioPlanningSnapshot-InputYesNone
initial_state_overridesbodyScenarioInitialStateOverrides-InputNoNone

Responses

NameInTypeRequiredDescription
200application/jsonScenarioMembershipMutationResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonScenarioMembershipMutationResponse
NameInTypeRequiredDescription
scenariobodyScenarioV2ResponseYesNone
scenario.idbodystringYesNone
scenario.map_idbodystringYesNone
scenario.namebodystringYesNone
scenario.schema_versionbodyintegerYesNone
scenario.revisionbodyintegerYesNone
scenario.starts_atbodystringYesNone
scenario.snapshot_duration_hoursbodynumberYesNone
scenario.planbodyScenarioPlanV2-OutputYesNone
scenario.plan.schema_versionbodyintegerNoNone
scenario.plan.capability_resolver_versionbodystringNoVersion of the frontend capability resolver/default set used to materialize the plan.
scenario.plan.ticksbodyarray<ScenarioTickDelta-Output>NoNone
scenario.membershipsbodyarray<ScenarioMembershipResponse>YesNone
scenario.input_hashbodystringYesNone
scenario.created_atbodystringYesNone
scenario.updated_atbodystring | nullNoNone
membershipbodyScenarioMembershipResponse | nullNoNone
membership.idbodystringYesNone
membership.entity_idbodystringYesNone
membership.entity_revisionbodyintegerYesNone
membership.planning_snapshotbodyScenarioPlanningSnapshot-OutputYesNone
membership.planning_snapshot.profilebodyEntityProfile-OutputYesNone
membership.planning_snapshot.current_statebodyEntityCurrentState-Output | nullNoNone
membership.planning_snapshot.metadatabodyobjectNoNone
membership.introduced_at_tickbodyintegerYesNone
membership.associated_with_idbodystring | nullNoNone
membership.initial_state_overridesbodyScenarioInitialStateOverrides-OutputNoNone
membership.initial_state_overrides.statsbodyOperationalStatsPatchNoNone
membership.initial_state_overrides.capability_statesbodyarray<GroundMobilityState | SuppliesState-Output | MedicalRosterState-Output>NoNone
membership.out_of_datebodybooleanYesNone
membership.removed_from_operationbodybooleanYesNone
PATCH/api/scenarios/{scenario_id}/entities/{entity_id}Scenariorouter.Update Scenario Entity

Parameters

NameInTypeRequiredDescription
scenario_idpathstringYesNone
entity_idpathstringYesNone
expected_scenario_revisionbodyinteger | nullNoNone
introduced_at_tickbodyinteger | nullNoNone
associated_with_idbodystring | nullNoNone
initial_state_overridesbodyScenarioInitialStateOverrides-Input | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonScenarioMembershipMutationResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonScenarioMembershipMutationResponse
NameInTypeRequiredDescription
scenariobodyScenarioV2ResponseYesNone
scenario.idbodystringYesNone
scenario.map_idbodystringYesNone
scenario.namebodystringYesNone
scenario.schema_versionbodyintegerYesNone
scenario.revisionbodyintegerYesNone
scenario.starts_atbodystringYesNone
scenario.snapshot_duration_hoursbodynumberYesNone
scenario.planbodyScenarioPlanV2-OutputYesNone
scenario.plan.schema_versionbodyintegerNoNone
scenario.plan.capability_resolver_versionbodystringNoVersion of the frontend capability resolver/default set used to materialize the plan.
scenario.plan.ticksbodyarray<ScenarioTickDelta-Output>NoNone
scenario.membershipsbodyarray<ScenarioMembershipResponse>YesNone
scenario.input_hashbodystringYesNone
scenario.created_atbodystringYesNone
scenario.updated_atbodystring | nullNoNone
membershipbodyScenarioMembershipResponse | nullNoNone
membership.idbodystringYesNone
membership.entity_idbodystringYesNone
membership.entity_revisionbodyintegerYesNone
membership.planning_snapshotbodyScenarioPlanningSnapshot-OutputYesNone
membership.planning_snapshot.profilebodyEntityProfile-OutputYesNone
membership.planning_snapshot.current_statebodyEntityCurrentState-Output | nullNoNone
membership.planning_snapshot.metadatabodyobjectNoNone
membership.introduced_at_tickbodyintegerYesNone
membership.associated_with_idbodystring | nullNoNone
membership.initial_state_overridesbodyScenarioInitialStateOverrides-OutputNoNone
membership.initial_state_overrides.statsbodyOperationalStatsPatchNoNone
membership.initial_state_overrides.capability_statesbodyarray<GroundMobilityState | SuppliesState-Output | MedicalRosterState-Output>NoNone
membership.out_of_datebodybooleanYesNone
membership.removed_from_operationbodybooleanYesNone
DELETE/api/scenarios/{scenario_id}/entities/{entity_id}Scenariorouter.Remove Scenario Entity

Parameters

NameInTypeRequiredDescription
scenario_idpathstringYesNone
entity_idpathstringYesNone
expected_scenario_revisionqueryinteger | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonScenarioMembershipMutationResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonScenarioMembershipMutationResponse
NameInTypeRequiredDescription
scenariobodyScenarioV2ResponseYesNone
scenario.idbodystringYesNone
scenario.map_idbodystringYesNone
scenario.namebodystringYesNone
scenario.schema_versionbodyintegerYesNone
scenario.revisionbodyintegerYesNone
scenario.starts_atbodystringYesNone
scenario.snapshot_duration_hoursbodynumberYesNone
scenario.planbodyScenarioPlanV2-OutputYesNone
scenario.plan.schema_versionbodyintegerNoNone
scenario.plan.capability_resolver_versionbodystringNoVersion of the frontend capability resolver/default set used to materialize the plan.
scenario.plan.ticksbodyarray<ScenarioTickDelta-Output>NoNone
scenario.membershipsbodyarray<ScenarioMembershipResponse>YesNone
scenario.input_hashbodystringYesNone
scenario.created_atbodystringYesNone
scenario.updated_atbodystring | nullNoNone
membershipbodyScenarioMembershipResponse | nullNoNone
membership.idbodystringYesNone
membership.entity_idbodystringYesNone
membership.entity_revisionbodyintegerYesNone
membership.planning_snapshotbodyScenarioPlanningSnapshot-OutputYesNone
membership.planning_snapshot.profilebodyEntityProfile-OutputYesNone
membership.planning_snapshot.current_statebodyEntityCurrentState-Output | nullNoNone
membership.planning_snapshot.metadatabodyobjectNoNone
membership.introduced_at_tickbodyintegerYesNone
membership.associated_with_idbodystring | nullNoNone
membership.initial_state_overridesbodyScenarioInitialStateOverrides-OutputNoNone
membership.initial_state_overrides.statsbodyOperationalStatsPatchNoNone
membership.initial_state_overrides.capability_statesbodyarray<GroundMobilityState | SuppliesState-Output | MedicalRosterState-Output>NoNone
membership.out_of_datebodybooleanYesNone
membership.removed_from_operationbodybooleanYesNone
PATCH/api/scenarios/{scenario_id}/entities/{entity_id}/canonicalScenariorouter.Patch Canonical Scenario Entity

Parameters

NameInTypeRequiredDescription
scenario_idpathstringYesNone
entity_idpathstringYesNone
expected_scenario_revisionbodyinteger | nullNoNone
expected_entity_revisionbodyinteger | nullNoNone
profilebodyEntityProfilePatch | nullNoNone
current_statebodyEntityCurrentStatePatch | nullNoNone
metadatabodyobject | nullNoNone
planning_snapshotbodyScenarioPlanningSnapshot-Input | nullNoNone
initial_state_overridesbodyScenarioInitialStateOverrides-Input | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonScenarioMembershipMutationResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonScenarioMembershipMutationResponse
NameInTypeRequiredDescription
scenariobodyScenarioV2ResponseYesNone
scenario.idbodystringYesNone
scenario.map_idbodystringYesNone
scenario.namebodystringYesNone
scenario.schema_versionbodyintegerYesNone
scenario.revisionbodyintegerYesNone
scenario.starts_atbodystringYesNone
scenario.snapshot_duration_hoursbodynumberYesNone
scenario.planbodyScenarioPlanV2-OutputYesNone
scenario.plan.schema_versionbodyintegerNoNone
scenario.plan.capability_resolver_versionbodystringNoVersion of the frontend capability resolver/default set used to materialize the plan.
scenario.plan.ticksbodyarray<ScenarioTickDelta-Output>NoNone
scenario.membershipsbodyarray<ScenarioMembershipResponse>YesNone
scenario.input_hashbodystringYesNone
scenario.created_atbodystringYesNone
scenario.updated_atbodystring | nullNoNone
membershipbodyScenarioMembershipResponse | nullNoNone
membership.idbodystringYesNone
membership.entity_idbodystringYesNone
membership.entity_revisionbodyintegerYesNone
membership.planning_snapshotbodyScenarioPlanningSnapshot-OutputYesNone
membership.planning_snapshot.profilebodyEntityProfile-OutputYesNone
membership.planning_snapshot.current_statebodyEntityCurrentState-Output | nullNoNone
membership.planning_snapshot.metadatabodyobjectNoNone
membership.introduced_at_tickbodyintegerYesNone
membership.associated_with_idbodystring | nullNoNone
membership.initial_state_overridesbodyScenarioInitialStateOverrides-OutputNoNone
membership.initial_state_overrides.statsbodyOperationalStatsPatchNoNone
membership.initial_state_overrides.capability_statesbodyarray<GroundMobilityState | SuppliesState-Output | MedicalRosterState-Output>NoNone
membership.out_of_datebodybooleanYesNone
membership.removed_from_operationbodybooleanYesNone
POST/api/scenarios/{scenario_id}/entities/{entity_id}/rebaseScenariorouter.Rebase Scenario Entity

Parameters

NameInTypeRequiredDescription
scenario_idpathstringYesNone
entity_idpathstringYesNone
expected_scenario_revisionbodyinteger | nullNoNone
expected_entity_revisionbodyinteger | nullNoNone
planning_snapshotbodyScenarioPlanningSnapshot-InputYesNone

Responses

NameInTypeRequiredDescription
200application/jsonScenarioMembershipMutationResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonScenarioMembershipMutationResponse
NameInTypeRequiredDescription
scenariobodyScenarioV2ResponseYesNone
scenario.idbodystringYesNone
scenario.map_idbodystringYesNone
scenario.namebodystringYesNone
scenario.schema_versionbodyintegerYesNone
scenario.revisionbodyintegerYesNone
scenario.starts_atbodystringYesNone
scenario.snapshot_duration_hoursbodynumberYesNone
scenario.planbodyScenarioPlanV2-OutputYesNone
scenario.plan.schema_versionbodyintegerNoNone
scenario.plan.capability_resolver_versionbodystringNoVersion of the frontend capability resolver/default set used to materialize the plan.
scenario.plan.ticksbodyarray<ScenarioTickDelta-Output>NoNone
scenario.membershipsbodyarray<ScenarioMembershipResponse>YesNone
scenario.input_hashbodystringYesNone
scenario.created_atbodystringYesNone
scenario.updated_atbodystring | nullNoNone
membershipbodyScenarioMembershipResponse | nullNoNone
membership.idbodystringYesNone
membership.entity_idbodystringYesNone
membership.entity_revisionbodyintegerYesNone
membership.planning_snapshotbodyScenarioPlanningSnapshot-OutputYesNone
membership.planning_snapshot.profilebodyEntityProfile-OutputYesNone
membership.planning_snapshot.current_statebodyEntityCurrentState-Output | nullNoNone
membership.planning_snapshot.metadatabodyobjectNoNone
membership.introduced_at_tickbodyintegerYesNone
membership.associated_with_idbodystring | nullNoNone
membership.initial_state_overridesbodyScenarioInitialStateOverrides-OutputNoNone
membership.initial_state_overrides.statsbodyOperationalStatsPatchNoNone
membership.initial_state_overrides.capability_statesbodyarray<GroundMobilityState | SuppliesState-Output | MedicalRosterState-Output>NoNone
membership.out_of_datebodybooleanYesNone
membership.removed_from_operationbodybooleanYesNone
POST/api/scenarios/{scenario_id}/export-sync-matrixScenariorouter.Export Sync Matrix

Parameters

NameInTypeRequiredDescription
scenario_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/scenarios/{scenario_id}/v2Scenariorouter.Get Scenario V2

Parameters

NameInTypeRequiredDescription
scenario_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonScenarioV2ResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonScenarioV2Response
NameInTypeRequiredDescription
idbodystringYesNone
map_idbodystringYesNone
namebodystringYesNone
schema_versionbodyintegerYesNone
revisionbodyintegerYesNone
starts_atbodystringYesNone
snapshot_duration_hoursbodynumberYesNone
planbodyScenarioPlanV2-OutputYesNone
plan.schema_versionbodyintegerNoNone
plan.capability_resolver_versionbodystringNoVersion of the frontend capability resolver/default set used to materialize the plan.
plan.ticksbodyarray<ScenarioTickDelta-Output>NoNone
membershipsbodyarray<ScenarioMembershipResponse>YesNone
memberships[].idbodystringYesNone
memberships[].entity_idbodystringYesNone
memberships[].entity_revisionbodyintegerYesNone
memberships[].planning_snapshotbodyScenarioPlanningSnapshot-OutputYesNone
memberships[].introduced_at_tickbodyintegerYesNone
memberships[].associated_with_idbodystring | nullNoNone
memberships[].initial_state_overridesbodyScenarioInitialStateOverrides-OutputNoNone
memberships[].out_of_datebodybooleanYesNone
memberships[].removed_from_operationbodybooleanYesNone
input_hashbodystringYesNone
created_atbodystringYesNone
updated_atbodystring | nullNoNone
PUT/api/scenarios/{scenario_id}/v2Scenariorouter.Update Scenario V2

Parameters

NameInTypeRequiredDescription
scenario_idpathstringYesNone
expected_revisionbodyinteger | nullNoNone
namebodystring | nullNoNone
planbodyScenarioPlanV2-InputYesNone
starts_atbodystring | nullNoNone
snapshot_duration_hoursbodynumber | nullNoNone
deleted_tickbodyinteger | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonScenarioV2ResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonScenarioV2Response
NameInTypeRequiredDescription
idbodystringYesNone
map_idbodystringYesNone
namebodystringYesNone
schema_versionbodyintegerYesNone
revisionbodyintegerYesNone
starts_atbodystringYesNone
snapshot_duration_hoursbodynumberYesNone
planbodyScenarioPlanV2-OutputYesNone
plan.schema_versionbodyintegerNoNone
plan.capability_resolver_versionbodystringNoVersion of the frontend capability resolver/default set used to materialize the plan.
plan.ticksbodyarray<ScenarioTickDelta-Output>NoNone
membershipsbodyarray<ScenarioMembershipResponse>YesNone
memberships[].idbodystringYesNone
memberships[].entity_idbodystringYesNone
memberships[].entity_revisionbodyintegerYesNone
memberships[].planning_snapshotbodyScenarioPlanningSnapshot-OutputYesNone
memberships[].introduced_at_tickbodyintegerYesNone
memberships[].associated_with_idbodystring | nullNoNone
memberships[].initial_state_overridesbodyScenarioInitialStateOverrides-OutputNoNone
memberships[].out_of_datebodybooleanYesNone
memberships[].removed_from_operationbodybooleanYesNone
input_hashbodystringYesNone
created_atbodystringYesNone
updated_atbodystring | nullNoNone
PUT/api/scenarios/{scenario_id}/v2/calculation-artifactScenariorouter.Put Calculation Artifact

Parameters

NameInTypeRequiredDescription
scenario_idpathstringYesNone
input_hashbodystringYesNone
schema_versionbodyintegerNoNone
artifactbodyCalculationArtifactYesNone

Responses

NameInTypeRequiredDescription
204responseunknownNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error
POST/api/scenarios/v2Scenariorouter.Create V2

Parameters

NameInTypeRequiredDescription
map_idbodystringYesNone
namebodystringNoNone
starts_atbodystring | nullNoNone
snapshot_duration_hoursbodynumberNoNone

Responses

NameInTypeRequiredDescription
201application/jsonScenarioV2ResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

201application/jsonScenarioV2Response
NameInTypeRequiredDescription
idbodystringYesNone
map_idbodystringYesNone
namebodystringYesNone
schema_versionbodyintegerYesNone
revisionbodyintegerYesNone
starts_atbodystringYesNone
snapshot_duration_hoursbodynumberYesNone
planbodyScenarioPlanV2-OutputYesNone
plan.schema_versionbodyintegerNoNone
plan.capability_resolver_versionbodystringNoVersion of the frontend capability resolver/default set used to materialize the plan.
plan.ticksbodyarray<ScenarioTickDelta-Output>NoNone
membershipsbodyarray<ScenarioMembershipResponse>YesNone
memberships[].idbodystringYesNone
memberships[].entity_idbodystringYesNone
memberships[].entity_revisionbodyintegerYesNone
memberships[].planning_snapshotbodyScenarioPlanningSnapshot-OutputYesNone
memberships[].introduced_at_tickbodyintegerYesNone
memberships[].associated_with_idbodystring | nullNoNone
memberships[].initial_state_overridesbodyScenarioInitialStateOverrides-OutputNoNone
memberships[].out_of_datebodybooleanYesNone
memberships[].removed_from_operationbodybooleanYesNone
input_hashbodystringYesNone
created_atbodystringYesNone
updated_atbodystring | nullNoNone
Soil1 operations
GET/api/soil/unitsSoilrouter.Get Soil Unit

Parameters

NameInTypeRequiredDescription
map_idquerystringYesNone
mukeyqueryintegerYesNone
lonquerynumberYesNone
latquerynumberYesNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
Terrain Analysis15 operations
POST/api/terrain-analysis/Terrainanalysisrouter.Terrain Analysis

Parameters

NameInTypeRequiredDescription
boundary_shapebodyobjectYesNone
map_idbodystringYesNone
include_populationbodybooleanNoNone
include_buildingsbodybooleanNoNone

Responses

NameInTypeRequiredDescription
200application/jsonTerrainAnalysisResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonTerrainAnalysisResponse
NameInTypeRequiredDescription
errorsbodyarray<string>YesNone
warningsbodyarray<string>NoNone
sourcesbodyobjectNoNone
sources.{key}bodyDataSourceStatusNoNone
sources.{key}.okbodybooleanYesNone
sources.{key}.messagebodystring | nullNoNone
sources.{key}.codebodystring | nullNoNone
job_idbodystring | nullNoNone
statusbodystring | nullNoNone
analysis_readybodybooleanNoNone
display_readybodybooleanNoNone
can_cancelbodybooleanNoNone
overallbodyobject | nullNoNone
phasesbodyarray<object>NoNone
source_versionsbodyobject | nullNoNone
source_versions.{key}bodystringNoNone
degraded_sourcesbodyarray<string> | nullNoNone
GET/api/terrain-analysis/chat/maps/{map_id}/sessionsTerrainanalysisrouter.List Conversation Sessions

Parameters

NameInTypeRequiredDescription
map_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonarray<TerrainAnalysisSessionResponse>NoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonarray<TerrainAnalysisSessionResponse>
NameInTypeRequiredDescription
bodybodyarray<TerrainAnalysisSessionResponse>YesNone
body[].idbodystringYesNone
body[].user_idbodystringYesNone
body[].map_idbodystringYesNone
body[].is_activebodybooleanYesNone
body[].last_activitybodystringYesNone
body[].created_atbodystringYesNone
body[].updated_atbodystringYesNone
POST/api/terrain-analysis/chat/sessions/{session_id}/activateTerrainanalysisrouter.Activate Session

Parameters

NameInTypeRequiredDescription
session_idpathstringYesNone
map_idquerystringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/terrain-analysis/chat/sessions/{session_id}/conversationTerrainanalysisrouter.Get Conversation By Session Id

Parameters

NameInTypeRequiredDescription
session_idpathstringYesNone
map_idquerystringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonarray<TerrainAgentChatMessage>NoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonarray<TerrainAgentChatMessage>
NameInTypeRequiredDescription
bodybodyarray<TerrainAgentChatMessage>YesNone
body[].idbodystringYesNone
body[].indexbodyintegerYesNone
body[].rolebodystringYesNone
body[].event_typebodystring | nullNoNone
body[].contentbodystring | nullNoNone
body[].tool_namebodystring | nullNoNone
body[].tool_argsbodystring | nullNoNone
body[].tool_resultbodystring | nullNoNone
body[].created_atbodystringYesNone
POST/api/terrain-analysis/chat/sessions/{session_id}/conversation/clearTerrainanalysisrouter.Clear Session Messages

Parameters

NameInTypeRequiredDescription
session_idpathstringYesNone
map_idquerystringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
POST/api/terrain-analysis/chat/streamTerrainanalysisrouter.Chat Stream

Parameters

NameInTypeRequiredDescription
map_idbodystringYesNone
scenario_idbodystringYesNone
snapshot_orderbodyintegerYesNone
promptbodystringYesNone
flow_idbodystring | nullNoNone
viewport_bbox_wgs84bodyarray<number> | nullNoCurrent map viewport as [west, south, east, north] in WGS84 degrees.
map_zoombodynumber | nullNoNone
cursor_latitudebodynumber | nullNoNone
cursor_longitudebodynumber | nullNoNone
mobility_configbodyPathfindingMobilityConfig | nullNoNone
confirmation_responsebodyTerrainAnalysisConfirmationResponse | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/terrain-analysis/jobs/{job_id}Terrainanalysisrouter.Get Terrain Analysis Job

Parameters

NameInTypeRequiredDescription
job_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonTerrainAnalysisResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonTerrainAnalysisResponse
NameInTypeRequiredDescription
errorsbodyarray<string>YesNone
warningsbodyarray<string>NoNone
sourcesbodyobjectNoNone
sources.{key}bodyDataSourceStatusNoNone
sources.{key}.okbodybooleanYesNone
sources.{key}.messagebodystring | nullNoNone
sources.{key}.codebodystring | nullNoNone
job_idbodystring | nullNoNone
statusbodystring | nullNoNone
analysis_readybodybooleanNoNone
display_readybodybooleanNoNone
can_cancelbodybooleanNoNone
overallbodyobject | nullNoNone
phasesbodyarray<object>NoNone
source_versionsbodyobject | nullNoNone
source_versions.{key}bodystringNoNone
degraded_sourcesbodyarray<string> | nullNoNone
POST/api/terrain-analysis/jobs/{job_id}/cancelTerrainanalysisrouter.Cancel Terrain Analysis Job

Parameters

NameInTypeRequiredDescription
job_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonTerrainAnalysisResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonTerrainAnalysisResponse
NameInTypeRequiredDescription
errorsbodyarray<string>YesNone
warningsbodyarray<string>NoNone
sourcesbodyobjectNoNone
sources.{key}bodyDataSourceStatusNoNone
sources.{key}.okbodybooleanYesNone
sources.{key}.messagebodystring | nullNoNone
sources.{key}.codebodystring | nullNoNone
job_idbodystring | nullNoNone
statusbodystring | nullNoNone
analysis_readybodybooleanNoNone
display_readybodybooleanNoNone
can_cancelbodybooleanNoNone
overallbodyobject | nullNoNone
phasesbodyarray<object>NoNone
source_versionsbodyobject | nullNoNone
source_versions.{key}bodystringNoNone
degraded_sourcesbodyarray<string> | nullNoNone
GET/api/terrain-analysis/jobs/latestTerrainanalysisrouter.Latest Terrain Analysis Job

Parameters

NameInTypeRequiredDescription
map_idquerystringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonTerrainAnalysisResponse | nullNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonTerrainAnalysisResponse | null
NameInTypeRequiredDescription
errorsbodyarray<string>YesNone
warningsbodyarray<string>NoNone
sourcesbodyobjectNoNone
sources.{key}bodyDataSourceStatusNoNone
sources.{key}.okbodybooleanYesNone
sources.{key}.messagebodystring | nullNoNone
sources.{key}.codebodystring | nullNoNone
job_idbodystring | nullNoNone
statusbodystring | nullNoNone
analysis_readybodybooleanNoNone
display_readybodybooleanNoNone
can_cancelbodybooleanNoNone
overallbodyobject | nullNoNone
phasesbodyarray<object>NoNone
source_versionsbodyobject | nullNoNone
source_versions.{key}bodystringNoNone
degraded_sourcesbodyarray<string> | nullNoNone
POST/api/terrain-analysis/rf-propagationTerrainanalysisrouter.Rf Propagation

Parameters

NameInTypeRequiredDescription
map_idbodystringYesNone
boundary_shapebodyobject | nullNoNone
receiver_height_mbodynumberNoNone
resolution_mbodynumberNoNone
max_radius_mbodynumber | nullNoNone
layer_namebodystring | nullNoNone
environmentbodyRfEnvironmentRequestNoNone
quality_presetbodyexact | high | balanced | fast | previewNoNone
model_modebodyexact | hybrid | polar | nullNoNone
angular_step_degbodynumber | nullNoNone
radial_step_mbodynumber | nullNoNone
terrain_sample_scalebodyinteger | nullNoNone
max_path_samplesbodyinteger | nullNoNone
near_field_exact_radius_mbodynumber | nullNoNone
shadow_boundary_refinement_mbodynumber | nullNoNone
transmittersbodyarray<RfTransmitterRequest>YesNone

Responses

NameInTypeRequiredDescription
200application/jsonTerrainAnalysisResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonTerrainAnalysisResponse
NameInTypeRequiredDescription
errorsbodyarray<string>YesNone
warningsbodyarray<string>NoNone
sourcesbodyobjectNoNone
sources.{key}bodyDataSourceStatusNoNone
sources.{key}.okbodybooleanYesNone
sources.{key}.messagebodystring | nullNoNone
sources.{key}.codebodystring | nullNoNone
job_idbodystring | nullNoNone
statusbodystring | nullNoNone
analysis_readybodybooleanNoNone
display_readybodybooleanNoNone
can_cancelbodybooleanNoNone
overallbodyobject | nullNoNone
phasesbodyarray<object>NoNone
source_versionsbodyobject | nullNoNone
source_versions.{key}bodystringNoNone
degraded_sourcesbodyarray<string> | nullNoNone
GET/api/terrain-analysis/rf-propagation/catalogGet the RF equipment catalog

Returns the server-owned radio, antenna, and mast defaults used to complete communications.radio entity capabilities. API keys require the ENTITIES scope.

Parameters

This endpoint does not declare parameters or a request body.

Responses

NameInTypeRequiredDescription
200application/jsonRfCatalogResponseNoSuccessful Response
403responseunknownNoThe API key lacks the ENTITIES scope.

Response body

200application/jsonRfCatalogResponse
NameInTypeRequiredDescription
schema_versionbodyintegerNoNone
radiosbodyobjectYesKnown radio models keyed by the model identifier accepted by communications.radio.
radios.{key}bodyRadioCatalogDefinitionNoNone
radios.{key}.full_namebodystringYesNone
radios.{key}.familybodystring | nullNoNone
radios.{key}.nomenclaturesbodyarray<string>YesNone
radios.{key}.frequency_bandsbodyarray<array<unknown>>YesNone
radios.{key}.power_levelsbodyarray<RadioCatalogPowerLevel>YesNone
radios.{key}.requires_antennabodybooleanNoNone
radios.{key}.notesbodystring | nullNoNone
antennasbodyobjectYesKnown antenna models keyed by model identifier.
antennas.{key}bodyAntennaCatalogDefinitionNoNone
antennas.{key}.full_namebodystringYesNone
antennas.{key}.frequency_band_mhzbodyarray<unknown>YesNone
antennas.{key}.default_height_ftbodynumberYesNone
antennas.{key}.mast_supportedbodybooleanYesNone
antennas.{key}.notesbodystring | nullNoNone
mastsbodyobjectYesKnown antenna mast models keyed by model identifier.
masts.{key}bodyMastCatalogDefinitionNoNone
masts.{key}.full_namebodystringYesNone
masts.{key}.height_ftbodynumberYesNone
masts.{key}.notesbodystring | nullNoNone
POST/api/terrain-analysis/rf-propagation/entitiesRun RF propagation from operation entities

Resolves located communications.radio capabilities from entities in the map's operation, queues the same RF job used by the explicit-transmitter endpoint, and reports skipped inputs as warnings. API keys require the ENTITIES scope.

Parameters

NameInTypeRequiredDescription
map_idbodystringYesNone
boundary_shapebodyobject | nullNoNone
receiver_height_mbodynumberNoNone
resolution_mbodynumberNoNone
max_radius_mbodynumber | nullNoNone
layer_namebodystring | nullNoNone
environmentbodyRfEnvironmentRequestNoNone
quality_presetbodyexact | high | balanced | fast | previewNoNone
model_modebodyexact | hybrid | polar | nullNoNone
angular_step_degbodynumber | nullNoNone
radial_step_mbodynumber | nullNoNone
terrain_sample_scalebodyinteger | nullNoNone
max_path_samplesbodyinteger | nullNoNone
near_field_exact_radius_mbodynumber | nullNoNone
shadow_boundary_refinement_mbodynumber | nullNoNone
entitiesbodyarray<RfEntitySelectionRequest>YesOperation entities whose configured communications.radio capabilities should transmit.

Responses

NameInTypeRequiredDescription
200application/jsonTerrainAnalysisResponseNoSuccessful Response
403responseunknownNoOperation access was denied or the API key lacks the ENTITIES scope.
422responseunknownNoNo usable transmitter remains, more than 32 resolve, or the request is invalid.

Response body

200application/jsonTerrainAnalysisResponse
NameInTypeRequiredDescription
errorsbodyarray<string>YesNone
warningsbodyarray<string>NoNone
sourcesbodyobjectNoNone
sources.{key}bodyDataSourceStatusNoNone
sources.{key}.okbodybooleanYesNone
sources.{key}.messagebodystring | nullNoNone
sources.{key}.codebodystring | nullNoNone
job_idbodystring | nullNoNone
statusbodystring | nullNoNone
analysis_readybodybooleanNoNone
display_readybodybooleanNoNone
can_cancelbodybooleanNoNone
overallbodyobject | nullNoNone
phasesbodyarray<object>NoNone
source_versionsbodyobject | nullNoNone
source_versions.{key}bodystringNoNone
degraded_sourcesbodyarray<string> | nullNoNone
GET/api/terrain-analysis/rf-propagation/jobs/{job_id}Terrainanalysisrouter.Get Rf Propagation Job

Parameters

NameInTypeRequiredDescription
job_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonTerrainAnalysisResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonTerrainAnalysisResponse
NameInTypeRequiredDescription
errorsbodyarray<string>YesNone
warningsbodyarray<string>NoNone
sourcesbodyobjectNoNone
sources.{key}bodyDataSourceStatusNoNone
sources.{key}.okbodybooleanYesNone
sources.{key}.messagebodystring | nullNoNone
sources.{key}.codebodystring | nullNoNone
job_idbodystring | nullNoNone
statusbodystring | nullNoNone
analysis_readybodybooleanNoNone
display_readybodybooleanNoNone
can_cancelbodybooleanNoNone
overallbodyobject | nullNoNone
phasesbodyarray<object>NoNone
source_versionsbodyobject | nullNoNone
source_versions.{key}bodystringNoNone
degraded_sourcesbodyarray<string> | nullNoNone
POST/api/terrain-analysis/rf-propagation/jobs/{job_id}/cancelTerrainanalysisrouter.Cancel Rf Propagation Job

Parameters

NameInTypeRequiredDescription
job_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonTerrainAnalysisResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonTerrainAnalysisResponse
NameInTypeRequiredDescription
errorsbodyarray<string>YesNone
warningsbodyarray<string>NoNone
sourcesbodyobjectNoNone
sources.{key}bodyDataSourceStatusNoNone
sources.{key}.okbodybooleanYesNone
sources.{key}.messagebodystring | nullNoNone
sources.{key}.codebodystring | nullNoNone
job_idbodystring | nullNoNone
statusbodystring | nullNoNone
analysis_readybodybooleanNoNone
display_readybodybooleanNoNone
can_cancelbodybooleanNoNone
overallbodyobject | nullNoNone
phasesbodyarray<object>NoNone
source_versionsbodyobject | nullNoNone
source_versions.{key}bodystringNoNone
degraded_sourcesbodyarray<string> | nullNoNone
GET/api/terrain-analysis/rf-propagation/jobs/latestTerrainanalysisrouter.Latest Rf Propagation Job

Parameters

NameInTypeRequiredDescription
map_idquerystringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonTerrainAnalysisResponse | nullNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonTerrainAnalysisResponse | null
NameInTypeRequiredDescription
errorsbodyarray<string>YesNone
warningsbodyarray<string>NoNone
sourcesbodyobjectNoNone
sources.{key}bodyDataSourceStatusNoNone
sources.{key}.okbodybooleanYesNone
sources.{key}.messagebodystring | nullNoNone
sources.{key}.codebodystring | nullNoNone
job_idbodystring | nullNoNone
statusbodystring | nullNoNone
analysis_readybodybooleanNoNone
display_readybodybooleanNoNone
can_cancelbodybooleanNoNone
overallbodyobject | nullNoNone
phasesbodyarray<object>NoNone
source_versionsbodyobject | nullNoNone
source_versions.{key}bodystringNoNone
degraded_sourcesbodyarray<string> | nullNoNone
Units7 operations
POST/api/units/Unitrouter.Create Unit

Parameters

NameInTypeRequiredDescription
iconbodystringYesNone
parent_idbodystring | nullNoNone
namebodystringYesNone
branchbodystringYesNone
echelonbodystringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonUnitResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonUnitResponse
NameInTypeRequiredDescription
idbodystringYesNone
user_idbodystringYesNone
parent_idbodystring | nullYesNone
namebodystringYesNone
iconbodystringYesNone
branchbodystringYesNone
echelonbodystringYesNone
policiesbodyarray<string>YesNone
notificationbodystring | nullYesNone
num_operationsbodyintegerYesNone
created_atbodystring | nullNoNone
updated_atbodystring | nullNoNone
GET/api/units/Unitrouter.Get Units

Parameters

NameInTypeRequiredDescription
parent_idquerystring | nullNoNone
queryquerystring | nullNoNone
sizequeryinteger | nullNoNone
pagequeryinteger | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonListUnitResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonListUnitResponse
NameInTypeRequiredDescription
unitsbodyarray<UnitResponse>YesNone
units[].idbodystringYesNone
units[].user_idbodystringYesNone
units[].parent_idbodystring | nullYesNone
units[].namebodystringYesNone
units[].iconbodystringYesNone
units[].branchbodystringYesNone
units[].echelonbodystringYesNone
units[].policiesbodyarray<string>YesNone
units[].notificationbodystring | nullYesNone
units[].num_operationsbodyintegerYesNone
units[].created_atbodystring | nullNoNone
units[].updated_atbodystring | nullNoNone
paginationbodyPaginationResponseYesNone
pagination.current_pagebodyinteger | nullNoNone
pagination.total_pagesbodyinteger | nullNoNone
pagination.total_recordsbodyinteger | nullNoNone
PUT/api/units/{unit_id}Unitrouter.Update Unit

Parameters

NameInTypeRequiredDescription
unit_idpathstringYesNone
iconbodystring | nullNoNone
parent_idbodystring | nullNoNone
namebodystring | nullNoNone
branchbodystring | nullNoNone
echelonbodystring | nullNoNone
notificationbodystring | nullNoNone

Responses

NameInTypeRequiredDescription
200application/jsonMessageResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonMessageResponse
NameInTypeRequiredDescription
messagebodystringNoNone
GET/api/units/{unit_id}Unitrouter.Get Unit

Parameters

NameInTypeRequiredDescription
unit_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonUnitResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonUnitResponse
NameInTypeRequiredDescription
idbodystringYesNone
user_idbodystringYesNone
parent_idbodystring | nullYesNone
namebodystringYesNone
iconbodystringYesNone
branchbodystringYesNone
echelonbodystringYesNone
policiesbodyarray<string>YesNone
notificationbodystring | nullYesNone
num_operationsbodyintegerYesNone
created_atbodystring | nullNoNone
updated_atbodystring | nullNoNone
DELETE/api/units/{unit_id}Unitrouter.Delete Unit

Parameters

NameInTypeRequiredDescription
unit_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonMessageResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonMessageResponse
NameInTypeRequiredDescription
messagebodystringNoNone
GET/api/units/{unit_id}/iconUnitrouter.Get Icon

Parameters

NameInTypeRequiredDescription
unit_idpathstringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonobjectNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonobject
NameInTypeRequiredDescription
bodybodyobjectYesNone
GET/api/units/parentsUnitrouter.Get Parent Units

Parameters

NameInTypeRequiredDescription
unit_idquerystringYesNone

Responses

NameInTypeRequiredDescription
200application/jsonListUnitResponseNoSuccessful Response
422application/jsonHTTPValidationErrorNoValidation Error

Response body

200application/jsonListUnitResponse
NameInTypeRequiredDescription
unitsbodyarray<UnitResponse>YesNone
units[].idbodystringYesNone
units[].user_idbodystringYesNone
units[].parent_idbodystring | nullYesNone
units[].namebodystringYesNone
units[].iconbodystringYesNone
units[].branchbodystringYesNone
units[].echelonbodystringYesNone
units[].policiesbodyarray<string>YesNone
units[].notificationbodystring | nullYesNone
units[].num_operationsbodyintegerYesNone
units[].created_atbodystring | nullNoNone
units[].updated_atbodystring | nullNoNone
paginationbodyPaginationResponseYesNone
pagination.current_pagebodyinteger | nullNoNone
pagination.total_pagesbodyinteger | nullNoNone
pagination.total_recordsbodyinteger | nullNoNone