POST
/
organisations
/
{organisationId}
/
myFirstBoard
curl --request POST \
  --url https://api.switchboard.svc.versori.io/v1alpha1/organisations/{organisationId}/myFirstBoard \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "orgId": "<string>",
  "name": "<string>",
  "hubId": "<string>",
  "status": "unknown",
  "activePublishInfo": {
    "id": "<string>",
    "taskId": "<string>",
    "lastEventId": "<string>",
    "listeners": [
      {
        "id": "<string>",
        "appNodeId": "<string>",
        "operationNodeId": "<string>",
        "url": "<string>",
        "contentType": "<string>",
        "security": {},
        "additionalHeaders": {},
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "deletedAt": "2023-11-07T05:31:56Z"
      }
    ],
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "deletedAt": "2023-11-07T05:31:56Z"
  },
  "recentPublishHistory": [
    {
      "id": "<string>",
      "taskId": "<string>",
      "lastEventId": "<string>",
      "listeners": [
        {
          "id": "<string>",
          "appNodeId": "<string>",
          "operationNodeId": "<string>",
          "url": "<string>",
          "contentType": "<string>",
          "security": {},
          "additionalHeaders": {},
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z",
          "deletedAt": "2023-11-07T05:31:56Z"
        }
      ],
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "deletedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "deletedAt": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization
string
headerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

organisationId
string
required

Response

200 - application/json
id
string
required
orgId
string
required
name
string
required
hubId
string
status
enum<string>
required

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.

Available options:
unknown,
draft,
publishing,
published,
unpublishing
activePublishInfo
object

BoardPublishInfo provides information on a published board instance

recentPublishHistory
object[]

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.

createdAt
string
required
updatedAt
string
required
deletedAt
string