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}

Autorisations

bearerAuthbearer <JWT>
A token issued by the console.

Paramètres de chemin

rocketIdstring<uuid>requis
Identifier of the rocket.

Requête

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

Réponses

200

200The rocket.

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

Réponse

{
  "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.

codestringrequis
Machine-readable code.
messagestringrequis
What went wrong.

Réponse

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

DELETE/rockets/{rocketId}

déprécié

Delete a rocket

Retired rockets are kept for audit, prefer archiving them.

Autorisations

bearerAuthbearer <JWT>
A token issued by the console.

Paramètres de chemin

rocketIdstring<uuid>requis
Identifier of the rocket.

Requête

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

Réponses

204

204The rocket was deleted.

Aucun corps.

404

404No rocket has this identifier.

codestringrequis
Machine-readable code.
messagestringrequis
What went wrong.

Réponse

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