Skip to main content

NoteBoard API

Get board list​

GET /canvas/list (Get board list)
Headers​
nametypedata typedescription
AuthorizationrequiredstringBearer token
Query​
nametypedata typedescription
projectIdrequiredstringProject ID
Responses​
http codecontent-typeresponse
200application/json{ err: false, data: Array of Board details }
403application/jsonNo project permission access
Example​
 GET /canvas/list?project=614aa2a260318c20a6fed424

Get one board​

GET /canvas/id (Get one board)
Headers​
nametypedata typedescription
AuthorizationrequiredstringBearer token
Parameters​
nametypedata typedescription
idrequiredstringBoard ID
Responses​
http codecontent-typeresponse
200application/json{ err: false, data: Board details }
403application/jsonNo project permission access
404application/jsonTeam Not found
Example​
 GET /canvas/614aa2a260318c20a6fed424

GET board users​

GET /canvas/id/users (Get board users)
Headers​
nametypedata typedescription
AuthorizationrequiredstringBearer token
Parameters​
nametypedata typedescription
idrequiredstringBoard ID
Body​
nametypedata typedescription
ownerrequiredstringTeam leader User ID
sharedoptionalstringArray of User ID
Responses​
http codecontent-typeresponse
200application/json{ err: false, data: { owner: User, shared: [
{ read: boolean, write: boolean, user: User }
] } }
403application/jsonNo permission access
404application/jsonBoard Not found
Example​
 GET /canvas/unique-id

Update board users​

PUT /canvas/id/users (Update board users)
Headers​
nametypedata typedescription
AuthorizationrequiredstringBearer token
Parameters​
nametypedata typedescription
idrequiredstringBoard ID
Body​
nametypedata typedescription
usersoptionalstringArray of User ID
Responses​
http codecontent-typeresponse
200application/json{ err: false }
403application/jsonNo permission access
404application/jsonBoard Not found
Example​
 PUT /board/unique-id/users
{
users: ['user-id-1','user-id-2']
}

Update board background​

POST /canvas/id/background (Update board background)
Headers​
nametypedata typedescription
AuthorizationrequiredstringBearer token
Parameters​
nametypedata typedescription
idrequiredstringBoard ID
Body​
nametypedata typedescription
filerequirestringFile
projectrequirestringProject ID
Responses​
http codecontent-typeresponse
200application/json{ err: false }
403application/jsonNo permission access
404application/jsonBoard Not found

Remove board background​

POST /canvas/id/clearBackground (Remove board background)
Headers​
nametypedata typedescription
AuthorizationrequiredstringBearer token
Parameters​
nametypedata typedescription
idrequiredstringBoard ID
Responses​
http codecontent-typeresponse
200application/json{ err: false }
403application/jsonNo permission access
404application/jsonBoard Not found

Update board configs​

PUT /canvas/id/config (Update board configs file)
Headers​
nametypedata typedescription
AuthorizationrequiredstringBearer token
Parameters​
nametypedata typedescription
idrequiredstringBoard ID
Body​
nametypedata typedescription
configrequireObjectkey-value paired Object
Responses​
http codecontent-typeresponse
200application/json{ err: false }
403application/jsonNo permission access
404application/jsonBoard Not found
500application/jsonInternal Server Error