Retrieve a rocket

Read a single rocket by identifier.

Example page

The Rockets API does not exist: it is described in rockets.yaml to show what OpenAPI pages look like. This one passes a path without a method, which renders every operation of that path. Below this note, the page is one line of MDX:

<APIPage spec="rockets" path="/rockets/{rocketId}" />

GET/rockets/{rocketId}

Authorizations

bearerAuthbearer <JWT>
A token issued by the console.

Path parameters

rocketIdstring<uuid>required
Identifier of the rocket.

Request

curl -X GET 'https://api.rockets.example/v1/rockets/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -H 'Authorization: Bearer $TOKEN'

Responses

200

200The rocket.

idstring<uuid>required
Identifier of the rocket.
namestringrequired
Display name.
status"design" | "testing" | "flying" | "retired"required
Lifecycle of a rocket.
thrustinteger<int64>
Thrust at sea level, in kilonewtons.
stagesStage[]required
Stages, from the booster upwards.
Show child attributes
- namestringrequired
  Name of the stage.
- enginesinteger<int32>required
  Number of engines on the stage.
- reusableboolean
  Whether the stage lands back.
createdAtstring<date-time>

Response

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "Zenith Heavy",
  "status": "design",
  "thrust": 7600,
  "stages": [
    {
      "name": "Booster",
      "engines": 9,
      "reusable": false
    }
  ],
  "createdAt": "2026-01-01T00:00:00Z"
}

404

404No rocket has this identifier.

codestringrequired
Machine-readable code.
messagestringrequired
What went wrong.

Response

{
  "code": "not_found",
  "message": "string"
}

DELETE/rockets/{rocketId}

deprecated

Delete a rocket

Retired rockets are kept for audit, prefer archiving them.

Authorizations

bearerAuthbearer <JWT>
A token issued by the console.

Path parameters

rocketIdstring<uuid>required
Identifier of the rocket.

Request

curl -X DELETE 'https://api.rockets.example/v1/rockets/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -H 'Authorization: Bearer $TOKEN'

Responses

204

204The rocket was deleted.

No body.

404

404No rocket has this identifier.

codestringrequired
Machine-readable code.
messagestringrequired
What went wrong.

Response

{
  "code": "not_found",
  "message": "string"
}