Skip to main content
POST
/
personnel
/
stormtroopers
Create Stormtrooper Record
curl --request POST \
  --url https://api.empire.gov/v1/personnel/stormtroopers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "designation": "TK-421",
  "training_facility": "Carida Academy",
  "name": "Classified",
  "graduation_date": "2023-12-25",
  "assignment": {
    "unit": "<string>",
    "commanding_officer": "<string>",
    "station": "<string>"
  }
}
'
{
  "status": "success",
  "message": "Stormtrooper record created successfully",
  "data": {
    "id": "ST-7845",
    "designation": "TK-421",
    "training_facility": "Carida Academy",
    "assignment": {
      "unit": "501st Legion",
      "commanding_officer": "Commander Appo",
      "station": "Imperial Star Destroyer Devastator"
    },
    "created_at": "2023-11-07T05:31:56Z"
  }
}
This endpoint is currently in development. The example below shows placeholder functionality for demonstration purposes.

​
Endpoint Overview

This endpoint will allow authorized Imperial personnel to register new Stormtrooper recruits in the Imperial database. Full functionality will be available once the API is officially deployed. Example Endpoint: POST /api/v1/personnel/stormtroopers

​
Placeholder Request

The following shows an example of how to create a new Stormtrooper record: 
{
  "designation": "TK-421",
  "name": "Classified",
  "training_facility": "Carida Academy",
  "graduation_date": "2024-03-15",
  "specialization": "Standard Infantry",
  "armor_size": "Medium",
  "assignment": {
    "unit": "501st Legion",
    "commanding_officer": "Commander Appo",
    "station": "Imperial Star Destroyer Devastator"
  },
  "clearance_level": "Standard"
}

​
Placeholder Response

{
  "status": "success",
  "message": "Stormtrooper record created successfully",
  "data": {
    "id": "ST-7845",
    "designation": "TK-421",
    "status": "active",
    "created_at": "2024-06-23T10:30:00Z",
    "assignment_confirmed": true
  }
}
Personnel records are highly classified. This is demonstration data only.

Authorizations

​
Authorization
string
header
required

Imperial Command authorisation token. Contact your commanding officer for access credentials.

Body

application/json

Stormtrooper data to register

​
designation
string
required
Pattern: ^TK-[0-9]{3}$
Example:

"TK-421"

​
training_facility
string
required
Example:

"Carida Academy"

​
specialization
enum<string>
required
Available options:
Standard Infantry,
Heavy Weapons,
Scout,
Commander,
Specialist
​
name
string

Birth name (classified in most records)

Example:

"Classified"

​
graduation_date
string<date>
​
armor_size
enum<string>
Available options:
Small,
Medium,
Large,
Extra Large
​
assignment
object
​
clearance_level
enum<string>
Available options:
Standard,
Elevated,
High,
Top Secret

Response

Stormtrooper registered successfully

​
status
string
Example:

"success"

​
message
string
Example:

"Stormtrooper record created successfully"

​
data
object