Skip to content

Reorders and hides/shows the exact automatic list; stale or foreign membership is rejected.

PUT
/api/workspace/workflow/configuration/boards/{boardId}/presentation
curl --request PUT \
--url https://example.com/api/workspace/workflow/configuration/boards/example/presentation \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "ExpectedVersion": "example", "Items": [ { "WorkflowDefinitionId": "example", "Visible": true, "ShowInSignalBar": true } ], "OperationId": "example" }'
boardId
required
string
access_token
string

Optional access token for clients that cannot set Authorization headers. Prefer Authorization: Bearer <token> when possible.

Replaces presentation choices for the exact automatic list, never attaching or detaching a Workflow.

object
ExpectedVersion
string
nullable
Items
Array<object>
nullable

One display-only choice; the order of request items defines their presentation sequence.

object
WorkflowDefinitionId
string
nullable
Visible
boolean
ShowInSignalBar
boolean
OperationId
string
nullable
Examplegenerated
{
"ExpectedVersion": "example",
"Items": [
{
"WorkflowDefinitionId": "example",
"Visible": true,
"ShowInSignalBar": true
}
],
"OperationId": "example"
}

OK

Media typeapplication/json
object
Data

Committed presentation and whether the exact command receipt was replayed.

object
Presentation

Complete Board membership and an opaque optimistic presentation/membership snapshot token.

object
BoardId
string
nullable
Version
string
nullable
Items
Array<object>
nullable

One automatically affiliated Workflow and its display-only settings on its Subject Board.

object
WorkflowDefinitionId
string
nullable
DisplayName
string
nullable
SortOrder
integer format: int32
Visible
boolean
CanOpenDefinition
boolean
ShowInSignalBar
boolean
Replayed
boolean
Errors
Array<object>
nullable
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Warnings
Array<object>
nullable
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Success
boolean
Example
{
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}

Bad Request

Media typeapplication/json
object
type
string
nullable
title
string
nullable
status
integer format: int32
nullable
detail
string
nullable
instance
string
nullable
key
additional properties
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example"
}

Forbidden

Media typeapplication/json
object
type
string
nullable
title
string
nullable
status
integer format: int32
nullable
detail
string
nullable
instance
string
nullable
key
additional properties
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example"
}

Not Found

Media typeapplication/json
object
type
string
nullable
title
string
nullable
status
integer format: int32
nullable
detail
string
nullable
instance
string
nullable
key
additional properties
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example"
}

Conflict

Media typeapplication/json
object
type
string
nullable
title
string
nullable
status
integer format: int32
nullable
detail
string
nullable
instance
string
nullable
key
additional properties
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example"
}