Update an MA-scoped spacecraft lifecycle status

Error

A valid request URL is required to generate request examples

{
  "absorption": 0.4,
  "bodyShape": "BOX",
  "boxX": 1.5,
  "boxY": 1,
  "boxZ": 2,
  "color": "#FF5733",
  "cosparId": "2024-001A",
  "createdAt": "2023-11-07T05:31:56Z",
  "dragArea": 5,
  "dragCoefficient": 2.2,
  "dryMass": 450,
  "environment": "MISSION_ANALYSIS",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "inertiaIxx": 1500,
  "inertiaIyy": 1700,
  "inertiaIzz": 2100,
  "launchMass": 500,
  "lifecycleStatus": "Active",
  "name": "Sentinel-1A",
  "noradId": 43013,
  "organizationId": "VALAR",
  "panels": [
    {
      "absorption": 0.3,
      "derivedNormal": {
        "x": 1,
        "y": 0,
        "z": 0
      },
      "doubleSided": true,
      "lengthM": 2,
      "mountAxisCustomX": 0,
      "mountAxisCustomY": 0,
      "mountAxisCustomZ": 5,
      "mountAxisPreset": "PLUS_Z",
      "mountPositionX": -1.5,
      "mountPositionY": 0,
      "mountPositionZ": 0.25,
      "name": "Port array",
      "panelIndex": 0,
      "rotationDeg": 90,
      "specularReflection": 0.2,
      "widthM": 1
    }
  ],
  "prismAxis": "Z",
  "prismComplementaryDiameter": 1,
  "prismDiameter": 0.866025,
  "prismDiameterMeasure": "INSCRIBED",
  "prismEdgeM": 0.5,
  "prismHeightM": 1,
  "prismSides": 6,
  "reflectivityCoefficient": 1,
  "specularReflection": 0.3,
  "srpArea": 5,
  "updatedAt": "2023-11-07T05:31:56Z"
}

{
  "details": {},
  "error": "Bad Request",
  "fieldErrors": {},
  "message": "Validation failed",
  "path": "/measurements",
  "status": 400,
  "timestamp": "2025-11-14T10:15:30.123Z"
}

{
  "error": "invalid_token",
  "error_description": "An error occurred while attempting to decode the Jwt"
}

{
  "details": {},
  "error": "Bad Request",
  "fieldErrors": {},
  "message": "Validation failed",
  "path": "/measurements",
  "status": 400,
  "timestamp": "2025-11-14T10:15:30.123Z"
}

{
  "details": {},
  "error": "Bad Request",
  "fieldErrors": {},
  "message": "Validation failed",
  "path": "/measurements",
  "status": 400,
  "timestamp": "2025-11-14T10:15:30.123Z"
}

{
  "taskCount": 3
}

PUT

mission-analysis

spacecraft

{id}

lifecycle

Error

A valid request URL is required to generate request examples

{
  "absorption": 0.4,
  "bodyShape": "BOX",
  "boxX": 1.5,
  "boxY": 1,
  "boxZ": 2,
  "color": "#FF5733",
  "cosparId": "2024-001A",
  "createdAt": "2023-11-07T05:31:56Z",
  "dragArea": 5,
  "dragCoefficient": 2.2,
  "dryMass": 450,
  "environment": "MISSION_ANALYSIS",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "inertiaIxx": 1500,
  "inertiaIyy": 1700,
  "inertiaIzz": 2100,
  "launchMass": 500,
  "lifecycleStatus": "Active",
  "name": "Sentinel-1A",
  "noradId": 43013,
  "organizationId": "VALAR",
  "panels": [
    {
      "absorption": 0.3,
      "derivedNormal": {
        "x": 1,
        "y": 0,
        "z": 0
      },
      "doubleSided": true,
      "lengthM": 2,
      "mountAxisCustomX": 0,
      "mountAxisCustomY": 0,
      "mountAxisCustomZ": 5,
      "mountAxisPreset": "PLUS_Z",
      "mountPositionX": -1.5,
      "mountPositionY": 0,
      "mountPositionZ": 0.25,
      "name": "Port array",
      "panelIndex": 0,
      "rotationDeg": 90,
      "specularReflection": 0.2,
      "widthM": 1
    }
  ],
  "prismAxis": "Z",
  "prismComplementaryDiameter": 1,
  "prismDiameter": 0.866025,
  "prismDiameterMeasure": "INSCRIBED",
  "prismEdgeM": 0.5,
  "prismHeightM": 1,
  "prismSides": 6,
  "reflectivityCoefficient": 1,
  "specularReflection": 0.3,
  "srpArea": 5,
  "updatedAt": "2023-11-07T05:31:56Z"
}

{
  "details": {},
  "error": "Bad Request",
  "fieldErrors": {},
  "message": "Validation failed",
  "path": "/measurements",
  "status": 400,
  "timestamp": "2025-11-14T10:15:30.123Z"
}

{
  "error": "invalid_token",
  "error_description": "An error occurred while attempting to decode the Jwt"
}

{
  "details": {},
  "error": "Bad Request",
  "fieldErrors": {},
  "message": "Validation failed",
  "path": "/measurements",
  "status": 400,
  "timestamp": "2025-11-14T10:15:30.123Z"
}

{
  "details": {},
  "error": "Bad Request",
  "fieldErrors": {},
  "message": "Validation failed",
  "path": "/measurements",
  "status": 400,
  "timestamp": "2025-11-14T10:15:30.123Z"
}

{
  "taskCount": 3
}

Path Parameters

string

required

Spacecraft identifier

Body

application/json

Request payload for updating spacecraft lifecycle status

lifecycleStatus

enum<string>

required

Lifecycle status (ONLY Active or Archived allowed)

Available options:

Active,

Archived

Pattern: ^(Active|Archived)$

Example:

"Archived"

confirmTaskDeletion

boolean | null

Confirms permanent deletion of the craft's scheduled tasks when archiving. Required (true) only to archive a craft that has scheduled tasks; ignored on restore and for a craft with no tasks.

Example:

true

Response

Lifecycle status updated successfully

Response containing spacecraft details

absorption

number<double>

Optical absorption coefficient α (dimensionless). Range (0.0, 1.0].

Example:

0.4

bodyShape

enum<string>

Body geometry primitive (BOX or REGULAR_PRISM).

Available options:

BOX,

REGULAR_PRISM

Example:

"BOX"

boxX

number<double>

Spacecraft box/bus X dimension (width) in meters

Example:

1.5

boxY

number<double>

Spacecraft box/bus Y dimension (height) in meters

Example:

1

boxZ

number<double>

Spacecraft box/bus Z dimension (length) in meters

Example:

2

color

string

Spacecraft color in hex format

Example:

"#FF5733"

cosparId

string

COSPAR international designator

Example:

"2024-001A"

createdAt

string<date-time>

Timestamp when the spacecraft was created

dragArea

number<double>

Operator-typed drag cross-sectional area in m² (null for pre-migration spacecraft)

Example:

5

dragCoefficient

number<double>

Drag coefficient

Example:

2.2

dryMass

number<double>

Mass without propellant in kg

Example:

450

environment

string

Environment scope of this spacecraft (OPERATIONS or MISSION_ANALYSIS).

Example:

"MISSION_ANALYSIS"

string

Unique identifier of the spacecraft

Example:

"550e8400-e29b-41d4-a716-446655440000"

inertiaIxx

number<double>

Principal moment of inertia about the body's primary principal axis (kg·m²). Optional; null when inertia is not configured.

Example:

1500

inertiaIyy

number<double>

Principal moment of inertia about the body's secondary principal axis (kg·m²). Optional; null when inertia is not configured.

Example:

1700

inertiaIzz

number<double>

Principal moment of inertia about the body's tertiary principal axis (kg·m²). Optional; null when inertia is not configured.

Example:

2100

launchMass

number<double>

Total mass at launch in kg

Example:

500

lifecycleStatus

string

Lifecycle status of the spacecraft

Example:

"Active"

name

string

Name of the spacecraft

Example:

"Sentinel-1A"

noradId

integer<int32>

NORAD catalog number

Example:

43013

organizationId

string

Organization ID that owns this spacecraft

Example:

"VALAR"

panels

object[]

Per-panel rows (0..8). Each entry carries dimensions, attachment face, and orientation angles.

Show child attributes

prismAxis

enum<string>

Extrusion axis of the regular prism (DKR-1 §3.4). Populated only when bodyShape=REGULAR_PRISM; null otherwise.

Available options:

X,

Y,

Z

Example:

"Z"

prismComplementaryDiameter

number<double>

Cross-section diameter in the OTHER datum (the complement of prismDiameterMeasure), computed from edge + sides (DKR-1 §3.4). Populated only when bodyShape=REGULAR_PRISM; null otherwise.

Example:

1

prismDiameter

number<double>

Cross-section diameter in the operator's chosen datum (prismDiameterMeasure), computed from edge + sides (DKR-1 §3.4). Populated only when bodyShape=REGULAR_PRISM; null otherwise.

Example:

0.866025

prismDiameterMeasure

enum<string>

Which diameter datum the operator used to size the cross-section (DKR-1 §3.4). Populated only when bodyShape=REGULAR_PRISM; null otherwise.

Available options:

INSCRIBED,

CIRCUMSCRIBED

Example:

"INSCRIBED"

prismEdgeM

number<double>

Canonical regular-polygon edge length a in meters (DKR-1 §6) — the persisted source-of-truth cross-section dimension. Populated only when bodyShape=REGULAR_PRISM; null otherwise.

Example:

0.5

prismHeightM

number<double>

Regular-prism height L along the extrusion axis in meters. Populated only when bodyShape=REGULAR_PRISM; null otherwise.

Example:

1

prismSides

integer<int32>

Number of regular-polygon sides N (DKR-1 §3.4). Populated only when bodyShape=REGULAR_PRISM; null otherwise.

Example:

6

reflectivityCoefficient

number<double>

Reflectivity coefficient

Example:

1

specularReflection

number<double>

Optical specular-reflection coefficient ρs (dimensionless). Range [0.0, 1.0).

Example:

0.3

srpArea

number<double>

Operator-typed SRP cross-sectional area in m² (null for pre-migration spacecraft)

Example:

5

updatedAt

string<date-time>

Timestamp when the spacecraft was last updated

Partially update an MA-scoped spacecraft List MA-scoped payloads for a spacecraft

Mission Analysis Spacecraft

Mission Analysis Spacecraft (write)

Mission Analysis Payloads

Mission Analysis Thrusters

Measurements

Operations Spacecraft

Operations Spacecraft (write)

Operations Payloads

Operations Thrusters

State Vectors

Update an MA-scoped spacecraft lifecycle status

Path Parameters

Body

Response