---
title: "Register New Agent"
method: POST
path: "/register"
---

# Register New Agent

`POST /register`

Creates a new agent and ties it to a temporary Account.

The agent symbol is a 3-14 character string that will represent your agent. This symbol will prefix the symbol of every ship you own. Agent symbols will be cast to all uppercase characters.

A new agent will be granted an authorization token, a contract with their starting faction, a command ship with a jump drive, and one hundred thousand credits.

> #### Keep your token safe and secure
>
> Save your token during the alpha phase. There is no way to regenerate this token without starting a new agent. In the future you will be able to generate and manage your tokens from the SpaceTraders website.

You can accept your contract using the `/my/contracts/{contractId}/accept` endpoint. You will want to navigate your command ship to a nearby asteroid field and execute the `/my/ships/{shipSymbol}/extract` endpoint to mine various types of ores and minerals.

Return to the contract destination and execute the `/my/ships/{shipSymbol}/deliver` endpoint to deposit goods into the contract.

When your contract is fulfilled, you can call `/my/contracts/{contractId}/fulfill` to retrieve payment.

## Request body

- object
  - `faction` string, required — The faction you choose determines your headquarters.
  - `symbol` string, required — How other agents will see your ships and information.
  - `email` string — Your email address. This is used if you reserved your call sign between resets.

## Response `201`

OK

- object
  - `data` object, required
    - `agent` AgentJson, required — unresolved $ref
    - `contract` ContractJson, required — unresolved $ref
    - `faction` FactionJson, required — unresolved $ref
    - `ship` ShipJson, required — unresolved $ref
    - `token` string, required — A Bearer token for accessing secured API endpoints.

## Changes

> 11 revisions in range; 1 not diffed.

- **2023-06-03** `5a2f0683851a` — 5 breaking
  - removed the enum value `COSMIC` of the request property `faction`
  - removed the enum value `DOMINION` of the request property `faction`
  - removed the enum value `GALACTIC` of the request property `faction`
  - removed the enum value `QUANTUM` of the request property `faction`
  - …1 more
- **2023-06-01** `6cd38661e5a2` — 1 breaking, 5 info
  - request property `faction` was restricted to a list of enum values
  - added the new `COSMIC` enum value to the request property `faction`
  - added the new `DOMINION` enum value to the request property `faction`
  - added the new `GALACTIC` enum value to the request property `faction`
  - …2 more
- **2023-05-28** `b5c3ad5c213b` — 5 breaking
  - removed the enum value `COSMIC` of the request property `faction`
  - removed the enum value `DOMINION` of the request property `faction`
  - removed the enum value `GALACTIC` of the request property `faction`
  - removed the enum value `QUANTUM` of the request property `faction`
  - …1 more
- **2023-05-20** `86f8c56c4690` — 1 breaking, 1 warning, 8 info
  - request property `faction` was restricted to a list of enum values
  - removed the optional property `data/ships` from the response with the `201` status
  - the endpoint scheme security `AccountToken` was removed from the API
  - api tag `Global` removed
  - …6 more

[Change history](https://skmtc.dev/spacetradersapi/apis/spacetraders-api/changes/register/post.md)

---

[API](https://skmtc.dev/spacetradersapi/apis/spacetraders-api.md) · [All operations](https://skmtc.dev/spacetradersapi/apis/spacetraders-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/spacetradersapi/spacetraders-api/revisions/c33f7c19259f/schema)