Skip to content
Core ConceptsCLI ReferenceAPI Reference
AGH RuntimeAPI Reference

Bridges

AGH Bridges HTTP endpoints.

Audience
Operators running durable agent work
Focus
API Reference guidance shaped for scanability, day-two clarity, and operator context.

List persisted bridge instances

GET/api/bridges

Response Body

application/json

application/json

application/json

curl -X GET "https://loading/api/bridges"
{
  "bridge_health": {
    "property1": {
      "auth_failures_total": 0,
      "bridge_instance_id": "string",
      "degradation": {
        "message": "string",
        "reason": "auth_failed"
      },
      "delivery_backlog": 0,
      "delivery_dropped_by_reason": {
        "property1": 0,
        "property2": 0
      },
      "delivery_dropped_total": 0,
      "delivery_failures_total": 0,
      "last_error": "string",
      "last_error_at": "2019-08-24T14:15:22Z",
      "last_success_at": "2019-08-24T14:15:22Z",
      "route_count": 0,
      "status": "auth_required"
    },
    "property2": {
      "auth_failures_total": 0,
      "bridge_instance_id": "string",
      "degradation": {
        "message": "string",
        "reason": "auth_failed"
      },
      "delivery_backlog": 0,
      "delivery_dropped_by_reason": {
        "property1": 0,
        "property2": 0
      },
      "delivery_dropped_total": 0,
      "delivery_failures_total": 0,
      "last_error": "string",
      "last_error_at": "2019-08-24T14:15:22Z",
      "last_success_at": "2019-08-24T14:15:22Z",
      "route_count": 0,
      "status": "auth_required"
    }
  },
  "bridges": [
    {
      "created_at": "2019-08-24T14:15:22Z",
      "degradation": {
        "message": "string",
        "reason": "auth_failed"
      },
      "delivery_defaults": {
        "group_id": "string",
        "mode": "direct-send",
        "peer_id": "string",
        "thread_id": "string"
      },
      "display_name": "string",
      "dm_policy": "open",
      "enabled": true,
      "extension_name": "string",
      "id": "string",
      "platform": "string",
      "provider_config": {
        "property1": null,
        "property2": null
      },
      "routing_policy": {
        "include_group": true,
        "include_peer": true,
        "include_thread": true
      },
      "scope": "global",
      "source": "dynamic",
      "status": "auth_required",
      "updated_at": "2019-08-24T14:15:22Z",
      "workspace_id": "string"
    }
  ]
}
{
  "error": "string"
}
{
  "error": "string"
}
Empty

Create a bridge instance

POST/api/bridges

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://loading/api/bridges" \  -H "Content-Type: application/json" \  -d '{    "display_name": "string",    "enabled": true,    "extension_name": "string",    "platform": "string",    "routing_policy": {      "include_group": true,      "include_peer": true,      "include_thread": true    },    "scope": "global",    "status": "auth_required"  }'
{
  "bridge": {
    "created_at": "2019-08-24T14:15:22Z",
    "degradation": {
      "message": "string",
      "reason": "auth_failed"
    },
    "delivery_defaults": {
      "group_id": "string",
      "mode": "direct-send",
      "peer_id": "string",
      "thread_id": "string"
    },
    "display_name": "string",
    "dm_policy": "open",
    "enabled": true,
    "extension_name": "string",
    "id": "string",
    "platform": "string",
    "provider_config": {
      "property1": null,
      "property2": null
    },
    "routing_policy": {
      "include_group": true,
      "include_peer": true,
      "include_thread": true
    },
    "scope": "global",
    "source": "dynamic",
    "status": "auth_required",
    "updated_at": "2019-08-24T14:15:22Z",
    "workspace_id": "string"
  },
  "health": {
    "auth_failures_total": 0,
    "bridge_instance_id": "string",
    "degradation": {
      "message": "string",
      "reason": "auth_failed"
    },
    "delivery_backlog": 0,
    "delivery_dropped_by_reason": {
      "property1": 0,
      "property2": 0
    },
    "delivery_dropped_total": 0,
    "delivery_failures_total": 0,
    "last_error": "string",
    "last_error_at": "2019-08-24T14:15:22Z",
    "last_success_at": "2019-08-24T14:15:22Z",
    "route_count": 0,
    "status": "auth_required"
  }
}
{
  "error": "string"
}
{
  "error": "string"
}
{
  "error": "string"
}
{
  "error": "string"
}
Empty

List installed bridge-capable providers

GET/api/bridges/providers

Response Body

application/json

application/json

application/json

curl -X GET "https://loading/api/bridges/providers"
{
  "providers": [
    {
      "config_schema": {
        "schema": "string",
        "version": "string"
      },
      "description": "string",
      "display_name": "string",
      "enabled": true,
      "extension_name": "string",
      "health": "string",
      "health_message": "string",
      "platform": "string",
      "secret_slots": [
        {
          "description": "string",
          "name": "string",
          "required": true
        }
      ],
      "state": "string"
    }
  ]
}
{
  "error": "string"
}
{
  "error": "string"
}
Empty

Get one bridge instance

GET/api/bridges/{id}

Path Parameters

id*string

Bridge instance id

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://loading/api/bridges/string"
{
  "bridge": {
    "created_at": "2019-08-24T14:15:22Z",
    "degradation": {
      "message": "string",
      "reason": "auth_failed"
    },
    "delivery_defaults": {
      "group_id": "string",
      "mode": "direct-send",
      "peer_id": "string",
      "thread_id": "string"
    },
    "display_name": "string",
    "dm_policy": "open",
    "enabled": true,
    "extension_name": "string",
    "id": "string",
    "platform": "string",
    "provider_config": {
      "property1": null,
      "property2": null
    },
    "routing_policy": {
      "include_group": true,
      "include_peer": true,
      "include_thread": true
    },
    "scope": "global",
    "source": "dynamic",
    "status": "auth_required",
    "updated_at": "2019-08-24T14:15:22Z",
    "workspace_id": "string"
  },
  "health": {
    "auth_failures_total": 0,
    "bridge_instance_id": "string",
    "degradation": {
      "message": "string",
      "reason": "auth_failed"
    },
    "delivery_backlog": 0,
    "delivery_dropped_by_reason": {
      "property1": 0,
      "property2": 0
    },
    "delivery_dropped_total": 0,
    "delivery_failures_total": 0,
    "last_error": "string",
    "last_error_at": "2019-08-24T14:15:22Z",
    "last_success_at": "2019-08-24T14:15:22Z",
    "route_count": 0,
    "status": "auth_required"
  }
}
{
  "error": "string"
}
{
  "error": "string"
}
{
  "error": "string"
}
Empty

Update mutable bridge instance fields

PATCH/api/bridges/{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

curl -X PATCH "https://loading/api/bridges/string" \  -H "Content-Type: application/json" \  -d '{}'
{
  "bridge": {
    "created_at": "2019-08-24T14:15:22Z",
    "degradation": {
      "message": "string",
      "reason": "auth_failed"
    },
    "delivery_defaults": {
      "group_id": "string",
      "mode": "direct-send",
      "peer_id": "string",
      "thread_id": "string"
    },
    "display_name": "string",
    "dm_policy": "open",
    "enabled": true,
    "extension_name": "string",
    "id": "string",
    "platform": "string",
    "provider_config": {
      "property1": null,
      "property2": null
    },
    "routing_policy": {
      "include_group": true,
      "include_peer": true,
      "include_thread": true
    },
    "scope": "global",
    "source": "dynamic",
    "status": "auth_required",
    "updated_at": "2019-08-24T14:15:22Z",
    "workspace_id": "string"
  },
  "health": {
    "auth_failures_total": 0,
    "bridge_instance_id": "string",
    "degradation": {
      "message": "string",
      "reason": "auth_failed"
    },
    "delivery_backlog": 0,
    "delivery_dropped_by_reason": {
      "property1": 0,
      "property2": 0
    },
    "delivery_dropped_total": 0,
    "delivery_failures_total": 0,
    "last_error": "string",
    "last_error_at": "2019-08-24T14:15:22Z",
    "last_success_at": "2019-08-24T14:15:22Z",
    "route_count": 0,
    "status": "auth_required"
  }
}
{
  "error": "string"
}
{
  "error": "string"
}
{
  "error": "string"
}
{
  "error": "string"
}
Empty

Disable a bridge instance

POST/api/bridges/{id}/disable

Path Parameters

id*string

Bridge instance id

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://loading/api/bridges/string/disable"
{
  "bridge": {
    "created_at": "2019-08-24T14:15:22Z",
    "degradation": {
      "message": "string",
      "reason": "auth_failed"
    },
    "delivery_defaults": {
      "group_id": "string",
      "mode": "direct-send",
      "peer_id": "string",
      "thread_id": "string"
    },
    "display_name": "string",
    "dm_policy": "open",
    "enabled": true,
    "extension_name": "string",
    "id": "string",
    "platform": "string",
    "provider_config": {
      "property1": null,
      "property2": null
    },
    "routing_policy": {
      "include_group": true,
      "include_peer": true,
      "include_thread": true
    },
    "scope": "global",
    "source": "dynamic",
    "status": "auth_required",
    "updated_at": "2019-08-24T14:15:22Z",
    "workspace_id": "string"
  },
  "health": {
    "auth_failures_total": 0,
    "bridge_instance_id": "string",
    "degradation": {
      "message": "string",
      "reason": "auth_failed"
    },
    "delivery_backlog": 0,
    "delivery_dropped_by_reason": {
      "property1": 0,
      "property2": 0
    },
    "delivery_dropped_total": 0,
    "delivery_failures_total": 0,
    "last_error": "string",
    "last_error_at": "2019-08-24T14:15:22Z",
    "last_success_at": "2019-08-24T14:15:22Z",
    "route_count": 0,
    "status": "auth_required"
  }
}
{
  "error": "string"
}
{
  "error": "string"
}
{
  "error": "string"
}
{
  "error": "string"
}
Empty

Enable a bridge instance

POST/api/bridges/{id}/enable

Path Parameters

id*string

Bridge instance id

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://loading/api/bridges/string/enable"
{
  "bridge": {
    "created_at": "2019-08-24T14:15:22Z",
    "degradation": {
      "message": "string",
      "reason": "auth_failed"
    },
    "delivery_defaults": {
      "group_id": "string",
      "mode": "direct-send",
      "peer_id": "string",
      "thread_id": "string"
    },
    "display_name": "string",
    "dm_policy": "open",
    "enabled": true,
    "extension_name": "string",
    "id": "string",
    "platform": "string",
    "provider_config": {
      "property1": null,
      "property2": null
    },
    "routing_policy": {
      "include_group": true,
      "include_peer": true,
      "include_thread": true
    },
    "scope": "global",
    "source": "dynamic",
    "status": "auth_required",
    "updated_at": "2019-08-24T14:15:22Z",
    "workspace_id": "string"
  },
  "health": {
    "auth_failures_total": 0,
    "bridge_instance_id": "string",
    "degradation": {
      "message": "string",
      "reason": "auth_failed"
    },
    "delivery_backlog": 0,
    "delivery_dropped_by_reason": {
      "property1": 0,
      "property2": 0
    },
    "delivery_dropped_total": 0,
    "delivery_failures_total": 0,
    "last_error": "string",
    "last_error_at": "2019-08-24T14:15:22Z",
    "last_success_at": "2019-08-24T14:15:22Z",
    "route_count": 0,
    "status": "auth_required"
  }
}
{
  "error": "string"
}
{
  "error": "string"
}
{
  "error": "string"
}
{
  "error": "string"
}
Empty

Restart a bridge instance

POST/api/bridges/{id}/restart

Path Parameters

id*string

Bridge instance id

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://loading/api/bridges/string/restart"
{
  "bridge": {
    "created_at": "2019-08-24T14:15:22Z",
    "degradation": {
      "message": "string",
      "reason": "auth_failed"
    },
    "delivery_defaults": {
      "group_id": "string",
      "mode": "direct-send",
      "peer_id": "string",
      "thread_id": "string"
    },
    "display_name": "string",
    "dm_policy": "open",
    "enabled": true,
    "extension_name": "string",
    "id": "string",
    "platform": "string",
    "provider_config": {
      "property1": null,
      "property2": null
    },
    "routing_policy": {
      "include_group": true,
      "include_peer": true,
      "include_thread": true
    },
    "scope": "global",
    "source": "dynamic",
    "status": "auth_required",
    "updated_at": "2019-08-24T14:15:22Z",
    "workspace_id": "string"
  },
  "health": {
    "auth_failures_total": 0,
    "bridge_instance_id": "string",
    "degradation": {
      "message": "string",
      "reason": "auth_failed"
    },
    "delivery_backlog": 0,
    "delivery_dropped_by_reason": {
      "property1": 0,
      "property2": 0
    },
    "delivery_dropped_total": 0,
    "delivery_failures_total": 0,
    "last_error": "string",
    "last_error_at": "2019-08-24T14:15:22Z",
    "last_success_at": "2019-08-24T14:15:22Z",
    "route_count": 0,
    "status": "auth_required"
  }
}
{
  "error": "string"
}
{
  "error": "string"
}
{
  "error": "string"
}
{
  "error": "string"
}
Empty

List routes owned by a bridge instance

GET/api/bridges/{id}/routes

Path Parameters

id*string

Bridge instance id

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://loading/api/bridges/string/routes"
{
  "routes": [
    {
      "agent_name": "string",
      "bridge_instance_id": "string",
      "created_at": "2019-08-24T14:15:22Z",
      "group_id": "string",
      "last_activity_at": "2019-08-24T14:15:22Z",
      "peer_id": "string",
      "routing_key_hash": "string",
      "scope": "global",
      "session_id": "string",
      "thread_id": "string",
      "updated_at": "2019-08-24T14:15:22Z",
      "workspace_id": "string"
    }
  ]
}
{
  "error": "string"
}
{
  "error": "string"
}
{
  "error": "string"
}
Empty

List persisted secret bindings for a bridge instance

GET/api/bridges/{id}/secret-bindings

Path Parameters

id*string

Bridge instance id

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://loading/api/bridges/string/secret-bindings"
{
  "bindings": [
    {
      "binding_name": "string",
      "bridge_instance_id": "string",
      "created_at": "2019-08-24T14:15:22Z",
      "kind": "string",
      "secret_ref": "string",
      "updated_at": "2019-08-24T14:15:22Z"
    }
  ]
}
{
  "error": "string"
}
{
  "error": "string"
}
{
  "error": "string"
}
Empty

Delete one bridge secret binding

DELETE/api/bridges/{id}/secret-bindings/{binding_name}

Path Parameters

id*string

Bridge instance id

binding_name*string

Bridge provider secret slot name

Response Body

application/json

application/json

application/json

curl -X DELETE "https://loading/api/bridges/string/secret-bindings/string"
Empty
{
  "error": "string"
}
{
  "error": "string"
}
{
  "error": "string"
}
Empty

Create or update one bridge secret binding

PUT/api/bridges/{id}/secret-bindings/{binding_name}

Path Parameters

id*string

Bridge instance id

binding_name*string

Bridge provider secret slot 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

application/json

curl -X PUT "https://loading/api/bridges/string/secret-bindings/string" \  -H "Content-Type: application/json" \  -d '{    "kind": "string",    "secret_ref": "string"  }'
{
  "binding": {
    "binding_name": "string",
    "bridge_instance_id": "string",
    "created_at": "2019-08-24T14:15:22Z",
    "kind": "string",
    "secret_ref": "string",
    "updated_at": "2019-08-24T14:15:22Z"
  }
}
{
  "error": "string"
}
{
  "error": "string"
}
{
  "error": "string"
}
{
  "error": "string"
}
{
  "error": "string"
}
Empty

Resolve a typed outbound delivery target for a bridge instance

POST/api/bridges/{id}/test-delivery

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://loading/api/bridges/string/test-delivery" \  -H "Content-Type: application/json" \  -d '{    "target": {}  }'
{
  "delivery_target": {
    "bridge_instance_id": "string",
    "group_id": "string",
    "mode": "direct-send",
    "peer_id": "string",
    "thread_id": "string"
  },
  "message": "string",
  "status": "string"
}
{
  "error": "string"
}
{
  "error": "string"
}
{
  "error": "string"
}
{
  "error": "string"
}
{
  "error": "string"
}
Empty

Automation

AGH Automation HTTP endpoints.

Network

AGH Network HTTP endpoints.