API Reference
- Switchboard API
- POSTPreview the output of a transformer.
- boards
- GETGet organisations boards
- POSTPost organisations boards
- POSTPost organisations myfirstboard
- PUTPut organisations boards
- DELDelete organisations boards
- POSTPreview the output of a Code Action.
- POSTPost organisations boards actors test
- POSTPost organisations boards publish
- POSTPost organisations boards unpublish
- GETGet organisations boards out of date board nodes
- GETGet organisations boards variables
- PUTPut organisations boards variables
- PUTPut organisations boards variablesglobal
- PUTPut organisations boards variablesdynamic
- GETGet organisations out of date board nodes
- GETGet organisations boards actors codelogs
- GETGet organisations boards execution logs
- POSTPost organisations board instances incoming webhooks
- POSTPost organisations board instances trigger execution
- GET
- hubs
- data-mappings
- apps
- operations
- schemas
- GETGet organisations schema utils signed url
- POSTPost organisations schema utils source url
- POSTPost organisations schema utils info
- connections
- credentials
- GETGet organisations signed url
- POST
Get organisations boards
Retrieves the boards belonging to a given organisation.
Authorizations
Path Parameters
Response
BoardStatus is used to indicate the status of a board. The "unknown" status is used in case of inconsistencies in the database with the Board scheduler and the API cannot deduce the correct status without administrator intervention.
If the status is "unknown", then clients should assume it's in a draft/published state based on whether the board has an "activePublishInfo" field. If a board cannot be published due to it already being published and the "activePublishInfo" field is null, users should contact support.
unknown, draft, publishing, published, unpublishing BoardPublishInfo provides information on a published board instance
LastEventID is the last observed event before this board was published. This may not be the last event on the stream for this board, since the observer may not have replayed all events at the time of publish. As such, the version of the board which will be executed is defined by this field, and not necessarily the latest event on the stream.
AppNodeID is the identifier of the App Node to which this listener's operation belongs to.
ContentType is the "content-type" header for which data should be sent with. Initially only "application/json" is supported but other content types may be added in the future.
OperationNodeID is the identifier of the Operation within the App Node, which is listening for data from an external source.
URL is the address for where the Node specified by NodeID is listening. Downstream services (such as webhooks) should be configured with this URL.
AdditionalHeaders describes any other headers which the downstream service must supply with the request.
Security defines any parameters which external services must supply in order for Switchboard to acknowledge an incoming event. If this is defined but an external service does not supply matching information, the event will be ignored.
TaskID is a unique identifier for the execution of a board. Each time a board is (re)published a new task ID will be generated.
RecentPublishHistory is an array of BoardPublishInfo containing up to the last 5 publishes for a board. If full history is required, users should use the ListPublishHistory operation for a paginated view.
LastEventID is the last observed event before this board was published. This may not be the last event on the stream for this board, since the observer may not have replayed all events at the time of publish. As such, the version of the board which will be executed is defined by this field, and not necessarily the latest event on the stream.
AppNodeID is the identifier of the App Node to which this listener's operation belongs to.
ContentType is the "content-type" header for which data should be sent with. Initially only "application/json" is supported but other content types may be added in the future.
OperationNodeID is the identifier of the Operation within the App Node, which is listening for data from an external source.
URL is the address for where the Node specified by NodeID is listening. Downstream services (such as webhooks) should be configured with this URL.
AdditionalHeaders describes any other headers which the downstream service must supply with the request.
Security defines any parameters which external services must supply in order for Switchboard to acknowledge an incoming event. If this is defined but an external service does not supply matching information, the event will be ignored.
TaskID is a unique identifier for the execution of a board. Each time a board is (re)published a new task ID will be generated.