Issue a new agent enrollment token (platform-admin only)

POST

/sencai-agents/generate-token

• Current canonical versioned path (F3.API.01)

Creates a pending sencai-agent record with a random enrollment token and returns the install command the operator runs on the target host. Optionally links the agent to an organisation or an existing cloud-instance (whose organisation is then inherited).

Authorizations

• bearerAuth
• apiTokenAuth

Request Body

object

data

object

hostname

string

os

string

Allowed values: linux windows

capabilities

Array<string>

cloud_instance

Cloud-instance documentId

string

organisation

Organisation documentId

string

Responses

201

Enrollment token issued

object

data

object

agent_id

string

enrollment_token

string

install_command

string

400

Invalid cloud_instance/organisation reference

403

Caller is not a platform administrator