/agents/{id} (GET)

GET

/agents/{id}

const url = 'https://culipulse.dev/v1/agents/mon_123';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://culipulse.dev/v1/agents/mon_123 \
  --header 'Authorization: Bearer <token>'

Authorizations

bearerAuth
read

Parameters

Path Parameters

required

string

Example

mon_123

Responses

200

Agent detail

application/json

object

required

string

tenant_id

required

Null for CuliPulse-run (first_party) agents.

string | null

kind

required

string

Allowed values: tenant first_party

name

required

string

region

required

string | null

capabilities

version

required

string | null

arch

required

string | null

last_seen_at

required

integer | null

created_at

required

integer

Example

{
  "kind": "tenant"
}

401

Unauthorized

application/json

object

error

required

string

request_id

string

code

Present on some 400s so a client can branch without parsing error. Known values: channel_limit_reached, too_many_monitors, duplicate_webhook_url.

string

field

The request field the error is about, when there is one.

string

limit

The limit that was hit, when code names one.

integer

Example

{
  "error": "not found",
  "request_id": "req_abc123",
  "code": "channel_limit_reached"
}

404

Not found

application/json

object

error

required

string

request_id

string

code

Present on some 400s so a client can branch without parsing error. Known values: channel_limit_reached, too_many_monitors, duplicate_webhook_url.

string

field

The request field the error is about, when there is one.

string

limit

The limit that was hit, when code names one.

integer

Example

{
  "error": "not found",
  "request_id": "req_abc123",
  "code": "channel_limit_reached"
}