Skip to content
Sencai Logo Sencai Logo Sencai Docs

Create a sencai-agent

POST
/sencai-agents

Authorizations

Section titled “Authorizations ”

Request Body required

Section titled “Request Body required ”
object
data
object
hostname
string
organisation
One of:

DocumentId reference to api::organisation.organisation

string
cloud_instance
One of:

DocumentId reference to api::cloud-instance.cloud-instance

string
version
string
os
string
Allowed values: linux windows
arch
string
enrolled_at
string format: date-time
last_heartbeat_at
string format: date-time
capabilities

Arbitrary JSON value (object, array, string, number, boolean, or null)

cert_fingerprint
string
enrollment_token
string
status
string
Allowed values: pending active disconnected revoked

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Created

object
data
object
hostname
string
organisation
One of:

DocumentId reference to api::organisation.organisation

string
cloud_instance
One of:

DocumentId reference to api::cloud-instance.cloud-instance

string
version
string
os
string
Allowed values: linux windows
arch
string
enrolled_at
string format: date-time
last_heartbeat_at
string format: date-time
capabilities

Arbitrary JSON value (object, array, string, number, boolean, or null)

cert_fingerprint
string
enrollment_token
string
status
string
Allowed values: pending active disconnected revoked
documentId
string
id
integer
createdAt
string format: date-time
updatedAt
string format: date-time
publishedAt
string format: date-time
nullable

400

Section titled “400 ”

Validation error

401

Section titled “401 ”

Missing or invalid authentication

403

Section titled “403 ”

Not authorized (tenant scope or capability)