Bridges
Integration bridge management
All endpoints require a bearer token (oh_... API key or user JWT) and are served under https://api.orderly-hub.com. Use the Try it consoles to run a request against the Preview (test) server.
List bridges
GET
/api/v1/bridgesParameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
page | query | no | integer | |
limit | query | no | integer | |
status | query | no | string | |
type | query | no | string |
Responses
200 Paginated bridge list
GET
/api/v1/bridgesList bridges
https://api-test.orderly-hub.com/api/v1/bridgesCreate a bridge
POST
/api/v1/bridgesRequest body
| Field | Type | Description |
|---|---|---|
type | string | |
name | string | |
config | object | |
metadata | object |
{
"type": "string",
"name": "Jane Doe",
"config": {},
"metadata": {}
}
Responses
201 Bridge created
POST
/api/v1/bridgesCreate a bridge
https://api-test.orderly-hub.com/api/v1/bridgesGet single bridge
GET
/api/v1/bridges/{id}Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
id | path | yes | string |
Responses
200 Bridge details
404 Bridge not found
GET
/api/v1/bridges/{id}Get single bridge
https://api-test.orderly-hub.com/api/v1/bridges/Update a bridge
PATCH
/api/v1/bridges/{id}Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
id | path | yes | string |
Request body
| Field | Type | Description |
|---|---|---|
name | string | |
config | object | |
status | string | |
metadata | object |
{
"name": "Jane Doe",
"config": {},
"status": "pending",
"metadata": {}
}
Responses
200 Bridge updated
PATCH
/api/v1/bridges/{id}Update a bridge
https://api-test.orderly-hub.com/api/v1/bridges/Delete a bridge
DELETE
/api/v1/bridges/{id}Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
id | path | yes | string |
Responses
200 Bridge deleted
DELETE
/api/v1/bridges/{id}Delete a bridge
https://api-test.orderly-hub.com/api/v1/bridges/Get available tasks for a bridge
GET
/api/v1/bridges/{id}/tasksParameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
id | path | yes | string |
Responses
200 List of available tasks
GET
/api/v1/bridges/{id}/tasksGet available tasks for a bridge
https://api-test.orderly-hub.com/api/v1/bridges//tasksList webhooks for a bridge
GET
/api/v1/bridges/{id}/webhooksParameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
id | path | yes | string |
Responses
200 Webhook list
GET
/api/v1/bridges/{id}/webhooksList webhooks for a bridge
https://api-test.orderly-hub.com/api/v1/bridges//webhooksRegister a webhook for a bridge
POST
/api/v1/bridges/{id}/webhooksParameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
id | path | yes | string |
Request body
| Field | Type | Description |
|---|---|---|
topic | string |
{
"topic": "string"
}
Responses
201 Webhook registered
POST
/api/v1/bridges/{id}/webhooksRegister a webhook for a bridge
https://api-test.orderly-hub.com/api/v1/bridges//webhooksUnregister a webhook topic
DELETE
/api/v1/bridges/{id}/webhooks/{topic}Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
id | path | yes | string | |
topic | path | yes | string |
Responses
200 Webhook unregistered
DELETE
/api/v1/bridges/{id}/webhooks/{topic}Unregister a webhook topic
https://api-test.orderly-hub.com/api/v1/bridges//webhooks/