Global

Register New Agent

Creates a new agent and ties it to an account. The agent symbol must consist of a 3-14 character string, and will be used to represent your agent. This symbol will prefix the symbol of every ship you own. Agent symbols will be cast to all uppercase characters.

This new agent will be tied to a starting faction of your choice, which determines your starting location, and will be granted an authorization token, a contract with their starting faction, a command ship that can fly across space with advanced capabilities, a small probe ship that can be used for reconnaissance, and 175,000 credits.

Keep your token safe and secure

Keep careful track of where you store your token. You can generate a new token from our account dashboard, but if someone else gains access to your token they will be able to use it to make API requests on your behalf until the end of the reset.

If you are new to SpaceTraders, It is recommended to register with the COSMIC faction, a faction that is well connected to the rest of the universe. After registering, you should try our interactive quickstart guide which will walk you through a few basic API requests in just a few minutes.

post/register

Request body

factionFactionSymbolJson required— unresolved $ref

symbolstring required

Your desired agent symbol. This will be a unique name used to represent your agent, and will be the prefix for your ships.

emailstring

Your email address. This is used if you reserved your call sign between resets.

Response

Successfully registered.

Changes

Changed in 8 of the 50 revisions of this API.13118

Mar 10, 20256c351be600a011See the full diff
- ▲
  removed the required property data/ship from the response with the 201 status
  response-required-property-removed
- ○
  added the optional property data/ships to the response with the 201 status
  response-optional-property-added
Feb 13, 2025bc6e0ed161212See the full diff
- ○
  the endpoint scheme security AccountToken was added to the API
  api-security-added
- ○
  api tag Global added
  api-tag-added
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 17, 20231c234285ea7d1See the full diff
- ○
  the endpoint scheme security AgentToken was removed from the API
  api-security-removed
Jun 10, 202369f25747ca361See the full diff
- ○
  the endpoint scheme security AgentToken was added to the API
  api-security-added
Jun 3, 20235a2f0683851a5See the full diff
- ▲
  removed the enum value COSMIC of the request property faction
  request-property-enum-value-removed
- ▲
  removed the enum value DOMINION of the request property faction
  request-property-enum-value-removed
- ▲
  removed the enum value GALACTIC of the request property faction
  request-property-enum-value-removed
- ▲
  removed the enum value QUANTUM of the request property faction
  request-property-enum-value-removed
- ▲
  removed the enum value VOID of the request property faction
  request-property-enum-value-removed
Jun 1, 20236cd38661e5a215See the full diff
- ▲
  request property faction was restricted to a list of enum values
  request-property-became-enum
- ○
  added the new COSMIC enum value to the request property faction
  request-property-enum-value-added
- ○
  added the new DOMINION enum value to the request property faction
  request-property-enum-value-added
- ○
  added the new GALACTIC enum value to the request property faction
  request-property-enum-value-added
- ○
  added the new QUANTUM enum value to the request property faction
  request-property-enum-value-added
- ○
  added the new VOID enum value to the request property faction
  request-property-enum-value-added
May 28, 2023b5c3ad5c213b5See the full diff
- ▲
  removed the enum value COSMIC of the request property faction
  request-property-enum-value-removed
- ▲
  removed the enum value DOMINION of the request property faction
  request-property-enum-value-removed
- ▲
  removed the enum value GALACTIC of the request property faction
  request-property-enum-value-removed
- ▲
  removed the enum value QUANTUM of the request property faction
  request-property-enum-value-removed
- ▲
  removed the enum value VOID of the request property faction
  request-property-enum-value-removed
May 20, 202386f8c56c4690118See the full diff
- ▲
  request property faction was restricted to a list of enum values
  request-property-became-enum
- ●
  removed the optional property data/ships from the response with the 201 status
  response-optional-property-removed
- ○
  the endpoint scheme security AccountToken was removed from the API
  api-security-removed
- ○
  api tag Global removed
  api-tag-removed
- ○
  added the new COSMIC enum value to the request property faction
  request-property-enum-value-added
- ○
  added the new DOMINION enum value to the request property faction
  request-property-enum-value-added
- ○
  added the new GALACTIC enum value to the request property faction
  request-property-enum-value-added
- ○
  added the new QUANTUM enum value to the request property faction
  request-property-enum-value-added
- ○
  added the new VOID enum value to the request property faction
  request-property-enum-value-added
- ○
  added the required property data/ship to the response with the 201 status
  response-required-property-added
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 50 revisions, 2 have no diff computed.

Full history