# /systems/register - Register system with system_secret

**POST /systems/register**

Public endpoint for external systems to register themselves using their system_secret token.
This endpoint does NOT require authentication - the system_secret itself provides authentication.

**Token Format:** `my_<public_part>.<secret_part>`

**Workflow:**
1. User creates system in management UI → receives system_secret (one time only)
2. External system uses system_secret to register → receives system_key
3. External system uses system_key for future operations (inventory, heartbeat)

**Important:**
- Systems can only be registered once
- Deleted systems cannot be registered
- The system_secret is validated using Argon2id hashing



## Servers
- Backend API server (port 8080): https://api.your-domain.com/api (Backend API server (port 8080))
- Collect API server (port 8081): https://collect.your-domain.com/api (Collect API server (port 8081))



## Parameters



### Body: application/json (object)

- **system_secret** (string)
  System secret token in format my_<public>.<secret>


## Responses
### 200
System registered successfully

#### Body: application/json (object)
- **code** (integer)

- **message** (string)

- **data** (object)


### 400
Invalid system secret format

#### Body: application/json (object)
- **code** (integer)

- **message** (string)


### 401
Invalid system secret (authentication failed)

#### Body: application/json (object)
- **code** (integer)

- **message** (string)


### 403
System has been deleted

#### Body: application/json (object)
- **code** (integer)

- **message** (string)


### 409
System is already registered

#### Body: application/json (object)
- **code** (integer)

- **message** (string)


### 500
Internal server error

#### Body: application/json (object)
- **code** (integer)

- **message** (string)

- **data** (object | null)



[Powered by Bump.sh](https://bump.sh)