Skip to content

Register a new K8s agent

POST
/k8s/agents/register
curl --request POST \
--url https://shoehorn.example.com/api/v1/k8s/agents/register \
--header 'Content-Type: application/json' \
--data '{ "cluster_id": "example", "display_name": "example", "environment": "example", "region": "example" }'

Registers a cluster and returns an agent token for push operations.

Media type application/json
object
cluster_id
required
string
display_name
required
string
environment
string
region
string
Example generated
{
"cluster_id": "example",
"display_name": "example",
"environment": "example",
"region": "example"
}

Agent registered

Media type application/json
object
cluster_id
string
token

Bearer token for push API

string
Example generated
{
"cluster_id": "example",
"token": "example"
}