Skip to content

Gateway

Compozy Gateway HTTP endpoints.

For people running agent work31 pages in this section

Probe one bound bridge callback

GET/api/bridge-callbacks/{id}

Path Parameters

id*string

Bridge instance id

Response Body

*/*

application/json

application/json

application/json

application/json

application/json

application/json

*/*

curl -X GET "https://example.com/api/bridge-callbacks/string"
"string"

Deliver one bound bridge callback

POST/api/bridge-callbacks/{id}

Path Parameters

id*string

Bridge instance id

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

*/*

application/json

application/json

application/json

application/json

application/json

application/json

*/*

curl -X POST "https://example.com/api/bridge-callbacks/string" \  -H "Content-Type: application/json" \  -d '{    "property1": null,    "property2": null  }'
"string"

Probe one bound bridge callback

HEAD/api/bridge-callbacks/{id}

Path Parameters

id*string

Bridge instance id

Response Body

*/*

application/json

application/json

application/json

application/json

application/json

application/json

*/*

curl -X HEAD "https://example.com/api/bridge-callbacks/string"
"string"

Audit the current gateway security posture

GET/api/gateway/audit

Response Body

application/json

application/json

curl -X GET "https://example.com/api/gateway/audit"
{  "auth": {    "active_device_count": 0,    "mode": "string",    "required_remotely": true  },  "device_highlights": {    "active": 0,    "recently_paired": 0,    "revoked": 0,    "stale": 0,    "stale_device_ids": [      "string"    ]  },  "findings": [    {      "id": "string",      "remediation": "string",      "resource": "string",      "severity": "string",      "summary": "string",      "tier": "string"    }  ],  "local_only": true,  "no_findings": true,  "ran": true,  "status": {    "addresses": [      {        "address": "string",        "live": true,        "tier": "string"      }    ],    "bindings": [      {        "confirmed_at": "2019-08-24T14:15:22Z",        "confirmed_endpoint_generation": 0,        "enable_path": "string",        "endpoint_generation": 0,        "reachability": "string",        "scope_kind": "string",        "subject_id": "string",        "subject_kind": "string",        "url": "string",        "workspace_id": "string"      }    ],    "changed": true,    "devices": [      {        "actor_kind": "string",        "created_at": "2019-08-24T14:15:22Z",        "id": "string",        "last_seen_at": "2019-08-24T14:15:22Z",        "name": "string",        "pairing_origin": "string",        "revoke_epoch": 0,        "revoked_at": "2019-08-24T14:15:22Z"      }    ],    "enabled": true,    "providers": [      {        "cause": "string",        "desired": "string",        "generation": 0,        "health": "string",        "name": "string",        "observed": "string",        "tier": "string"      }    ],    "refusal": {      "cause": "string",      "fix": "string"    },    "surfaces": [      {        "desired": "string",        "generation": 0,        "observed": "string",        "surface": "string",        "tier": "string"      }    ],    "tiers": [      {        "advertised": true,        "desired": "string",        "listener_address": "string",        "observed": "string",        "tier": "string"      }    ]  }}

List the operator-global paired device inventory

GET/api/gateway/devices

Response Body

application/json

application/json

curl -X GET "https://example.com/api/gateway/devices"
{  "devices": [    {      "actor_kind": "string",      "created_at": "2019-08-24T14:15:22Z",      "id": "string",      "last_seen_at": "2019-08-24T14:15:22Z",      "name": "string",      "pairing_origin": "string",      "revoke_epoch": 0,      "revoked_at": "2019-08-24T14:15:22Z"    }  ]}

Rename one paired gateway device

PATCH/api/gateway/devices/{id}

Path Parameters

id*string

Gateway device id

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/api/gateway/devices/string" \  -H "Content-Type: application/json" \  -d '{    "name": "string"  }'
{  "actor_kind": "string",  "created_at": "2019-08-24T14:15:22Z",  "id": "string",  "last_seen_at": "2019-08-24T14:15:22Z",  "name": "string",  "pairing_origin": "string",  "revoke_epoch": 0,  "revoked_at": "2019-08-24T14:15:22Z"}

Revoke one paired gateway device and its live streams

DELETE/api/gateway/devices/{id}

Path Parameters

id*string

Gateway device id

Response Body

application/json

application/json

application/json

curl -X DELETE "https://example.com/api/gateway/devices/string"
{  "canceled": 0,  "changed": true,  "device": {    "actor_kind": "string",    "created_at": "2019-08-24T14:15:22Z",    "id": "string",    "last_seen_at": "2019-08-24T14:15:22Z",    "name": "string",    "pairing_origin": "string",    "revoke_epoch": 0,    "revoked_at": "2019-08-24T14:15:22Z"  }}

Confirm one subject against the verified public endpoint

POST/api/gateway/ingress-bindings

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/gateway/ingress-bindings" \  -H "Content-Type: application/json" \  -d '{    "confirmed": true,    "subject_id": "string",    "subject_kind": "string"  }'
{  "binding": {    "confirmed_at": "2019-08-24T14:15:22Z",    "confirmed_endpoint_generation": 0,    "enable_path": "string",    "endpoint_generation": 0,    "reachability": "string",    "scope_kind": "string",    "subject_id": "string",    "subject_kind": "string",    "url": "string",    "workspace_id": "string"  },  "changed": true}

Remove one public ingress confirmation

DELETE/api/gateway/ingress-bindings/{subject_kind}/{subject_id}

Path Parameters

subject_kind*string

Ingress subject kind

subject_id*string

Ingress subject id

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/api/gateway/ingress-bindings/string/string"
{  "changed": true,  "subject_id": "string",  "subject_kind": "string"}

Mint a bounded one-time gateway pairing artifact

POST/api/gateway/pairings

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/gateway/pairings"
{  "artifact": "string",  "expires_at": "2019-08-24T14:15:22Z"}

Redeem a one-time gateway pairing artifact

POST/api/gateway/pairings/redeem

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/gateway/pairings/redeem" \  -H "Content-Type: application/json" \  -d '{    "actor_kind": "string",    "artifact": "string",    "name": "string"  }'
{  "credential": "string",  "device": {    "actor_kind": "string",    "created_at": "2019-08-24T14:15:22Z",    "id": "string",    "last_seen_at": "2019-08-24T14:15:22Z",    "name": "string",    "pairing_origin": "string",    "revoke_epoch": 0,    "revoked_at": "2019-08-24T14:15:22Z"  }}

Disable one named connectivity provider for a gateway tier

POST/api/gateway/providers/{name}/disable

Path Parameters

name*string

Connectivity provider name

Query Parameters

tier*string

Gateway tier

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/gateway/providers/string/disable?tier=string"
{  "addresses": [    {      "address": "string",      "live": true,      "tier": "string"    }  ],  "bindings": [    {      "confirmed_at": "2019-08-24T14:15:22Z",      "confirmed_endpoint_generation": 0,      "enable_path": "string",      "endpoint_generation": 0,      "reachability": "string",      "scope_kind": "string",      "subject_id": "string",      "subject_kind": "string",      "url": "string",      "workspace_id": "string"    }  ],  "changed": true,  "devices": [    {      "actor_kind": "string",      "created_at": "2019-08-24T14:15:22Z",      "id": "string",      "last_seen_at": "2019-08-24T14:15:22Z",      "name": "string",      "pairing_origin": "string",      "revoke_epoch": 0,      "revoked_at": "2019-08-24T14:15:22Z"    }  ],  "enabled": true,  "providers": [    {      "cause": "string",      "desired": "string",      "generation": 0,      "health": "string",      "name": "string",      "observed": "string",      "tier": "string"    }  ],  "refusal": {    "cause": "string",    "fix": "string"  },  "surfaces": [    {      "desired": "string",      "generation": 0,      "observed": "string",      "surface": "string",      "tier": "string"    }  ],  "tiers": [    {      "advertised": true,      "desired": "string",      "listener_address": "string",      "observed": "string",      "tier": "string"    }  ]}

Enable one connectivity provider for a gateway tier

POST/api/gateway/providers/{name}/enable

Path Parameters

name*string

Connectivity provider name

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/gateway/providers/string/enable" \  -H "Content-Type: application/json" \  -d '{    "expected_generation": 0,    "install_source": "string",    "tier": "string"  }'
{  "addresses": [    {      "address": "string",      "live": true,      "tier": "string"    }  ],  "bindings": [    {      "confirmed_at": "2019-08-24T14:15:22Z",      "confirmed_endpoint_generation": 0,      "enable_path": "string",      "endpoint_generation": 0,      "reachability": "string",      "scope_kind": "string",      "subject_id": "string",      "subject_kind": "string",      "url": "string",      "workspace_id": "string"    }  ],  "changed": true,  "devices": [    {      "actor_kind": "string",      "created_at": "2019-08-24T14:15:22Z",      "id": "string",      "last_seen_at": "2019-08-24T14:15:22Z",      "name": "string",      "pairing_origin": "string",      "revoke_epoch": 0,      "revoked_at": "2019-08-24T14:15:22Z"    }  ],  "enabled": true,  "providers": [    {      "cause": "string",      "desired": "string",      "generation": 0,      "health": "string",      "name": "string",      "observed": "string",      "tier": "string"    }  ],  "refusal": {    "cause": "string",    "fix": "string"  },  "surfaces": [    {      "desired": "string",      "generation": 0,      "observed": "string",      "surface": "string",      "tier": "string"    }  ],  "tiers": [    {      "advertised": true,      "desired": "string",      "listener_address": "string",      "observed": "string",      "tier": "string"    }  ]}

Get the operator-global gateway posture

GET/api/gateway/status

Response Body

application/json

application/json

curl -X GET "https://example.com/api/gateway/status"
{  "addresses": [    {      "address": "string",      "live": true,      "tier": "string"    }  ],  "bindings": [    {      "confirmed_at": "2019-08-24T14:15:22Z",      "confirmed_endpoint_generation": 0,      "enable_path": "string",      "endpoint_generation": 0,      "reachability": "string",      "scope_kind": "string",      "subject_id": "string",      "subject_kind": "string",      "url": "string",      "workspace_id": "string"    }  ],  "changed": true,  "devices": [    {      "actor_kind": "string",      "created_at": "2019-08-24T14:15:22Z",      "id": "string",      "last_seen_at": "2019-08-24T14:15:22Z",      "name": "string",      "pairing_origin": "string",      "revoke_epoch": 0,      "revoked_at": "2019-08-24T14:15:22Z"    }  ],  "enabled": true,  "providers": [    {      "cause": "string",      "desired": "string",      "generation": 0,      "health": "string",      "name": "string",      "observed": "string",      "tier": "string"    }  ],  "refusal": {    "cause": "string",    "fix": "string"  },  "surfaces": [    {      "desired": "string",      "generation": 0,      "observed": "string",      "surface": "string",      "tier": "string"    }  ],  "tiers": [    {      "advertised": true,      "desired": "string",      "listener_address": "string",      "observed": "string",      "tier": "string"    }  ]}

Mint a short-lived single-use stream ticket

POST/api/gateway/stream-tickets

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/api/gateway/stream-tickets"
{  "expires_at": "2019-08-24T14:15:22Z",  "ticket": "string"}

Set durable exposure for one gateway surface

POST/api/gateway/surfaces

Request Body

application/json

JSON request body

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/gateway/surfaces" \  -H "Content-Type: application/json" \  -d '{    "consent": true,    "desired": "string",    "expected_generation": 0,    "surface": "string",    "tier": "string"  }'
{  "addresses": [    {      "address": "string",      "live": true,      "tier": "string"    }  ],  "bindings": [    {      "confirmed_at": "2019-08-24T14:15:22Z",      "confirmed_endpoint_generation": 0,      "enable_path": "string",      "endpoint_generation": 0,      "reachability": "string",      "scope_kind": "string",      "subject_id": "string",      "subject_kind": "string",      "url": "string",      "workspace_id": "string"    }  ],  "changed": true,  "devices": [    {      "actor_kind": "string",      "created_at": "2019-08-24T14:15:22Z",      "id": "string",      "last_seen_at": "2019-08-24T14:15:22Z",      "name": "string",      "pairing_origin": "string",      "revoke_epoch": 0,      "revoked_at": "2019-08-24T14:15:22Z"    }  ],  "enabled": true,  "providers": [    {      "cause": "string",      "desired": "string",      "generation": 0,      "health": "string",      "name": "string",      "observed": "string",      "tier": "string"    }  ],  "refusal": {    "cause": "string",    "fix": "string"  },  "surfaces": [    {      "desired": "string",      "generation": 0,      "observed": "string",      "surface": "string",      "tier": "string"    }  ],  "tiers": [    {      "advertised": true,      "desired": "string",      "listener_address": "string",      "observed": "string",      "tier": "string"    }  ]}

Extensions

Compozy Extensions HTTP endpoints.

Vault

Compozy Vault HTTP endpoints.