Returns a single Board, for the specified id or GUID passed at part of the query.
TABLE OF CONTENTS
- URL Parameters
- Response
- Response Headers
- Definitions
- ModifiedBy
- Members[]
- Owners[]
- Viewers[]
- CardType[]
- Columns[]
- SubBoards[]
- Further Reading
The REST API user needs to have the correct permissions
HTTP
GET https://organisation.fluid.work/rest/api/board/{id}/
Curl
curl --user username:patToken --location 'http://organisation.fluid.work/rest/api/board/663'
with optional parameters
HTTP
GET https://organisation.fluid.work/rest/api/board/{id}/?fields={fields}&expand={expand}&version=3.0
Curl
curl --user username:patToken --location 'http://organisation.fluid.work/rest/api/board/663?fields=all&expand=all'
URL Parameters
Name | In | Required | Type | Description |
id | path | true | string | The Board Id, can be an integer sting value ### or guid string, both are unique identifiers for this Board and can be used interchangeably. |
fields | query | false | string | Comma-separated list of requested fields |
expand | query | false | string | Expand parameter for Board attributes. Possible options are{"none" "all" "method" "related" "chat" "state"} |
version | query | false | string | Version of the API to use. if not set, default latest version will be used. |
Response
Name | Type | Description |
200 OK | Action | successful operation |
400 | string | Bad Request |
404 | string | "Board Not Found for {id}" |
429 | string | "Too many Requests" see response headers RateLimit-Limit (current rate limit capacity), RateLimit-Remaining (remaining tokens), RateLimit-Reset (time till next refill) |
Response Headers
Name | Type | Description |
RateLimit-Limit | string | Max rate limit of requests allowed |
RateLimit-Remaining | string | Remaining capacity of requests allowed |
RateLimit-Reset | string | Next date time for refresh of capacity |
GET Sample Request
cUrl
curl --user username:pat_token --location 'http://organisation.fluid.work/rest/api/board/630'
Sample Response
Status code: 200
JSON
{ "fields": { "active": true, "boardCategory": 0, "boardType": "Kanban", "cancelledState": "Cancelled", "cardType": [ { "cardType": "Bug", "colourHexValue": "#dc0a34", "isDefault": false }, { "cardType": "Epic", "colourHexValue": "#3f7cac", "isDefault": false }, { "cardType": "Improvement", "colourHexValue": "#ae3778", "isDefault": false }, { "cardType": "New Feature", "colourHexValue": "#f66307", "isDefault": false }, { "cardType": "Production Issue", "colourHexValue": "#121212", "isDefault": false }, { "cardType": "Task", "colourHexValue": "#2d60a5", "isDefault": true }, { "cardType": "User Story", "colourHexValue": "#55917f", "isDefault": false } ], "columns": [ { "id": "f02b2f90-7320-4e66-9e3f-4c342c38c901", "title": "Not Started", "state": "Not Started", "slaDays": 0, "complete": false, "rating": 0.0, "colOwners": [], "colTeam": [], "order": 0, "actions": [], "createProject": false, "defaultProjectStatus": "" }, { "id": "cec38aa4-35c2-4472-8a65-b35d63b8e527", "title": "In Progress", "state": "In Progress", "slaDays": 0, "complete": false, "rating": 0.0, "colOwners": [], "colTeam": [], "order": 0, "actions": [], "createProject": false, "defaultProjectStatus": "" }, { "id": "7b3d98ba-2491-4853-af32-3f74be0a0efb", "title": "Completed", "state": "Completed", "slaDays": 0, "complete": false, "rating": 0.0, "colOwners": [], "colTeam": [], "order": 0, "actions": [], "createProject": false, "defaultProjectStatus": "" } ], "completedState": "Completed", "created": "0001-01-01T00:00:00.0000000", "createdBy": null, "description": null, "epicFieldName": "Theme", "isPrivate": false, "members": [ { "id": 600, "guid": "f8526047-c79f-4924-bcd8-c172ef38c5d8", "name": "Natasha Romanoff", "userName": "natasha.romanoff", "email": "natasha.romanoff@fluidbsg.com" } ], "membersOnly": false, "modifiedBy": null, "modifiedDate": "0001-01-01T00:00:00.0000000", "name": "DevOps", "notStartedState": "Not Started", "owners": [ { "id": 603, "guid": "f1cb6467-0262-4539-9148-7b869defd817", "name": "David Burt", "userName": "david.burt", "email": "dump18@fluidbsg.com" }, { "id": 598, "guid": "1020642e-3e48-49aa-a693-dd8be2b7795c", "name": "Bruce Banner", "userName": "bruce.banner", "email": "bruce.banner@fluidbsg.com" }, { "id": 595, "guid": "b0a1e7e6-2389-4cdc-8d7e-5263eb512e0d", "name": "Adam Jones", "userName": "adam.jones", "email": "dump7@fluidbsg.com" } ], "subBoards": [ { "guid": "b6977faf-bcdd-4a41-8ce1-1e0abe68e55f", "id": 0, "context": { "name": "DevOps", "score": 0.0, "type": "Board", "externalReference": "", "email": null, "shortCode": "D", "isPrivate": false, "isConnection": true, "isCatalog": false, "catalogType": null, "avatarUrl": "/Content/images/logos/Board.svg", "emailOptIn": true, "guid": "a4f06c8d-9e45-4737-a12d-787bf4c12cee", "id": 630, "referenceId": "a4f06c8d-9e45-4737-a12d-787bf4c12cee", "active": true }, "targetGuid": "b6977faf-bcdd-4a41-8ce1-1e0abe68e55f", "title": "DevOps", "startDate": "2022-12-19T09:54:45.0000000", "status": "In Progress", "modified": 0.0, "modifiedBy": { "id": 603, "guid": "f1cb6467-0262-4539-9148-7b869defd817", "name": "David Burt", "userName": "david.burt", "email": "dump18@fluidbsg.com" }, "created": "2022-12-19T09:54:45.0000000", "createdBy": { "id": 603, "guid": "f1cb6467-0262-4539-9148-7b869defd817", "name": "David Burt", "userName": "david.burt", "email": "dump18@fluidbsg.com" }, "comments": 0, "taskCount": 19, "boardType": null, "boardCategory": 0, "velocity": 0.0, "isClosed": false } ], "taskCount": 0, "viewers": [ { "id": 582, "guid": "2b4609b6-299c-41b4-bd5d-1ec991e31247", "name": "Mike Johnson", "userName": "mike.johnson", "email": "dump11@fluidbsg.com" } ] }, "id": 630, "guid": "a4f06c8d-9e45-4737-a12d-787bf4c12cee", "url": "https://organisation.fluid.work/rest/api/board/630" }
Get Sample Request with Expand option
cUrl
curl --user username:pat_token --location 'http://organisation.fluid.work/rest/api/action/630?expand=all'
Sample Response
Status code: 200
JSON
{ "fields": { "active": true, "boardCategory": 0, "boardType": "Kanban", "cancelledState": "Cancelled", "cardType": [ { "cardType": "Bug", "colourHexValue": "#dc0a34", "isDefault": false }, { "cardType": "Epic", "colourHexValue": "#3f7cac", "isDefault": false }, { "cardType": "Improvement", "colourHexValue": "#ae3778", "isDefault": false }, { "cardType": "New Feature", "colourHexValue": "#f66307", "isDefault": false }, { "cardType": "Production Issue", "colourHexValue": "#121212", "isDefault": false }, { "cardType": "Task", "colourHexValue": "#2d60a5", "isDefault": true }, { "cardType": "User Story", "colourHexValue": "#55917f", "isDefault": false } ], "columns": [ { "id": "f02b2f90-7320-4e66-9e3f-4c342c38c901", "title": "Not Started", "state": "Not Started", "slaDays": 0, "complete": false, "rating": 0.0, "colOwners": [], "colTeam": [], "order": 0, "actions": [], "createProject": false, "defaultProjectStatus": "" }, { "id": "cec38aa4-35c2-4472-8a65-b35d63b8e527", "title": "In Progress", "state": "In Progress", "slaDays": 0, "complete": false, "rating": 0.0, "colOwners": [], "colTeam": [], "order": 0, "actions": [], "createProject": false, "defaultProjectStatus": "" }, { "id": "7b3d98ba-2491-4853-af32-3f74be0a0efb", "title": "Completed", "state": "Completed", "slaDays": 0, "complete": false, "rating": 0.0, "colOwners": [], "colTeam": [], "order": 0, "actions": [], "createProject": false, "defaultProjectStatus": "" } ], "completedState": "Completed", "created": "0001-01-01T00:00:00.0000000", "createdBy": null, "description": null, "epicFieldName": "Theme", "isPrivate": false, "members": [ { "id": 600, "guid": "f8526047-c79f-4924-bcd8-c172ef38c5d8", "name": "Natasha Romanoff", "userName": "natasha.romanoff", "email": "natasha.romanoff@fluidbsg.com" } ], "membersOnly": false, "modifiedBy": null, "modifiedDate": "0001-01-01T00:00:00.0000000", "name": "DevOps", "notStartedState": "Not Started", "owners": [ { "id": 603, "guid": "f1cb6467-0262-4539-9148-7b869defd817", "name": "David Burt", "userName": "david.burt", "email": "dump18@fluidbsg.com" }, { "id": 598, "guid": "1020642e-3e48-49aa-a693-dd8be2b7795c", "name": "Bruce Banner", "userName": "bruce.banner", "email": "bruce.banner@fluidbsg.com" }, { "id": 595, "guid": "b0a1e7e6-2389-4cdc-8d7e-5263eb512e0d", "name": "Adam Jones", "userName": "adam.jones", "email": "dump7@fluidbsg.com" } ], "subBoards": [ { "guid": "b6977faf-bcdd-4a41-8ce1-1e0abe68e55f", "id": 0, "context": { "name": "DevOps", "score": 0.0, "type": "Board", "externalReference": "", "email": null, "shortCode": "D", "isPrivate": false, "isConnection": true, "isCatalog": false, "catalogType": null, "avatarUrl": "/Content/images/logos/Board.svg", "emailOptIn": true, "guid": "a4f06c8d-9e45-4737-a12d-787bf4c12cee", "id": 630, "referenceId": "a4f06c8d-9e45-4737-a12d-787bf4c12cee", "active": true }, "targetGuid": "b6977faf-bcdd-4a41-8ce1-1e0abe68e55f", "title": "DevOps", "startDate": "2022-12-19T09:54:45.0000000", "status": "In Progress", "modified": 0.0, "modifiedBy": { "id": 603, "guid": "f1cb6467-0262-4539-9148-7b869defd817", "name": "David Burt", "userName": "david.burt", "email": "dump18@fluidbsg.com" }, "created": "2022-12-19T09:54:45.0000000", "createdBy": { "id": 603, "guid": "f1cb6467-0262-4539-9148-7b869defd817", "name": "David Burt", "userName": "david.burt", "email": "dump18@fluidbsg.com" }, "comments": 0, "taskCount": 19, "boardType": null, "boardCategory": 0, "velocity": 0.0, "isClosed": false } ], "taskCount": 0, "viewers": [ { "id": 582, "guid": "2b4609b6-299c-41b4-bd5d-1ec991e31247", "name": "Mike Johnson", "userName": "mike.johnson", "email": "dump11@fluidbsg.com" } ] }, "id": 630, "methods": [ { "type": "Update", "httpMethod": "PUT", "url": "https://organisation.fluid.work/rest/api/board" }, { "type": "Delete", "httpMethod": "DELETE", "url": "https://organisation.fluid.work/rest/api/board" } ], "chats": [ { "id": 0, "content": "Created and set to Not Started by @DavidBurt", "topicId": 22751, "display": "Created and set to Not Started by <span class=\"atwho-inserted\"><span class=\"mention\"><span class=\"mention-thumb\"><img src=\"https://organisation.fluid.work/Principal/Initials/DB\" class=\"mention-avatar\"></span><span class=\"mention-text\">@DavidBurt</span></span></span>", "initiator": { "id": 0, "guid": "00000000-0000-0000-0000-000000000000", "name": "Dot", "userName": null, "email": "609dd11b-b587-4265-bf50-cee92a86fd42" }, "timestamp": "2024-06-11T14:09:45.0000000" }, { "id": 0, "content": "Successfully Updated Azure DevOps action item- 8153 by @System", "topicId": 22678, "display": "Successfully Updated Azure DevOps action item- <a href=\"https://fluidbusinesssolutions.visualstudio.com/9eb08e50-6927-4e91-a10d-1c0ab6d578d6/_workitems/edit/8153\" target=\"_blank\" rel=\"noopener noreferrer\">8153</a> by <span class=\"atwho-inserted\"><span class=\"mention\"><span class=\"mention-thumb\"><img src=\"https://organisation.fluid.work/Content/public/images/brand/icon.svg?v=1\" class=\"mention-avatar\"></span><span class=\"mention-text\">@System</span></span></span>", "initiator": { "id": 0, "guid": "00000000-0000-0000-0000-000000000000", "name": "Dot", "userName": null, "email": "609dd11b-b587-4265-bf50-cee92a86fd42" }, "timestamp": "2024-06-07T16:13:02.0000000" } ], "guid": "a4f06c8d-9e45-4737-a12d-787bf4c12cee", "url": "https://organisation.fluid.work/rest/api/board/630" }
Definitions
ModifiedBy
Name | Description |
id | The Id integer, uniquely identifies this particular User, can be interchangeable with guid, see below |
guid | The guid string, uniquely identifies this particular User, can be interchangeable with id, see above |
name | The long name of this User |
username | The username associated with this User |
Unique email associated with this User |
Members[]
Name | Description |
id | The Id integer, uniquely identifies this particular User, can be interchangeable with guid, see below |
guid | The guid string, uniquely identifies this particular User, can be interchangeable with id, see above |
name | The long name of this User |
username | The username associated with this User |
Unique email associated with this User |
Owners[]
Name | Description |
id | The Id integer, uniquely identifies this particular User, can be interchangeable with guid, see below |
guid | The guid string, uniquely identifies this particular User, can be interchangeable with id, see above |
name | The long name of this User |
username | The username associated with this User |
Unique email associated with this User |
Viewers[]
Name | Description |
id | The Id integer, uniquely identifies this particular User, can be interchangeable with guid, see below |
guid | The guid string, uniquely identifies this particular User, can be interchangeable with id, see above |
name | The long name of this User |
username | The username associated with this User |
Unique email associated with this User |
CardType[]
Name | Description |
cardType | Name of the task/card type that can be created on this Board |
colourHexValue | Colour associated with this task/card as displayed on the Board and task/card creation dialog |
isDefault | Default task/card selected whn creating, as displayed in the create dialog |
Columns[]
Name | Description |
id | The guid string, uniquely identifies this particular column |
title | The title of this column |
state | state/status of this column, any card in this column will have this state/status applied |
slaDays | |
complete | Is this column a completed state/status column |
rating | integer rating value to apply on this column |
order | left to right positition ordering of this column |
SubBoards[]
Name | Description |
id | The Id integer, uniquely identifies this particular Board, can be interchangeable with guid, see below |
guid | The guid string, uniquely identifies this particular Board, can be interchangeable with id, see above |
title | |
status | The username associated with this User |
modifiedBy | Unique email associated with this User |
createdBy | |
taskCount | |
targetGuid |
Further Reading
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article