Register federated server

POST

/api/federation/register

curl --request POST \
  --url http://localhost:3001/api/federation/register \
  --header 'Content-Type: application/json' \
  --data '{ "capacity": 1, "challenge": "example", "public_key": "example", "region": "example", "server_id": "example", "server_url": "example", "signature": "example", "timestamp": 1 }'

• Local development
• Production

Registers a federated server with cryptographic identity verification

Request Body^required

Server registration details

Media typeapplication/json

object

capacity

integer

challenge

string

public_key

string

region

string

server_id

string

server_url

string

signature

string

timestamp

integer format: int64

Example^generated

{
  "capacity": 1,
  "challenge": "example",
  "public_key": "example",
  "region": "example",
  "server_id": "example",
  "server_url": "example",
  "signature": "example",
  "timestamp": 1
}

Responses

200

OK

Media typeapplication/json

object

key

additional properties

any

Example^generated

{}

400

Bad Request

Media typeapplication/json

object

error

string

success

boolean

Example^generated

{
  "error": "example",
  "success": true
}

403

Forbidden

Media typeapplication/json

object

error

string

success

boolean

Example^generated

{
  "error": "example",
  "success": true
}

500

Internal Server Error

Media typeapplication/json

object

error

string

success

boolean

Example^generated

{
  "error": "example",
  "success": true
}