Skip to content

POST /agents/provision

Create a new agent identity on the GNS network.

Request

json
{
  "agentType": "autonomous",
  "agentHandle": "my-agent",
  "homeCells": ["8a2a1072b59ffff"],
  "stellarAddress": "GABCD...",
  "gnsStaked": 100,
  "jurisdiction": "EU"
}
FieldTypeRequiredDescription
agentTypestringyesautonomous, supervised, or deterministic
agentHandlestringnoHuman-readable handle
homeCellsstring[]noH3 cell IDs for territorial binding
stellarAddressstringnoStellar wallet address
gnsStakednumbernoGNS tokens staked
jurisdictionstringnoJurisdiction label

Response

json
{
  "agentId": "agent-abc123",
  "pkRoot": "ed25519-public-key-hex",
  "agentHandle": "my-agent"
}

Released under the MIT License.