Get list of canvas in the workspace.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_id |
string |
Required |
The Unique ID of the workspace
|
Response Schema
{
"type": "object",
"properties": {
"canvas": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "507f191e810c19729de860ea"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"name": {
"type": "string",
"example": "Text"
},
"borderColor": {
"type": "string",
"enum": ["Red", "Yellow", "Green", "Blue"],
"default": "Red"
},
"order": {
"type": "integer",
"default": 0
},
"children": {
"type": "array",
"items": {
"type": "string"
}
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
403 |
ForbiddenError |
404 |
Resource Not Found |
500 |
Internal Server Error |
Create a canvas in the workspace.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_id |
string |
Required |
The Unique ID of the workspace
|
Body
Name |
Type |
Required? |
Default |
Description |
x |
integer |
Optional |
0 |
|
y |
integer |
Optional |
0 |
|
width |
integer |
Optional |
|
|
height |
integer |
Optional |
|
|
name |
string |
Required |
|
|
borderColor |
string |
Optional |
Red |
Allowed values:
- "Red"
- "Yellow"
- "Green"
- "Blue"
|
traits |
array |
Optional |
|
|
Response Schema
{
"type": "object",
"properties": {
"canvas": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "507f191e810c19729de860ea"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"name": {
"type": "string",
"example": "Text"
},
"borderColor": {
"type": "string",
"enum": ["Red", "Yellow", "Green", "Blue"],
"default": "Red"
},
"order": {
"type": "integer",
"default": 0
},
"children": {
"type": "array",
"items": {
"type": "string"
}
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
403 |
ForbiddenError |
404 |
Resource Not Found |
500 |
Internal Server Error |
Get canvas details by Id.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_id |
string |
Required |
The Unique ID of the workspace
|
canvas_id |
string |
Required |
The Unique ID of the canvas
|
Response Schema
{
"type": "object",
"properties": {
"canvas": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "507f191e810c19729de860ea"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"name": {
"type": "string",
"example": "Text"
},
"borderColor": {
"type": "string",
"enum": ["Red", "Yellow", "Green", "Blue"],
"default": "Red"
},
"order": {
"type": "integer",
"default": 0
},
"children": {
"type": "array",
"items": {
"type": "string"
}
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
403 |
ForbiddenError |
404 |
Resource Not Found |
500 |
Internal Server Error |
Update the specified canvas in the workspace.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_id |
string |
Required |
The Unique ID of the workspace
|
canvas_id |
string |
Required |
The Unique ID of the canvas
|
Body
Name |
Type |
Required? |
Default |
Description |
name |
string |
Optional |
|
|
borderColor |
string |
Optional |
Red |
Allowed values:
- "Red"
- "Yellow"
- "Green"
- "Blue"
|
Response Schema
{
"type": "object",
"properties": {
"canvas": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "507f191e810c19729de860ea"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"name": {
"type": "string",
"example": "Text"
},
"borderColor": {
"type": "string",
"enum": ["Red", "Yellow", "Green", "Blue"],
"default": "Red"
},
"order": {
"type": "integer",
"default": 0
},
"children": {
"type": "array",
"items": {
"type": "string"
}
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
403 |
ForbiddenError |
404 |
Resource Not Found |
500 |
Internal Server Error |
Delete the specified canvas from the workspace.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_id |
string |
Required |
The Unique ID of the workspace
|
canvas_id |
string |
Required |
The Unique ID of the canvas
|
Response Schema
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
403 |
ForbiddenError |
404 |
Resource Not Found |
500 |
Internal Server Error |
Get list of the specified type of object in a canvas. If you specify <object_type> as 'images', you will get the list of all the images contained in the specified Canvas.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_id |
string |
Required |
The Unique ID of the workspace
|
canvas_id |
string |
Required |
The Unique ID of the canvas
|
object_type |
string |
Required |
The type of object details which are placed inside the canvas
Allowed values:
- "documents"
- "notes"
- "images"
- "text"
- "canvas"
- "browsers"
- "strokes"
- "videos"
- "grids"
|
Response Schema
{
"type": "object",
"properties": {
"canvas": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "507f191e810c19729de860ea"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"name": {
"type": "string",
"example": "Text"
},
"borderColor": {
"type": "string",
"enum": ["Red", "Yellow", "Green", "Blue"],
"default": "Red"
},
"order": {
"type": "integer",
"default": 0
},
"children": {
"type": "array",
"items": {
"type": "string"
}
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
},
"notes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "507f191e810c19729de860ea"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"width": {
"type": "integer",
"example": 560
},
"height": {
"type": "integer",
"example": 320
},
"text": {
"type": "string",
"example": "Text"
},
"fontWeight": {
"type": "string",
"enum": ["normal", "bold"],
"default": "normal"
},
"fontSize": {
"type": "integer",
"default": 64
},
"textTransform": {
"type": "string",
"enum": ["inherit", "uppercase"],
"default": "inherit"
},
"backgroundColor": {
"type": "string",
"enum": ["Beige", "Blue", "Gold", "Grey", "Red", "Teal", "Yellow"],
"default": "Teal"
},
"pin": {
"type": "boolean",
"default": false
},
"scale": {
"type": "number",
"default": 1,
"minimum": 0.5,
"maximum": 1000
},
"order": {
"type": "integer",
"default": 0
},
"strokeIds": {
"type": "array",
"items": {
"type": "string"
}
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
},
"browsers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"height": {
"type": "integer"
},
"width": {
"type": "integer"
},
"contentWidth": {
"type": "integer"
},
"contentHeight": {
"type": "integer"
},
"url": {
"type": "string"
},
"order": {
"type": "integer",
"default": 0
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
},
"images": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"url": {
"type": "string"
},
"pin": {
"type": "boolean",
"default": false
},
"scale": {
"type": "number",
"default": 1,
"minimum": 0.5,
"maximum": 1000
},
"order": {
"type": "integer",
"default": 0
},
"strokeIds": {
"type": "array",
"items": {
"type": "string"
}
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
},
"documents": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"type": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
},
"pin": {
"type": "boolean",
"default": false
},
"scale": {
"type": "number",
"default": 1,
"minimum": 0.5,
"maximum": 1000
},
"order": {
"type": "integer",
"default": 0
},
"strokeIds": {
"type": "array",
"items": {
"type": "string"
}
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
},
"text": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"text": {
"type": "string",
"minLength": 1,
"maxLength": 3000
},
"fontFamily": {
"type": "string",
"enum": ["Dosis", "Helvetica", "Times New Roman", "Source Code Pro", "Aleo", "Exo 2"],
"default": "Dosis"
},
"fontSize": {
"type": "integer",
"default": 64
},
"fontColor": {
"type": "string",
"default": "#ffffff"
},
"fontWeight": {
"type": "string",
"enum": ["normal", "bold"],
"default": "normal"
},
"fontStyle": {
"type": "string",
"enum": ["normal", "italic"],
"default": "normal"
},
"textTransform": {
"type": "string",
"enum": ["inherit", "uppercase"],
"default": "inherit"
},
"backgroundColor": {
"type": "string",
"default": "#ea3e35"
},
"pin": {
"type": "boolean",
"default": false
},
"order": {
"type": "integer",
"default": 0
},
"surface": {
"type": "string",
"default": null
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
},
"strokes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"workspace_id": {
"type": "string"
},
"penColor": {
"type": "string",
"enum": ["White", "Gray", "Yellow", "Red", "Green", "Purple", "Cyan"],
"default": "White"
},
"size": {
"type": "integer",
"minimum": 1,
"maximum": 100
},
"brushType": {
"type": "string",
"enum": ["Pen", "Eraser"],
"default": "Pen"
},
"points": {
"type": "array",
"items": {
"type": "integer"
}
},
"targetId": {
"type": "string"
},
"order": {
"type": "integer",
"default": 0
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
},
"videos": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "507f191e810c19729de860ea"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"title": {
"type": "string",
"example": "Text"
},
"order": {
"type": "integer",
"default": 0
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
}
}
}
},
"grids": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "507f191e810c19729de860ea"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"pin": {
"type": "boolean",
"default": false
},
"horizontalMargin": {
"type": "integer"
},
"verticalMargin": {
"type": "integer"
},
"cellWidth": {
"type": "integer"
},
"cellHeight": {
"type": "integer"
},
"rows": {
"type": "integer"
},
"columns": {
"type": "integer"
},
"order": {
"type": "integer",
"default": 0
},
"elements": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"row": {
"type": "integer"
},
"column": {
"type": "integer"
}
}
}
}
}
}
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
403 |
ForbiddenError |
404 |
Resource Not Found |
500 |
Internal Server Error |
Add a browser to the canvas.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_id |
string |
Required |
The Unique ID of the workspace
|
canvas_id |
string |
Required |
The Unique ID of the canvas
|
Body
Name |
Type |
Required? |
Default |
Description |
x |
integer |
Optional |
0 |
|
y |
integer |
Optional |
0 |
|
width |
integer |
Optional |
|
|
height |
integer |
Optional |
|
|
contentWidth |
integer |
Optional |
|
|
contentHeight |
integer |
Optional |
|
|
url |
string |
Required |
|
|
frameless |
boolean |
Optional |
|
|
traits |
array |
Optional |
|
|
Response Schema
{
"type": "object",
"properties": {
"browser": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"height": {
"type": "integer"
},
"width": {
"type": "integer"
},
"contentWidth": {
"type": "integer"
},
"contentHeight": {
"type": "integer"
},
"url": {
"type": "string"
},
"order": {
"type": "integer",
"default": 0
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
403 |
ForbiddenError |
404 |
Resource Not Found |
500 |
Internal Server Error |
Add a canvas to the canvas.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_id |
string |
Required |
The Unique ID of the workspace
|
canvas_id |
string |
Required |
The Unique ID of the canvas
|
Body
Name |
Type |
Required? |
Default |
Description |
x |
integer |
Optional |
0 |
|
y |
integer |
Optional |
0 |
|
width |
integer |
Optional |
|
|
height |
integer |
Optional |
|
|
name |
string |
Required |
|
|
borderColor |
string |
Optional |
Red |
Allowed values:
- "Red"
- "Yellow"
- "Green"
- "Blue"
|
traits |
array |
Optional |
|
|
Response Schema
{
"type": "object",
"properties": {
"canvas": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "507f191e810c19729de860ea"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"name": {
"type": "string",
"example": "Text"
},
"borderColor": {
"type": "string",
"enum": ["Red", "Yellow", "Green", "Blue"],
"default": "Red"
},
"order": {
"type": "integer",
"default": 0
},
"children": {
"type": "array",
"items": {
"type": "string"
}
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
403 |
ForbiddenError |
404 |
Resource Not Found |
500 |
Internal Server Error |
Get a list of elements in the canvas. The Response Body returns a list of all the elements in the Canvas, grouped by their object type: 'notes, 'browsers', 'images', 'documents', 'text', 'strokes', 'videos' and 'grids'.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_id |
string |
Required |
The Unique ID of the workspace
|
canvas_id |
string |
Required |
The Unique ID of the canvas
|
Query
Name |
Type |
Required? |
Description |
element_type |
string |
Optional |
Get elements types like notes, text, canvas, documents, images, browsers, strokes in canvas
|
Response Schema
{
"type": "object",
"properties": {
"canvas": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "507f191e810c19729de860ea"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"name": {
"type": "string",
"example": "Text"
},
"borderColor": {
"type": "string",
"enum": ["Red", "Yellow", "Green", "Blue"],
"default": "Red"
},
"order": {
"type": "integer",
"default": 0
},
"children": {
"type": "array",
"items": {
"type": "string"
}
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
},
"notes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "507f191e810c19729de860ea"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"width": {
"type": "integer",
"example": 560
},
"height": {
"type": "integer",
"example": 320
},
"text": {
"type": "string",
"example": "Text"
},
"fontWeight": {
"type": "string",
"enum": ["normal", "bold"],
"default": "normal"
},
"fontSize": {
"type": "integer",
"default": 64
},
"textTransform": {
"type": "string",
"enum": ["inherit", "uppercase"],
"default": "inherit"
},
"backgroundColor": {
"type": "string",
"enum": ["Beige", "Blue", "Gold", "Grey", "Red", "Teal", "Yellow"],
"default": "Teal"
},
"pin": {
"type": "boolean",
"default": false
},
"scale": {
"type": "number",
"default": 1,
"minimum": 0.5,
"maximum": 1000
},
"order": {
"type": "integer",
"default": 0
},
"strokeIds": {
"type": "array",
"items": {
"type": "string"
}
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
},
"browsers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"height": {
"type": "integer"
},
"width": {
"type": "integer"
},
"contentWidth": {
"type": "integer"
},
"contentHeight": {
"type": "integer"
},
"url": {
"type": "string"
},
"order": {
"type": "integer",
"default": 0
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
},
"images": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"url": {
"type": "string"
},
"pin": {
"type": "boolean",
"default": false
},
"scale": {
"type": "number",
"default": 1,
"minimum": 0.5,
"maximum": 1000
},
"order": {
"type": "integer",
"default": 0
},
"strokeIds": {
"type": "array",
"items": {
"type": "string"
}
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
},
"documents": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"type": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
},
"pin": {
"type": "boolean",
"default": false
},
"scale": {
"type": "number",
"default": 1,
"minimum": 0.5,
"maximum": 1000
},
"order": {
"type": "integer",
"default": 0
},
"strokeIds": {
"type": "array",
"items": {
"type": "string"
}
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
},
"text": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"text": {
"type": "string",
"minLength": 1,
"maxLength": 3000
},
"fontFamily": {
"type": "string",
"enum": ["Dosis", "Helvetica", "Times New Roman", "Source Code Pro", "Aleo", "Exo 2"],
"default": "Dosis"
},
"fontSize": {
"type": "integer",
"default": 64
},
"fontColor": {
"type": "string",
"default": "#ffffff"
},
"fontWeight": {
"type": "string",
"enum": ["normal", "bold"],
"default": "normal"
},
"fontStyle": {
"type": "string",
"enum": ["normal", "italic"],
"default": "normal"
},
"textTransform": {
"type": "string",
"enum": ["inherit", "uppercase"],
"default": "inherit"
},
"backgroundColor": {
"type": "string",
"default": "#ea3e35"
},
"pin": {
"type": "boolean",
"default": false
},
"order": {
"type": "integer",
"default": 0
},
"surface": {
"type": "string",
"default": null
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
},
"strokes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"workspace_id": {
"type": "string"
},
"penColor": {
"type": "string",
"enum": ["White", "Gray", "Yellow", "Red", "Green", "Purple", "Cyan"],
"default": "White"
},
"size": {
"type": "integer",
"minimum": 1,
"maximum": 100
},
"brushType": {
"type": "string",
"enum": ["Pen", "Eraser"],
"default": "Pen"
},
"points": {
"type": "array",
"items": {
"type": "integer"
}
},
"targetId": {
"type": "string"
},
"order": {
"type": "integer",
"default": 0
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
},
"videos": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "507f191e810c19729de860ea"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"title": {
"type": "string",
"example": "Text"
},
"order": {
"type": "integer",
"default": 0
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
}
}
}
},
"grids": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "507f191e810c19729de860ea"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"pin": {
"type": "boolean",
"default": false
},
"horizontalMargin": {
"type": "integer"
},
"verticalMargin": {
"type": "integer"
},
"cellWidth": {
"type": "integer"
},
"cellHeight": {
"type": "integer"
},
"rows": {
"type": "integer"
},
"columns": {
"type": "integer"
},
"order": {
"type": "integer",
"default": 0
},
"elements": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"row": {
"type": "integer"
},
"column": {
"type": "integer"
}
}
}
}
}
}
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
403 |
ForbiddenError |
404 |
Resource Not Found |
500 |
Internal Server Error |
Create a document in the Canvas.
The supported file extensions are: pdf, docx, pptx, xlsx, doc, ppt, xls.
See examples of its use in the Guides section
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_id |
string |
Required |
The Unique ID of the workspace
|
canvas_id |
string |
Required |
The Unique ID of the canvas
|
Form Data
Name |
Type |
Required? |
Default |
Description |
x |
integer |
Optional |
0 |
Position - X
|
y |
integer |
Optional |
0 |
Position - Y
|
title |
string |
Required |
|
Title of document
|
pin |
boolean |
Optional |
false |
Whether or not to pin the item
|
scale |
number |
Optional |
1 |
Document Size
|
document |
string |
Required |
|
The Document to upload.
|
Response Schema
{
"type": "object",
"properties": {
"document": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"type": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
},
"pin": {
"type": "boolean",
"default": false
},
"scale": {
"type": "number",
"default": 1,
"minimum": 0.5,
"maximum": 1000
},
"order": {
"type": "integer",
"default": 0
},
"strokeIds": {
"type": "array",
"items": {
"type": "string"
}
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
403 |
ForbiddenError |
404 |
Resource Not Found |
500 |
Internal Server Error |
Get list of documents in the workspace.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_id |
string |
Required |
The Unique ID of the workspace
|
Response Schema
{
"type": "object",
"properties": {
"documents": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"type": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
},
"pin": {
"type": "boolean",
"default": false
},
"scale": {
"type": "number",
"default": 1,
"minimum": 0.5,
"maximum": 1000
},
"order": {
"type": "integer",
"default": 0
},
"strokeIds": {
"type": "array",
"items": {
"type": "string"
}
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
403 |
ForbiddenError |
404 |
Resource Not Found |
500 |
Internal Server Error |
Create a document in the workspace.
The supported file extensions are: pdf, docx, pptx, xlsx, doc, ppt, xls.
See examples of its use in the Guides section
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_id |
string |
Required |
The Unique ID of the workspace
|
Form Data
Name |
Type |
Required? |
Default |
Description |
x |
integer |
Optional |
0 |
Position - X
|
y |
integer |
Optional |
0 |
Position - Y
|
title |
string |
Required |
|
Title of document
|
pin |
boolean |
Optional |
false |
Whether or not to pin the item
|
scale |
number |
Optional |
1 |
Document Size
|
document |
string |
Required |
|
The Document to upload.
|
Response Schema
{
"type": "object",
"properties": {
"document": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"type": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
},
"pin": {
"type": "boolean",
"default": false
},
"scale": {
"type": "number",
"default": 1,
"minimum": 0.5,
"maximum": 1000
},
"order": {
"type": "integer",
"default": 0
},
"strokeIds": {
"type": "array",
"items": {
"type": "string"
}
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
403 |
ForbiddenError |
404 |
Resource Not Found |
500 |
Internal Server Error |
Get document details by Id.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_id |
string |
Required |
The Unique ID of the workspace
|
document_id |
string |
Required |
The Unique ID of the document
|
Response Schema
{
"type": "object",
"properties": {
"document": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"type": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
},
"pin": {
"type": "boolean",
"default": false
},
"scale": {
"type": "number",
"default": 1,
"minimum": 0.5,
"maximum": 1000
},
"order": {
"type": "integer",
"default": 0
},
"strokeIds": {
"type": "array",
"items": {
"type": "string"
}
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
403 |
ForbiddenError |
404 |
Resource Not Found |
500 |
Internal Server Error |
Update the specified document in the workspace.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_id |
string |
Required |
The Unique ID of the workspace
|
document_id |
string |
Required |
The Unique ID of the document
|
Body
Name |
Type |
Required? |
Default |
Description |
x |
integer |
Optional |
0 |
|
y |
integer |
Optional |
0 |
|
pin |
boolean |
Optional |
false |
|
scale |
number |
Optional |
1 |
Minimum: 0.5
Maximum: 1000
|
Response Schema
{
"type": "object",
"properties": {
"document": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"type": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
},
"pin": {
"type": "boolean",
"default": false
},
"scale": {
"type": "number",
"default": 1,
"minimum": 0.5,
"maximum": 1000
},
"order": {
"type": "integer",
"default": 0
},
"strokeIds": {
"type": "array",
"items": {
"type": "string"
}
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
403 |
ForbiddenError |
404 |
Resource Not Found |
500 |
Internal Server Error |
Delete the specified document from the workspace.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_id |
string |
Required |
The Unique ID of the workspace
|
document_id |
string |
Required |
The Unique ID of the document
|
Response Schema
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
403 |
ForbiddenError |
404 |
Resource Not Found |
500 |
Internal Server Error |
Get list of elements in the workspace
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_id |
string |
Required |
The Unique ID of the workspace
|
Response Schema
{
"type": "object",
"properties": {
"notes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "507f191e810c19729de860ea"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"width": {
"type": "integer",
"example": 560
},
"height": {
"type": "integer",
"example": 320
},
"text": {
"type": "string",
"example": "Text"
},
"fontWeight": {
"type": "string",
"enum": ["normal", "bold"],
"default": "normal"
},
"fontSize": {
"type": "integer",
"default": 64
},
"textTransform": {
"type": "string",
"enum": ["inherit", "uppercase"],
"default": "inherit"
},
"backgroundColor": {
"type": "string",
"enum": ["Beige", "Blue", "Gold", "Grey", "Red", "Teal", "Yellow"],
"default": "Teal"
},
"pin": {
"type": "boolean",
"default": false
},
"scale": {
"type": "number",
"default": 1,
"minimum": 0.5,
"maximum": 1000
},
"order": {
"type": "integer",
"default": 0
},
"strokeIds": {
"type": "array",
"items": {
"type": "string"
}
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
},
"text": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"text": {
"type": "string",
"minLength": 1,
"maxLength": 3000
},
"fontFamily": {
"type": "string",
"enum": ["Dosis", "Helvetica", "Times New Roman", "Source Code Pro", "Aleo", "Exo 2"],
"default": "Dosis"
},
"fontSize": {
"type": "integer",
"default": 64
},
"fontColor": {
"type": "string",
"default": "#ffffff"
},
"fontWeight": {
"type": "string",
"enum": ["normal", "bold"],
"default": "normal"
},
"fontStyle": {
"type": "string",
"enum": ["normal", "italic"],
"default": "normal"
},
"textTransform": {
"type": "string",
"enum": ["inherit", "uppercase"],
"default": "inherit"
},
"backgroundColor": {
"type": "string",
"default": "#ea3e35"
},
"pin": {
"type": "boolean",
"default": false
},
"order": {
"type": "integer",
"default": 0
},
"surface": {
"type": "string",
"default": null
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
},
"documents": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"type": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
},
"pin": {
"type": "boolean",
"default": false
},
"scale": {
"type": "number",
"default": 1,
"minimum": 0.5,
"maximum": 1000
},
"order": {
"type": "integer",
"default": 0
},
"strokeIds": {
"type": "array",
"items": {
"type": "string"
}
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
},
"canvas": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "507f191e810c19729de860ea"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"name": {
"type": "string",
"example": "Text"
},
"borderColor": {
"type": "string",
"enum": ["Red", "Yellow", "Green", "Blue"],
"default": "Red"
},
"order": {
"type": "integer",
"default": 0
},
"children": {
"type": "array",
"items": {
"type": "string"
}
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
},
"images": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"url": {
"type": "string"
},
"pin": {
"type": "boolean",
"default": false
},
"scale": {
"type": "number",
"default": 1,
"minimum": 0.5,
"maximum": 1000
},
"order": {
"type": "integer",
"default": 0
},
"strokeIds": {
"type": "array",
"items": {
"type": "string"
}
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
},
"videos": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "507f191e810c19729de860ea"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"title": {
"type": "string",
"example": "Text"
},
"order": {
"type": "integer",
"default": 0
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
}
}
}
},
"grids": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "507f191e810c19729de860ea"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"pin": {
"type": "boolean",
"default": false
},
"horizontalMargin": {
"type": "integer"
},
"verticalMargin": {
"type": "integer"
},
"cellWidth": {
"type": "integer"
},
"cellHeight": {
"type": "integer"
},
"rows": {
"type": "integer"
},
"columns": {
"type": "integer"
},
"order": {
"type": "integer",
"default": 0
},
"elements": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"row": {
"type": "integer"
},
"column": {
"type": "integer"
}
}
}
}
}
}
},
"browsers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"height": {
"type": "integer"
},
"width": {
"type": "integer"
},
"contentWidth": {
"type": "integer"
},
"contentHeight": {
"type": "integer"
},
"url": {
"type": "string"
},
"order": {
"type": "integer",
"default": 0
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
},
"strokes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"workspace_id": {
"type": "string"
},
"penColor": {
"type": "string",
"enum": ["White", "Gray", "Yellow", "Red", "Green", "Purple", "Cyan"],
"default": "White"
},
"size": {
"type": "integer",
"minimum": 1,
"maximum": 100
},
"brushType": {
"type": "string",
"enum": ["Pen", "Eraser"],
"default": "Pen"
},
"points": {
"type": "array",
"items": {
"type": "integer"
}
},
"targetId": {
"type": "string"
},
"order": {
"type": "integer",
"default": 0
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
403 |
ForbiddenError |
404 |
Resource Not Found |
500 |
Internal Server Error |
Create an image in the canvas. The image may be uploaded as a binary attachment, multipart form data, or via a remote url.
The supported file extensions are: jpg, png, jpeg, tiff.
See examples of its use in the Guides section.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_id |
string |
Required |
The Unique ID of the workspace
|
canvas_id |
string |
Required |
The Unique ID of the canvas
|
Form Data
Name |
Type |
Required? |
Default |
Description |
x |
integer |
Optional |
0 |
Position - X
|
y |
integer |
Optional |
0 |
Position - Y
|
url |
string |
Optional |
|
|
image |
string |
Required |
|
The Image to upload.
|
pin |
boolean |
Optional |
false |
Whether or not to pin the item
|
scale |
number |
Optional |
1 |
Image Size
|
Response Schema
{
"type": "object",
"properties": {
"image": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"url": {
"type": "string"
},
"pin": {
"type": "boolean",
"default": false
},
"scale": {
"type": "number",
"default": 1,
"minimum": 0.5,
"maximum": 1000
},
"order": {
"type": "integer",
"default": 0
},
"strokeIds": {
"type": "array",
"items": {
"type": "string"
}
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
403 |
ForbiddenError |
404 |
Resource Not Found |
500 |
Internal Server Error |
Get list of images in the workspace.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_id |
string |
Required |
The Unique ID of the workspace
|
Response Schema
{
"type": "object",
"properties": {
"images": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"url": {
"type": "string"
},
"pin": {
"type": "boolean",
"default": false
},
"scale": {
"type": "number",
"default": 1,
"minimum": 0.5,
"maximum": 1000
},
"order": {
"type": "integer",
"default": 0
},
"strokeIds": {
"type": "array",
"items": {
"type": "string"
}
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
403 |
ForbiddenError |
404 |
Resource Not Found |
500 |
Internal Server Error |
Create an image in the Workspace. The image may be uploaded as a binary attachment, multipart form data, or via a remote url.
The supported file extensions are: jpg, png, jpeg, tiff.
See examples of its use in the Guides section.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_id |
string |
Required |
The Unique ID of the workspace
|
Form Data
Name |
Type |
Required? |
Default |
Description |
x |
integer |
Optional |
0 |
Position - X
|
y |
integer |
Optional |
0 |
Position - Y
|
url |
string |
Optional |
|
|
image |
string |
Required |
|
The Image to upload.
|
pin |
boolean |
Optional |
false |
Whether or not to pin the item
|
scale |
number |
Optional |
1 |
Image Size
|
Response Schema
{
"type": "object",
"properties": {
"image": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"url": {
"type": "string"
},
"pin": {
"type": "boolean",
"default": false
},
"scale": {
"type": "number",
"default": 1,
"minimum": 0.5,
"maximum": 1000
},
"order": {
"type": "integer",
"default": 0
},
"strokeIds": {
"type": "array",
"items": {
"type": "string"
}
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
403 |
ForbiddenError |
404 |
Resource Not Found |
500 |
Internal Server Error |
Get image details by Id.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_id |
string |
Required |
The Unique ID of the workspace
|
image_id |
string |
Required |
The Unique ID of the image
|
Response Schema
{
"type": "object",
"properties": {
"image": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"url": {
"type": "string"
},
"pin": {
"type": "boolean",
"default": false
},
"scale": {
"type": "number",
"default": 1,
"minimum": 0.5,
"maximum": 1000
},
"order": {
"type": "integer",
"default": 0
},
"strokeIds": {
"type": "array",
"items": {
"type": "string"
}
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
403 |
ForbiddenError |
404 |
Resource Not Found |
500 |
Internal Server Error |
Update the specified image in the workspace.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_id |
string |
Required |
The Unique ID of the workspace
|
image_id |
string |
Required |
The Unique ID of the image
|
Body
Name |
Type |
Required? |
Default |
Description |
x |
integer |
Optional |
0 |
|
y |
integer |
Optional |
0 |
|
pin |
boolean |
Optional |
false |
|
scale |
number |
Optional |
1 |
Minimum: 0.5
Maximum: 1000
|
Response Schema
{
"type": "object",
"properties": {
"image": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"url": {
"type": "string"
},
"pin": {
"type": "boolean",
"default": false
},
"scale": {
"type": "number",
"default": 1,
"minimum": 0.5,
"maximum": 1000
},
"order": {
"type": "integer",
"default": 0
},
"strokeIds": {
"type": "array",
"items": {
"type": "string"
}
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
403 |
ForbiddenError |
404 |
Resource Not Found |
500 |
Internal Server Error |
Delete the specified image from the workspace.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_id |
string |
Required |
The Unique ID of the workspace
|
image_id |
string |
Required |
The Unique ID of the image
|
Response Schema
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
403 |
ForbiddenError |
404 |
Resource Not Found |
500 |
Internal Server Error |
Add a note to the canvas.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_id |
string |
Required |
The Unique ID of the workspace
|
canvas_id |
string |
Required |
The Unique ID of the canvas
|
Body
Name |
Type |
Required? |
Default |
Description |
x |
integer |
Optional |
0 |
|
y |
integer |
Optional |
0 |
|
text |
string |
Required |
|
|
fontWeight |
string |
Optional |
normal |
Allowed values:
- "normal"
- "bold"
|
textTransform |
string |
Optional |
inherit |
Allowed values:
- "inherit"
- "uppercase"
|
backgroundColor |
string |
Optional |
Teal |
Allowed values:
- "Beige"
- "Blue"
- "Gold"
- "Grey"
- "Red"
- "Teal"
- "Yellow"
|
pin |
boolean |
Optional |
false |
|
scale |
number |
Optional |
1 |
Minimum: 0.5
Maximum: 1000
|
traits |
array |
Optional |
|
|
Response Schema
{
"type": "object",
"properties": {
"note": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "507f191e810c19729de860ea"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"width": {
"type": "integer",
"example": 560
},
"height": {
"type": "integer",
"example": 320
},
"text": {
"type": "string",
"example": "Text"
},
"fontWeight": {
"type": "string",
"enum": ["normal", "bold"],
"default": "normal"
},
"fontSize": {
"type": "integer",
"default": 64
},
"textTransform": {
"type": "string",
"enum": ["inherit", "uppercase"],
"default": "inherit"
},
"backgroundColor": {
"type": "string",
"enum": ["Beige", "Blue", "Gold", "Grey", "Red", "Teal", "Yellow"],
"default": "Teal"
},
"pin": {
"type": "boolean",
"default": false
},
"scale": {
"type": "number",
"default": 1,
"minimum": 0.5,
"maximum": 1000
},
"order": {
"type": "integer",
"default": 0
},
"strokeIds": {
"type": "array",
"items": {
"type": "string"
}
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
403 |
ForbiddenError |
404 |
Resource Not Found |
500 |
Internal Server Error |
Get list of notes in the workspace.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_id |
string |
Required |
The Unique ID of the workspace
|
Response Schema
{
"type": "object",
"properties": {
"notes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "507f191e810c19729de860ea"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"width": {
"type": "integer",
"example": 560
},
"height": {
"type": "integer",
"example": 320
},
"text": {
"type": "string",
"example": "Text"
},
"fontWeight": {
"type": "string",
"enum": ["normal", "bold"],
"default": "normal"
},
"fontSize": {
"type": "integer",
"default": 64
},
"textTransform": {
"type": "string",
"enum": ["inherit", "uppercase"],
"default": "inherit"
},
"backgroundColor": {
"type": "string",
"enum": ["Beige", "Blue", "Gold", "Grey", "Red", "Teal", "Yellow"],
"default": "Teal"
},
"pin": {
"type": "boolean",
"default": false
},
"scale": {
"type": "number",
"default": 1,
"minimum": 0.5,
"maximum": 1000
},
"order": {
"type": "integer",
"default": 0
},
"strokeIds": {
"type": "array",
"items": {
"type": "string"
}
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
403 |
ForbiddenError |
404 |
Resource Not Found |
500 |
Internal Server Error |
Create a note in the workspace.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_id |
string |
Required |
The Unique ID of the workspace
|
Body
Name |
Type |
Required? |
Default |
Description |
x |
integer |
Optional |
0 |
|
y |
integer |
Optional |
0 |
|
text |
string |
Required |
|
|
fontWeight |
string |
Optional |
normal |
Allowed values:
- "normal"
- "bold"
|
textTransform |
string |
Optional |
inherit |
Allowed values:
- "inherit"
- "uppercase"
|
backgroundColor |
string |
Optional |
Teal |
Allowed values:
- "Beige"
- "Blue"
- "Gold"
- "Grey"
- "Red"
- "Teal"
- "Yellow"
|
pin |
boolean |
Optional |
false |
|
scale |
number |
Optional |
1 |
Minimum: 0.5
Maximum: 1000
|
traits |
array |
Optional |
|
|
Response Schema
{
"type": "object",
"properties": {
"note": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "507f191e810c19729de860ea"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"width": {
"type": "integer",
"example": 560
},
"height": {
"type": "integer",
"example": 320
},
"text": {
"type": "string",
"example": "Text"
},
"fontWeight": {
"type": "string",
"enum": ["normal", "bold"],
"default": "normal"
},
"fontSize": {
"type": "integer",
"default": 64
},
"textTransform": {
"type": "string",
"enum": ["inherit", "uppercase"],
"default": "inherit"
},
"backgroundColor": {
"type": "string",
"enum": ["Beige", "Blue", "Gold", "Grey", "Red", "Teal", "Yellow"],
"default": "Teal"
},
"pin": {
"type": "boolean",
"default": false
},
"scale": {
"type": "number",
"default": 1,
"minimum": 0.5,
"maximum": 1000
},
"order": {
"type": "integer",
"default": 0
},
"strokeIds": {
"type": "array",
"items": {
"type": "string"
}
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
403 |
ForbiddenError |
404 |
Resource Not Found |
500 |
Internal Server Error |
Get note details by Id.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_id |
string |
Required |
The Unique ID of the workspace
|
note_id |
string |
Required |
The Unique ID of the notecard
|
Response Schema
{
"type": "object",
"properties": {
"note": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "507f191e810c19729de860ea"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"width": {
"type": "integer",
"example": 560
},
"height": {
"type": "integer",
"example": 320
},
"text": {
"type": "string",
"example": "Text"
},
"fontWeight": {
"type": "string",
"enum": ["normal", "bold"],
"default": "normal"
},
"fontSize": {
"type": "integer",
"default": 64
},
"textTransform": {
"type": "string",
"enum": ["inherit", "uppercase"],
"default": "inherit"
},
"backgroundColor": {
"type": "string",
"enum": ["Beige", "Blue", "Gold", "Grey", "Red", "Teal", "Yellow"],
"default": "Teal"
},
"pin": {
"type": "boolean",
"default": false
},
"scale": {
"type": "number",
"default": 1,
"minimum": 0.5,
"maximum": 1000
},
"order": {
"type": "integer",
"default": 0
},
"strokeIds": {
"type": "array",
"items": {
"type": "string"
}
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
403 |
ForbiddenError |
404 |
Resource Not Found |
500 |
Internal Server Error |
Update the specified note in the workspace.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_id |
string |
Required |
The Unique ID of the workspace
|
note_id |
string |
Required |
The Unique ID of the notecard
|
Body
Name |
Type |
Required? |
Default |
Description |
x |
integer |
Optional |
0 |
|
y |
integer |
Optional |
0 |
|
text |
string |
Optional |
|
|
fontWeight |
string |
Optional |
normal |
Allowed values:
- "normal"
- "bold"
|
textTransform |
string |
Optional |
inherit |
Allowed values:
- "inherit"
- "uppercase"
|
backgroundColor |
string |
Optional |
Teal |
Allowed values:
- "Beige"
- "Blue"
- "Gold"
- "Grey"
- "Red"
- "Teal"
- "Yellow"
|
pin |
boolean |
Optional |
false |
|
scale |
number |
Optional |
1 |
Minimum: 0.5
Maximum: 1000
|
Response Schema
{
"type": "object",
"properties": {
"note": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "507f191e810c19729de860ea"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"width": {
"type": "integer",
"example": 560
},
"height": {
"type": "integer",
"example": 320
},
"text": {
"type": "string",
"example": "Text"
},
"fontWeight": {
"type": "string",
"enum": ["normal", "bold"],
"default": "normal"
},
"fontSize": {
"type": "integer",
"default": 64
},
"textTransform": {
"type": "string",
"enum": ["inherit", "uppercase"],
"default": "inherit"
},
"backgroundColor": {
"type": "string",
"enum": ["Beige", "Blue", "Gold", "Grey", "Red", "Teal", "Yellow"],
"default": "Teal"
},
"pin": {
"type": "boolean",
"default": false
},
"scale": {
"type": "number",
"default": 1,
"minimum": 0.5,
"maximum": 1000
},
"order": {
"type": "integer",
"default": 0
},
"strokeIds": {
"type": "array",
"items": {
"type": "string"
}
},
"adhesions": {
"type": "array",
"items": {
"type": "string"
}
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
403 |
ForbiddenError |
404 |
Resource Not Found |
500 |
Internal Server Error |
Delete the specified note from the workspace.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_id |
string |
Required |
The Unique ID of the workspace
|
note_id |
string |
Required |
The Unique ID of the note
|
Response Schema
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
403 |
ForbiddenError |
404 |
Resource Not Found |
500 |
Internal Server Error |
Get an organization by organization uid. If the user is NOT in the organization, require Manage Application Organizations permission group.
Details
Headers
Path
Name |
Type |
Required? |
Description |
organization_uid |
string |
Required |
Organization uid
|
Response Schema
{
"type": "object",
"properties": {
"organization": {
"type": "object",
"properties": {
"uid": {
"type": "string"
},
"name": {
"type": "string"
},
"locked_at": {
"type": "string",
"format": "date-time"
},
"account_uid": {
"type": "string"
},
"created_at": {
"type": "string",
"format": "date-time"
},
"updated_at": {
"type": "string",
"format": "date-time"
},
"expiration": {
"type": "string",
"format": "date-time"
},
"plan": {
"type": "object",
"properties": {
"uid": {
"type": "string"
},
"name": {
"type": "string"
}
}
},
"owner": {
"type": "object",
"properties": {
"uid": {
"type": "string"
},
"email": {
"type": "string"
},
"first_name": {
"type": "string"
},
"last_name": {
"type": "string"
},
"locked_at": {
"type": "string",
"format": "date-time"
},
"account_uid": {
"type": "string"
},
"created_at": {
"type": "string",
"format": "date-time"
},
"updated_at": {
"type": "string",
"format": "date-time"
}
}
},
"metadata": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"value": {
"type": "string"
}
},
"required": ["key", "value"]
}
},
"is_guest_invite_requires_approval": {
"type": "boolean",
"default": false
},
"default_public_workspace_role_uid": {
"type": "string"
},
"default_organization_user_role_uid": {
"type": "string"
},
"is_custom_role_enabled": {
"type": "boolean",
"default": false
},
"saml_provider": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"metadata_url": {
"type": "string"
},
"admin_email": {
"type": "string"
},
"type": {
"type": "string",
"enum": ["okta", "onelogin", "pingfederate", "adfs", "f5"]
}
}
},
"is_cam_enabled": {
"type": "boolean",
"default": false
},
"denyOnNoCamData": {
"type": "boolean",
"default": true
},
"pending_hard_delete": {
"type": "string",
"format": "date-time",
"default": null
},
"org_can_have_guests": {
"type": "boolean",
"default": true
}
}
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
404 |
Resource Not Found |
500 |
Internal Server Error |
Get organization roles within an organization. Require List Roles permission group.
Details
Headers
Path
Name |
Type |
Required? |
Description |
organization_uid |
string |
Required |
Organization uid
|
Query
Name |
Type |
Required? |
Description |
query |
string |
Optional |
Search query
|
order_by |
string |
Optional |
Order by fields
|
order_direction |
string |
Optional |
ASC or DESC
Allowed values:
- "ASC"
- "DESC"
|
limit |
integer |
Optional |
limit
|
offset |
integer |
Optional |
offset
|
Response Schema
{
"type": "object",
"properties": {
"organization_roles": {
"type": "array",
"items": {
"type": "object",
"properties": {
"uid": {
"type": "string"
},
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"type": {
"type": "string"
},
"is_default": {
"type": "boolean"
},
"display_order": {
"type": "integer"
},
"organization_uid": {
"type": "string"
},
"is_custom": {
"type": "boolean"
},
"can_add_user": {
"type": "boolean"
},
"can_remove_user": {
"type": "boolean"
},
"can_edit_user_info": {
"type": "boolean"
},
"can_list_organization_users": {
"type": "boolean"
},
"can_add_admin": {
"type": "boolean"
},
"can_remove_admin": {
"type": "boolean"
},
"can_edit_admin_info": {
"type": "boolean"
},
"can_add_guest": {
"type": "boolean"
},
"can_remove_guest": {
"type": "boolean"
},
"can_edit_guest_info": {
"type": "boolean"
},
"can_create_workspace": {
"type": "boolean"
},
"can_view_public_workspace": {
"type": "boolean"
},
"can_approve_guest_invite": {
"type": "boolean"
},
"can_change_organization_settings": {
"type": "boolean"
},
"can_add_organization_role": {
"type": "boolean"
},
"can_edit_organization_role": {
"type": "boolean"
},
"can_delete_organization_role": {
"type": "boolean"
},
"can_add_workspace_role": {
"type": "boolean"
},
"can_edit_workspace_role": {
"type": "boolean"
},
"can_delete_workspace_role": {
"type": "boolean"
},
"can_change_admin_role": {
"type": "boolean"
},
"can_change_user_role": {
"type": "boolean"
},
"can_change_guest_role": {
"type": "boolean"
},
"can_upgrade_guest_to_user": {
"type": "boolean"
},
"can_downgrade_user_to_guest": {
"type": "boolean"
},
"can_upgrade_user_to_admin": {
"type": "boolean"
},
"can_downgrade_admin_to_user": {
"type": "boolean"
},
"can_list_organization_roles": {
"type": "boolean"
},
"can_list_workspace_roles": {
"type": "boolean"
},
"can_upgrade_guest_to_admin": {
"type": "boolean"
},
"can_downgrade_admin_to_guest": {
"type": "boolean"
}
},
"required": ["uid", "name"]
}
},
"total": {
"type": "integer"
},
"limit": {
"type": "integer"
},
"offset": {
"type": "integer"
},
"size": {
"type": "integer"
},
"paging": {
"type": "object",
"properties": {
"prev": {
"type": "string"
},
"self": {
"type": "string"
},
"next": {
"type": "string"
}
}
}
},
"required": ["organization_roles", "total", "limit", "offset", "size", "paging"]
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
500 |
Internal Server Error |
Get all the users in an organization. Require Manage Application Users and Manage Application Organizations permission groups OR only View Organization User List permission group.
Details
Headers
Path
Name |
Type |
Required? |
Description |
organization_uid |
string |
Required |
Organization uid
|
Query
Name |
Type |
Required? |
Description |
query |
string |
Optional |
Search query
|
order_by |
string |
Optional |
Order by fields
|
order_direction |
string |
Optional |
ASC or DESC
Allowed values:
- "ASC"
- "DESC"
|
limit |
integer |
Optional |
limit
|
offset |
integer |
Optional |
offset
|
filter_by |
string |
Optional |
Filter by field
|
role |
string |
Optional |
Support multiple organization role uids separated with commas
|
Response Schema
{
"type": "object",
"properties": {
"organization_users": {
"type": "array",
"items": {
"type": "object",
"properties": {
"uid": {
"type": "string"
},
"email": {
"type": "string"
},
"first_name": {
"type": "string"
},
"last_name": {
"type": "string"
},
"title": {
"type": "string"
},
"industry": {
"type": "string"
},
"phone_number": {
"type": "string"
},
"locked_at": {
"type": "string",
"format": "date-time"
},
"created_at": {
"type": "string",
"format": "date-time"
},
"updated_at": {
"type": "string",
"format": "date-time"
},
"avatar_url": {
"type": "string"
},
"inviter_uid": {
"type": "string"
},
"invited_state": {
"type": "string",
"enum": ["PENDING_INVITE", "INVITED_USER", "INVITED_GUEST", "ACCEPTED"]
},
"organization_role": {
"type": "object",
"properties": {
"uid": {
"type": "string"
},
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"type": {
"type": "string"
},
"is_default": {
"type": "boolean"
},
"display_order": {
"type": "integer"
},
"organization_uid": {
"type": "string"
},
"is_custom": {
"type": "boolean"
},
"can_add_user": {
"type": "boolean"
},
"can_remove_user": {
"type": "boolean"
},
"can_edit_user_info": {
"type": "boolean"
},
"can_list_organization_users": {
"type": "boolean"
},
"can_add_admin": {
"type": "boolean"
},
"can_remove_admin": {
"type": "boolean"
},
"can_edit_admin_info": {
"type": "boolean"
},
"can_add_guest": {
"type": "boolean"
},
"can_remove_guest": {
"type": "boolean"
},
"can_edit_guest_info": {
"type": "boolean"
},
"can_create_workspace": {
"type": "boolean"
},
"can_view_public_workspace": {
"type": "boolean"
},
"can_approve_guest_invite": {
"type": "boolean"
},
"can_change_organization_settings": {
"type": "boolean"
},
"can_add_organization_role": {
"type": "boolean"
},
"can_edit_organization_role": {
"type": "boolean"
},
"can_delete_organization_role": {
"type": "boolean"
},
"can_add_workspace_role": {
"type": "boolean"
},
"can_edit_workspace_role": {
"type": "boolean"
},
"can_delete_workspace_role": {
"type": "boolean"
},
"can_change_admin_role": {
"type": "boolean"
},
"can_change_user_role": {
"type": "boolean"
},
"can_change_guest_role": {
"type": "boolean"
},
"can_upgrade_guest_to_user": {
"type": "boolean"
},
"can_downgrade_user_to_guest": {
"type": "boolean"
},
"can_upgrade_user_to_admin": {
"type": "boolean"
},
"can_downgrade_admin_to_user": {
"type": "boolean"
},
"can_list_organization_roles": {
"type": "boolean"
},
"can_list_workspace_roles": {
"type": "boolean"
},
"can_upgrade_guest_to_admin": {
"type": "boolean"
},
"can_downgrade_admin_to_guest": {
"type": "boolean"
}
},
"required": ["uid", "name"]
}
}
}
},
"total": {
"type": "integer"
},
"limit": {
"type": "integer"
},
"offset": {
"type": "integer"
},
"size": {
"type": "integer"
},
"paging": {
"type": "object",
"properties": {
"prev": {
"type": "string"
},
"self": {
"type": "string"
},
"next": {
"type": "string"
}
}
}
},
"required": ["organization_users", "total", "limit", "offset", "size", "paging"]
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
500 |
Internal Server Error |
Add a user to an organization. Require Manage Organization users permission group.
Details
Headers
Path
Name |
Type |
Required? |
Description |
organization_uid |
string |
Required |
Organization uid
|
Body
Name |
Type |
Required? |
Default |
Description |
email |
string |
Required |
|
|
organization_role_uid |
string |
Optional |
|
|
Response Schema
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
500 |
Internal Server Error |
Update user in an organization. Based on the target user's type, require Manage Organization Users, or , or permission group.
Details
Headers
Path
Name |
Type |
Required? |
Description |
organization_uid |
string |
Required |
Organization uid
|
user_uid |
string |
Required |
User uid
|
Body
Name |
Type |
Required? |
Default |
Description |
organization_role_uid |
string |
Required |
|
|
Response Schema
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
500 |
Internal Server Error |
Remove a user from an organization. Based on the target user type, require Manage Organization Users, or *Manage Guests, or Manage Admins permission group.
Details
Headers
Path
Name |
Type |
Required? |
Description |
organization_uid |
string |
Required |
Organization uid
|
user_uid |
string |
Required |
User uid
|
Query
Name |
Type |
Required? |
Description |
new_workspace_owner_uid |
string |
Optional |
UID of a user in the Org, to whom the deleted user's workspaces need to be assigned
|
Response Schema
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
500 |
Internal Server Error |
Get workspace roles within an organization. Require List Roles permission group.
Details
Headers
Path
Name |
Type |
Required? |
Description |
organization_uid |
string |
Required |
Organization uid
|
Query
Name |
Type |
Required? |
Description |
query |
string |
Optional |
Search query
|
order_by |
string |
Optional |
Order by fields
|
order_direction |
string |
Optional |
ASC or DESC
Allowed values:
- "ASC"
- "DESC"
|
limit |
integer |
Optional |
limit
|
offset |
integer |
Optional |
offset
|
Response Schema
{
"type": "object",
"properties": {
"workspace_roles": {
"type": "array",
"items": {
"type": "object",
"properties": {
"uid": {
"type": "string"
},
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"type": {
"type": "string"
},
"is_default": {
"type": "boolean"
},
"display_order": {
"type": "integer"
},
"organization_uid": {
"type": "string"
},
"is_custom": {
"type": "boolean"
},
"is_saml": {
"type": "boolean"
},
"can_edit_workspace_settings": {
"type": "boolean"
},
"can_edit_workspace_content": {
"type": "boolean"
},
"can_duplicate_workspace": {
"type": "boolean"
},
"can_delete_workspace": {
"type": "boolean"
},
"can_add_user": {
"type": "boolean"
},
"can_remove_user": {
"type": "boolean"
},
"can_add_guest": {
"type": "boolean"
},
"can_remove_guest": {
"type": "boolean"
},
"can_send_to_wall": {
"type": "boolean"
},
"can_change_publish_state": {
"type": "boolean"
},
"can_change_public_state": {
"type": "boolean"
},
"can_download_assets": {
"type": "boolean"
},
"can_change_user_role": {
"type": "boolean"
},
"can_change_owner": {
"type": "boolean"
},
"can_change_organization": {
"type": "boolean"
},
"can_list_collaborators": {
"type": "boolean"
},
"can_send_message": {
"type": "boolean"
},
"can_view_workspace_settings": {
"type": "boolean"
},
"can_comment": {
"type": "boolean"
},
"can_at_mention": {
"type": "boolean"
},
"can_view_workspace_content": {
"type": "boolean"
},
"can_export_workspace": {
"type": "boolean"
},
"can_import_workspace": {
"type": "boolean"
}
},
"required": ["uid", "name"]
}
},
"total": {
"type": "integer"
},
"limit": {
"type": "integer"
},
"offset": {
"type": "integer"
},
"size": {
"type": "integer"
},
"paging": {
"type": "object",
"properties": {
"prev": {
"type": "string"
},
"self": {
"type": "string"
},
"next": {
"type": "string"
}
}
}
},
"required": ["workspace_roles", "total", "limit", "offset", "size", "paging"]
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
500 |
Internal Server Error |
Add a text to the canvas.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_id |
string |
Required |
The Unique ID of the workspace
|
canvas_id |
string |
Required |
The Unique ID of the canvas
|
Body
Name |
Type |
Required? |
Default |
Description |
x |
integer |
Optional |
0 |
|
y |
integer |
Optional |
0 |
|
width |
integer |
Optional |
|
|
height |
integer |
Optional |
|
|
text |
string |
Required |
|
|
fontFamily |
string |
Optional |
Dosis |
Allowed values:
- "Dosis"
- "Helvetica"
- "Times New Roman"
- "Source Code Pro"
- "Aleo"
- "Exo 2"
|
fontSize |
integer |
Optional |
64 |
|
fontColor |
string |
Optional |
#ffffff |
|
fontWeight |
string |
Optional |
normal |
Allowed values:
- "normal"
- "bold"
|
fontStyle |
string |
Optional |
normal |
Allowed values:
- "normal"
- "italic"
|
textTransform |
string |
Optional |
inherit |
Allowed values:
- "inherit"
- "uppercase"
|
backgroundColor |
string |
Optional |
#ea3e35 |
|
pin |
boolean |
Optional |
false |
|
traits |
array |
Optional |
|
|
Response Schema
{
"type": "object",
"properties": {
"text": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"text": {
"type": "string",
"minLength": 1,
"maxLength": 3000
},
"fontFamily": {
"type": "string",
"enum": ["Dosis", "Helvetica", "Times New Roman", "Source Code Pro", "Aleo", "Exo 2"],
"default": "Dosis"
},
"fontSize": {
"type": "integer",
"default": 64
},
"fontColor": {
"type": "string",
"default": "#ffffff"
},
"fontWeight": {
"type": "string",
"enum": ["normal", "bold"],
"default": "normal"
},
"fontStyle": {
"type": "string",
"enum": ["normal", "italic"],
"default": "normal"
},
"textTransform": {
"type": "string",
"enum": ["inherit", "uppercase"],
"default": "inherit"
},
"backgroundColor": {
"type": "string",
"default": "#ea3e35"
},
"pin": {
"type": "boolean",
"default": false
},
"order": {
"type": "integer",
"default": 0
},
"surface": {
"type": "string",
"default": null
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
403 |
ForbiddenError |
404 |
Resource Not Found |
500 |
Internal Server Error |
Get list of text in the workspace.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_id |
string |
Required |
The Unique ID of the workspace
|
Response Schema
{
"type": "object",
"properties": {
"text": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"text": {
"type": "string",
"minLength": 1,
"maxLength": 3000
},
"fontFamily": {
"type": "string",
"enum": ["Dosis", "Helvetica", "Times New Roman", "Source Code Pro", "Aleo", "Exo 2"],
"default": "Dosis"
},
"fontSize": {
"type": "integer",
"default": 64
},
"fontColor": {
"type": "string",
"default": "#ffffff"
},
"fontWeight": {
"type": "string",
"enum": ["normal", "bold"],
"default": "normal"
},
"fontStyle": {
"type": "string",
"enum": ["normal", "italic"],
"default": "normal"
},
"textTransform": {
"type": "string",
"enum": ["inherit", "uppercase"],
"default": "inherit"
},
"backgroundColor": {
"type": "string",
"default": "#ea3e35"
},
"pin": {
"type": "boolean",
"default": false
},
"order": {
"type": "integer",
"default": 0
},
"surface": {
"type": "string",
"default": null
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
403 |
ForbiddenError |
404 |
Resource Not Found |
500 |
Internal Server Error |
Create a text element in the workspace.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_id |
string |
Required |
The Unique ID of the workspace
|
Body
Name |
Type |
Required? |
Default |
Description |
x |
integer |
Optional |
0 |
|
y |
integer |
Optional |
0 |
|
width |
integer |
Optional |
|
|
height |
integer |
Optional |
|
|
text |
string |
Required |
|
|
fontFamily |
string |
Optional |
Dosis |
Allowed values:
- "Dosis"
- "Helvetica"
- "Times New Roman"
- "Source Code Pro"
- "Aleo"
- "Exo 2"
|
fontSize |
integer |
Optional |
64 |
|
fontColor |
string |
Optional |
#ffffff |
|
fontWeight |
string |
Optional |
normal |
Allowed values:
- "normal"
- "bold"
|
fontStyle |
string |
Optional |
normal |
Allowed values:
- "normal"
- "italic"
|
textTransform |
string |
Optional |
inherit |
Allowed values:
- "inherit"
- "uppercase"
|
backgroundColor |
string |
Optional |
#ea3e35 |
|
pin |
boolean |
Optional |
false |
|
traits |
array |
Optional |
|
|
Response Schema
{
"type": "object",
"properties": {
"text": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"text": {
"type": "string",
"minLength": 1,
"maxLength": 3000
},
"fontFamily": {
"type": "string",
"enum": ["Dosis", "Helvetica", "Times New Roman", "Source Code Pro", "Aleo", "Exo 2"],
"default": "Dosis"
},
"fontSize": {
"type": "integer",
"default": 64
},
"fontColor": {
"type": "string",
"default": "#ffffff"
},
"fontWeight": {
"type": "string",
"enum": ["normal", "bold"],
"default": "normal"
},
"fontStyle": {
"type": "string",
"enum": ["normal", "italic"],
"default": "normal"
},
"textTransform": {
"type": "string",
"enum": ["inherit", "uppercase"],
"default": "inherit"
},
"backgroundColor": {
"type": "string",
"default": "#ea3e35"
},
"pin": {
"type": "boolean",
"default": false
},
"order": {
"type": "integer",
"default": 0
},
"surface": {
"type": "string",
"default": null
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
403 |
ForbiddenError |
404 |
Resource Not Found |
500 |
Internal Server Error |
Get text details by Id.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_id |
string |
Required |
The Unique ID of the workspace
|
text_id |
string |
Required |
The Unique ID of the text element
|
Response Schema
{
"type": "object",
"properties": {
"text": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"text": {
"type": "string",
"minLength": 1,
"maxLength": 3000
},
"fontFamily": {
"type": "string",
"enum": ["Dosis", "Helvetica", "Times New Roman", "Source Code Pro", "Aleo", "Exo 2"],
"default": "Dosis"
},
"fontSize": {
"type": "integer",
"default": 64
},
"fontColor": {
"type": "string",
"default": "#ffffff"
},
"fontWeight": {
"type": "string",
"enum": ["normal", "bold"],
"default": "normal"
},
"fontStyle": {
"type": "string",
"enum": ["normal", "italic"],
"default": "normal"
},
"textTransform": {
"type": "string",
"enum": ["inherit", "uppercase"],
"default": "inherit"
},
"backgroundColor": {
"type": "string",
"default": "#ea3e35"
},
"pin": {
"type": "boolean",
"default": false
},
"order": {
"type": "integer",
"default": 0
},
"surface": {
"type": "string",
"default": null
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
403 |
ForbiddenError |
404 |
Resource Not Found |
500 |
Internal Server Error |
Update the specified text element.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_id |
string |
Required |
The Unique ID of the workspace
|
text_id |
string |
Required |
The Unique ID of the text element
|
Body
Name |
Type |
Required? |
Default |
Description |
x |
integer |
Optional |
0 |
|
y |
integer |
Optional |
0 |
|
width |
integer |
Optional |
|
|
height |
integer |
Optional |
|
|
text |
string |
Optional |
|
|
fontFamily |
string |
Optional |
Dosis |
Allowed values:
- "Dosis"
- "Helvetica"
- "Times New Roman"
- "Source Code Pro"
- "Aleo"
- "Exo 2"
|
fontSize |
integer |
Optional |
64 |
|
fontColor |
string |
Optional |
#ffffff |
|
fontWeight |
string |
Optional |
normal |
Allowed values:
- "normal"
- "bold"
|
fontStyle |
string |
Optional |
normal |
Allowed values:
- "normal"
- "italic"
|
textTransform |
string |
Optional |
inherit |
Allowed values:
- "inherit"
- "uppercase"
|
backgroundColor |
string |
Optional |
#ea3e35 |
|
pin |
boolean |
Optional |
false |
|
Response Schema
{
"type": "object",
"properties": {
"text": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"workspace_id": {
"type": "string"
},
"x": {
"type": "integer",
"default": 0
},
"y": {
"type": "integer",
"default": 0
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"text": {
"type": "string",
"minLength": 1,
"maxLength": 3000
},
"fontFamily": {
"type": "string",
"enum": ["Dosis", "Helvetica", "Times New Roman", "Source Code Pro", "Aleo", "Exo 2"],
"default": "Dosis"
},
"fontSize": {
"type": "integer",
"default": 64
},
"fontColor": {
"type": "string",
"default": "#ffffff"
},
"fontWeight": {
"type": "string",
"enum": ["normal", "bold"],
"default": "normal"
},
"fontStyle": {
"type": "string",
"enum": ["normal", "italic"],
"default": "normal"
},
"textTransform": {
"type": "string",
"enum": ["inherit", "uppercase"],
"default": "inherit"
},
"backgroundColor": {
"type": "string",
"default": "#ea3e35"
},
"pin": {
"type": "boolean",
"default": false
},
"order": {
"type": "integer",
"default": 0
},
"surface": {
"type": "string",
"default": null
},
"comments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"text": {
"type": "string"
},
"parentId": {
"type": "string"
},
"actorType": {
"type": "string"
},
"actorId": {
"type": "string"
},
"date": {
"type": "string",
"format": "date-time"
}
}
}
},
"traits": {
"type": "array",
"items": {
"type": "object",
"description": "JSON-LD-conforming JSON document containing arbitrary persistent metadata",
"additionalProperties": true
},
"example": [{
"http://acme.com/bluescape#assetId": "905AF9EC-671E-4EA0-816C-5334D42ECE06"
}]
}
}
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
403 |
ForbiddenError |
404 |
Resource Not Found |
500 |
Internal Server Error |
Delete the specified text element from the workspace.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_id |
string |
Required |
The Unique ID of the workspace
|
text_id |
string |
Required |
The Unique ID of the text element
|
Response Schema
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
403 |
ForbiddenError |
404 |
Resource Not Found |
500 |
Internal Server Error |
Get all users in the application. Require Manage Application Users permission group.
Details
Headers
Query
Name |
Type |
Required? |
Description |
query |
string |
Optional |
Search query
|
order_by |
string |
Optional |
Order by fields
|
order_direction |
string |
Optional |
ASC or DESC
Allowed values:
- "ASC"
- "DESC"
|
filter_by |
string |
Optional |
Filter by field
|
limit |
integer |
Optional |
limit
|
offset |
integer |
Optional |
offset
|
is_organization |
boolean |
Required |
is_organization
|
exclude_guest |
boolean |
Required |
exclude_guest
|
Response Schema
{
"type": "object",
"properties": {
"users": {
"type": "array",
"items": {
"allOf": [{
"title": "UserApplicationOrganization",
"type": "object",
"properties": {
"uid": {
"type": "string"
},
"email": {
"type": "string"
},
"first_name": {
"type": "string"
},
"last_name": {
"type": "string"
},
"title": {
"type": "string"
},
"industry": {
"type": "string"
},
"phone_number": {
"type": "string"
},
"locked_at": {
"type": "string",
"format": "date-time"
},
"archived": {
"type": "boolean"
},
"invited_state": {
"type": "string"
},
"avatar_url": {
"type": "string"
},
"created_at": {
"type": "string",
"format": "date-time"
},
"updated_at": {
"type": "string",
"format": "date-time"
},
"application_role": {
"type": "object",
"title": "application_role",
"properties": {
"uid": {
"type": "string"
},
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"type": {
"type": "string"
},
"is_default": {
"type": "boolean"
},
"display_order": {
"type": "integer"
},
"can_list_users": {
"type": "boolean"
},
"can_list_organizations": {
"type": "boolean"
},
"can_create_organizations": {
"type": "boolean"
},
"can_edit_organizations": {
"type": "boolean"
},
"can_delete_organizations": {
"type": "boolean"
},
"can_edit_users": {
"type": "boolean"
},
"can_list_walls": {
"type": "boolean"
},
"can_create_walls": {
"type": "boolean"
},
"can_edit_walls": {
"type": "boolean"
},
"can_delete_walls": {
"type": "boolean"
},
"can_list_plans": {
"type": "boolean"
},
"can_create_plans": {
"type": "boolean"
},
"can_edit_plans": {
"type": "boolean"
},
"can_delete_plans": {
"type": "boolean"
},
"can_lock_users": {
"type": "boolean"
},
"can_lock_organizations": {
"type": "boolean"
},
"can_delete_users": {
"type": "boolean"
},
"can_create_help_menu": {
"type": "boolean"
},
"can_edit_help_menu": {
"type": "boolean"
},
"can_delete_help_menu": {
"type": "boolean"
},
"can_list_saml_providers": {
"type": "boolean"
},
"can_create_saml_providers": {
"type": "boolean"
},
"can_edit_saml_providers": {
"type": "boolean"
},
"can_delete_saml_providers": {
"type": "boolean"
},
"can_create_broadcast_messages": {
"type": "boolean"
},
"can_edit_broadcast_messages": {
"type": "boolean"
},
"can_delete_broadcast_messages": {
"type": "boolean"
},
"can_create_permission_groups": {
"type": "boolean"
},
"can_delete_permission_groups": {
"type": "boolean"
},
"can_edit_permission_groups": {
"type": "boolean"
},
"can_list_application_roles": {
"type": "boolean"
},
"can_trigger_webhook": {
"type": "boolean"
}
},
"required": ["uid", "name"]
},
"last_login_at": {
"type": "string",
"format": "date-time"
},
"organizations": {
"type": "array",
"items": {
"title": "Organization",
"type": "object",
"properties": {
"uid": {
"type": "string"
},
"name": {
"type": "string"
}
}
}
},
"user_preference": {
"type": "object",
"properties": {
"notify_on_new_message": {
"type": "boolean"
}
}
}
}
}, {
"type": "object",
"properties": {
"user_sso_uid": {
"type": "string"
}
}
}]
}
},
"total": {
"type": "integer"
},
"limit": {
"type": "integer"
},
"offset": {
"type": "integer"
},
"size": {
"type": "integer"
},
"paging": {
"type": "object",
"properties": {
"prev": {
"type": "string"
},
"self": {
"type": "string"
},
"next": {
"type": "string"
}
}
}
},
"required": ["users", "total", "limit", "offset", "size", "paging"]
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
403 |
ForbiddenError |
500 |
Internal Server Error |
Get a user by its user uid. Require User Authentication OR Manage Application Users permission group.
Details
Headers
Path
Name |
Type |
Required? |
Description |
user_uid |
string |
Required |
User uid
|
Response Schema
{
"type": "object",
"properties": {
"user": {
"type": "object",
"properties": {
"uid": {
"type": "string"
},
"email": {
"type": "string"
},
"first_name": {
"type": "string"
},
"last_name": {
"type": "string"
},
"title": {
"type": "string"
},
"industry": {
"type": "string"
},
"phone_number": {
"type": "string"
},
"locked_at": {
"type": "string",
"format": "date-time"
},
"archived": {
"type": "boolean"
},
"invited_state": {
"type": "string"
},
"avatar_url": {
"type": "string"
},
"created_at": {
"type": "string",
"format": "date-time"
},
"updated_at": {
"type": "string",
"format": "date-time"
},
"application_role": {
"type": "object",
"properties": {
"uid": {
"type": "string"
},
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"type": {
"type": "string"
},
"is_default": {
"type": "boolean"
},
"display_order": {
"type": "integer"
},
"can_list_users": {
"type": "boolean"
},
"can_list_organizations": {
"type": "boolean"
},
"can_create_organizations": {
"type": "boolean"
},
"can_edit_organizations": {
"type": "boolean"
},
"can_delete_organizations": {
"type": "boolean"
},
"can_edit_users": {
"type": "boolean"
},
"can_list_walls": {
"type": "boolean"
},
"can_create_walls": {
"type": "boolean"
},
"can_edit_walls": {
"type": "boolean"
},
"can_delete_walls": {
"type": "boolean"
},
"can_list_plans": {
"type": "boolean"
},
"can_create_plans": {
"type": "boolean"
},
"can_edit_plans": {
"type": "boolean"
},
"can_delete_plans": {
"type": "boolean"
},
"can_lock_users": {
"type": "boolean"
},
"can_lock_organizations": {
"type": "boolean"
},
"can_delete_users": {
"type": "boolean"
},
"can_create_help_menu": {
"type": "boolean"
},
"can_edit_help_menu": {
"type": "boolean"
},
"can_delete_help_menu": {
"type": "boolean"
},
"can_list_saml_providers": {
"type": "boolean"
},
"can_create_saml_providers": {
"type": "boolean"
},
"can_edit_saml_providers": {
"type": "boolean"
},
"can_delete_saml_providers": {
"type": "boolean"
},
"can_create_broadcast_messages": {
"type": "boolean"
},
"can_edit_broadcast_messages": {
"type": "boolean"
},
"can_delete_broadcast_messages": {
"type": "boolean"
},
"can_create_permission_groups": {
"type": "boolean"
},
"can_delete_permission_groups": {
"type": "boolean"
},
"can_edit_permission_groups": {
"type": "boolean"
},
"can_list_application_roles": {
"type": "boolean"
},
"can_trigger_webhook": {
"type": "boolean"
}
},
"required": ["uid", "name"]
},
"last_login_at": {
"type": "string",
"format": "date-time"
},
"organizations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"uid": {
"type": "string"
},
"name": {
"type": "string"
}
}
}
},
"user_preference": {
"type": "object",
"properties": {
"notify_on_new_message": {
"type": "boolean"
}
}
}
}
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
404 |
Resource Not Found |
500 |
Internal Server Error |
Update user metadata by user uid. Require User Authentication OR Manage Application Users permission group.
Details
Headers
Path
Name |
Type |
Required? |
Description |
user_uid |
string |
Required |
User uid
|
Body
Name |
Type |
Required? |
Default |
Description |
application_role_uid |
string |
Optional |
|
|
first_name |
string |
Optional |
|
|
last_name |
string |
Optional |
|
|
email |
string |
Optional |
|
|
new_password |
string |
Optional |
|
|
current_password |
string |
Optional |
|
|
user_preference |
object |
Optional |
|
|
Response Schema
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
404 |
Resource Not Found |
500 |
Internal Server Error |
Get all organizations of a user by user uid. Require User Authentication OR Manage Application Organizations permission group.
Details
Headers
Path
Name |
Type |
Required? |
Description |
user_uid |
string |
Required |
User uid
|
Query
Name |
Type |
Required? |
Description |
query |
string |
Optional |
Search query
|
order_by |
string |
Optional |
Order by fields
|
order_direction |
string |
Optional |
ASC or DESC
Allowed values:
- "ASC"
- "DESC"
|
limit |
integer |
Optional |
limit
|
offset |
integer |
Optional |
offset
|
filter_by |
string |
Optional |
Filter by field
|
Response Schema
{
"type": "object",
"properties": {
"organizations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"uid": {
"type": "string"
},
"name": {
"type": "string"
},
"locked_at": {
"type": "string",
"format": "date-time"
},
"account_uid": {
"type": "string"
},
"created_at": {
"type": "string",
"format": "date-time"
},
"updated_at": {
"type": "string",
"format": "date-time"
},
"expiration": {
"type": "string",
"format": "date-time"
},
"is_guest_invite_requires_approval": {
"type": "boolean",
"default": false
},
"is_cam_enabled": {
"type": "boolean",
"default": false
},
"is_custom_role_enabled": {
"type": "boolean",
"default": false
},
"denyOnNoCamData": {
"type": "boolean",
"default": true
},
"organization_role": {
"type": "object",
"properties": {
"uid": {
"type": "string"
},
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"type": {
"type": "string"
},
"is_default": {
"type": "boolean"
},
"display_order": {
"type": "integer"
},
"organization_uid": {
"type": "string"
},
"is_custom": {
"type": "boolean"
},
"can_add_user": {
"type": "boolean"
},
"can_remove_user": {
"type": "boolean"
},
"can_edit_user_info": {
"type": "boolean"
},
"can_list_organization_users": {
"type": "boolean"
},
"can_add_admin": {
"type": "boolean"
},
"can_remove_admin": {
"type": "boolean"
},
"can_edit_admin_info": {
"type": "boolean"
},
"can_add_guest": {
"type": "boolean"
},
"can_remove_guest": {
"type": "boolean"
},
"can_edit_guest_info": {
"type": "boolean"
},
"can_create_workspace": {
"type": "boolean"
},
"can_view_public_workspace": {
"type": "boolean"
},
"can_approve_guest_invite": {
"type": "boolean"
},
"can_change_organization_settings": {
"type": "boolean"
},
"can_add_organization_role": {
"type": "boolean"
},
"can_edit_organization_role": {
"type": "boolean"
},
"can_delete_organization_role": {
"type": "boolean"
},
"can_add_workspace_role": {
"type": "boolean"
},
"can_edit_workspace_role": {
"type": "boolean"
},
"can_delete_workspace_role": {
"type": "boolean"
},
"can_change_admin_role": {
"type": "boolean"
},
"can_change_user_role": {
"type": "boolean"
},
"can_change_guest_role": {
"type": "boolean"
},
"can_upgrade_guest_to_user": {
"type": "boolean"
},
"can_downgrade_user_to_guest": {
"type": "boolean"
},
"can_upgrade_user_to_admin": {
"type": "boolean"
},
"can_downgrade_admin_to_user": {
"type": "boolean"
},
"can_list_organization_roles": {
"type": "boolean"
},
"can_list_workspace_roles": {
"type": "boolean"
},
"can_upgrade_guest_to_admin": {
"type": "boolean"
},
"can_downgrade_admin_to_guest": {
"type": "boolean"
}
},
"required": ["uid", "name"]
},
"plan": {
"type": "object",
"properties": {
"uid": {
"type": "string"
},
"name": {
"type": "string"
}
}
}
}
}
},
"total": {
"type": "integer"
},
"limit": {
"type": "integer"
},
"offset": {
"type": "integer"
},
"size": {
"type": "integer"
},
"paging": {
"type": "object",
"properties": {
"prev": {
"type": "string"
},
"self": {
"type": "string"
},
"next": {
"type": "string"
}
}
}
},
"required": ["organizations", "total", "limit", "offset", "size", "paging"]
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
500 |
Internal Server Error |
Get all the workspaces of a user in an organization. Require User Authentication.
Details
Headers
Path
Name |
Type |
Required? |
Description |
user_uid |
string |
Required |
User uid
|
organization_uid |
string |
Required |
Organization uid
|
Query
Name |
Type |
Required? |
Description |
query |
string |
Optional |
Search query
|
order_by |
string |
Optional |
Order by fields
|
order_direction |
string |
Optional |
ASC or DESC
Allowed values:
- "ASC"
- "DESC"
|
limit |
integer |
Optional |
limit
|
offset |
integer |
Optional |
offset
|
Response Schema
{
"type": "object",
"properties": {
"workspaces": {
"type": "array",
"items": {
"type": "object",
"properties": {
"uid": {
"type": "string"
},
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"organization_uid": {
"type": "string"
},
"public": {
"type": "boolean"
},
"has_meeting": {
"type": "boolean"
},
"published_at": {
"type": "string",
"format": "date-time"
},
"published_url": {
"type": "string"
},
"publish_state": {
"type": "string"
},
"publish_state_at": {
"type": "string",
"format": "date-time"
},
"classification": {
"type": "string"
},
"created_at": {
"type": "string",
"format": "date-time"
},
"updated_at": {
"type": "string",
"format": "date-time"
},
"workspace_role": {
"type": "object",
"properties": {
"uid": {
"type": "string"
},
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"type": {
"type": "string"
},
"is_default": {
"type": "boolean"
},
"display_order": {
"type": "integer"
},
"organization_uid": {
"type": "string"
},
"is_custom": {
"type": "boolean"
},
"is_saml": {
"type": "boolean"
},
"can_edit_workspace_settings": {
"type": "boolean"
},
"can_edit_workspace_content": {
"type": "boolean"
},
"can_duplicate_workspace": {
"type": "boolean"
},
"can_delete_workspace": {
"type": "boolean"
},
"can_add_user": {
"type": "boolean"
},
"can_remove_user": {
"type": "boolean"
},
"can_add_guest": {
"type": "boolean"
},
"can_remove_guest": {
"type": "boolean"
},
"can_send_to_wall": {
"type": "boolean"
},
"can_change_publish_state": {
"type": "boolean"
},
"can_change_public_state": {
"type": "boolean"
},
"can_download_assets": {
"type": "boolean"
},
"can_change_user_role": {
"type": "boolean"
},
"can_change_owner": {
"type": "boolean"
},
"can_change_organization": {
"type": "boolean"
},
"can_list_collaborators": {
"type": "boolean"
},
"can_send_message": {
"type": "boolean"
},
"can_view_workspace_settings": {
"type": "boolean"
},
"can_comment": {
"type": "boolean"
},
"can_at_mention": {
"type": "boolean"
},
"can_view_workspace_content": {
"type": "boolean"
},
"can_export_workspace": {
"type": "boolean"
},
"can_import_workspace": {
"type": "boolean"
}
},
"required": ["uid", "name"]
},
"workspace_owner": {
"type": "object",
"properties": {
"uid": {
"type": "string"
},
"email": {
"type": "string"
},
"first_name": {
"type": "string"
},
"last_name": {
"type": "string"
},
"title": {
"type": "string"
},
"industry": {
"type": "string"
},
"phone_number": {
"type": "string"
},
"avatar_url": {
"type": "string"
},
"locked_at": {
"type": "string",
"format": "date-time"
},
"created_at": {
"type": "string",
"format": "date-time"
},
"updated_at": {
"type": "string",
"format": "date-time"
}
}
},
"users_count": {
"type": "integer"
},
"active_users_count": {
"type": "integer"
},
"favorite": {
"type": "boolean"
}
}
}
},
"total": {
"type": "integer"
},
"limit": {
"type": "integer"
},
"offset": {
"type": "integer"
},
"size": {
"type": "integer"
},
"paging": {
"type": "object",
"properties": {
"prev": {
"type": "string"
},
"self": {
"type": "string"
},
"next": {
"type": "string"
}
}
}
},
"required": ["workspaces", "total", "limit", "offset", "size", "paging"]
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
500 |
Internal Server Error |
Get all the workspaces of a user. Require User Authentication.
Details
Headers
Path
Name |
Type |
Required? |
Description |
user_uid |
string |
Required |
User uid
|
Query
Name |
Type |
Required? |
Description |
query |
string |
Optional |
Search query
|
order_by |
string |
Optional |
Order by fields
|
order_direction |
string |
Optional |
ASC or DESC
Allowed values:
- "ASC"
- "DESC"
|
limit |
integer |
Optional |
limit
|
offset |
integer |
Optional |
offset
|
Response Schema
{
"type": "object",
"properties": {
"workspaces": {
"type": "array",
"items": {
"type": "object",
"properties": {
"uid": {
"type": "string"
},
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"organization_uid": {
"type": "string"
},
"public": {
"type": "boolean"
},
"has_meeting": {
"type": "boolean"
},
"published_at": {
"type": "string",
"format": "date-time"
},
"published_url": {
"type": "string"
},
"publish_state": {
"type": "string"
},
"publish_state_at": {
"type": "string",
"format": "date-time"
},
"classification": {
"type": "string"
},
"created_at": {
"type": "string",
"format": "date-time"
},
"updated_at": {
"type": "string",
"format": "date-time"
},
"workspace_role": {
"type": "object",
"properties": {
"uid": {
"type": "string"
},
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"type": {
"type": "string"
},
"is_default": {
"type": "boolean"
},
"display_order": {
"type": "integer"
},
"organization_uid": {
"type": "string"
},
"is_custom": {
"type": "boolean"
},
"is_saml": {
"type": "boolean"
},
"can_edit_workspace_settings": {
"type": "boolean"
},
"can_edit_workspace_content": {
"type": "boolean"
},
"can_duplicate_workspace": {
"type": "boolean"
},
"can_delete_workspace": {
"type": "boolean"
},
"can_add_user": {
"type": "boolean"
},
"can_remove_user": {
"type": "boolean"
},
"can_add_guest": {
"type": "boolean"
},
"can_remove_guest": {
"type": "boolean"
},
"can_send_to_wall": {
"type": "boolean"
},
"can_change_publish_state": {
"type": "boolean"
},
"can_change_public_state": {
"type": "boolean"
},
"can_download_assets": {
"type": "boolean"
},
"can_change_user_role": {
"type": "boolean"
},
"can_change_owner": {
"type": "boolean"
},
"can_change_organization": {
"type": "boolean"
},
"can_list_collaborators": {
"type": "boolean"
},
"can_send_message": {
"type": "boolean"
},
"can_view_workspace_settings": {
"type": "boolean"
},
"can_comment": {
"type": "boolean"
},
"can_at_mention": {
"type": "boolean"
},
"can_view_workspace_content": {
"type": "boolean"
},
"can_export_workspace": {
"type": "boolean"
},
"can_import_workspace": {
"type": "boolean"
}
},
"required": ["uid", "name"]
},
"workspace_owner": {
"type": "object",
"properties": {
"uid": {
"type": "string"
},
"email": {
"type": "string"
},
"first_name": {
"type": "string"
},
"last_name": {
"type": "string"
},
"title": {
"type": "string"
},
"industry": {
"type": "string"
},
"phone_number": {
"type": "string"
},
"avatar_url": {
"type": "string"
},
"locked_at": {
"type": "string",
"format": "date-time"
},
"created_at": {
"type": "string",
"format": "date-time"
},
"updated_at": {
"type": "string",
"format": "date-time"
}
}
},
"users_count": {
"type": "integer"
},
"active_users_count": {
"type": "integer"
},
"favorite": {
"type": "boolean"
}
}
}
},
"total": {
"type": "integer"
},
"limit": {
"type": "integer"
},
"offset": {
"type": "integer"
},
"size": {
"type": "integer"
},
"paging": {
"type": "object",
"properties": {
"prev": {
"type": "string"
},
"self": {
"type": "string"
},
"next": {
"type": "string"
}
}
}
},
"required": ["workspaces", "total", "limit", "offset", "size", "paging"]
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
500 |
Internal Server Error |
Update the application role for the current session user.
Details
Headers
Body
Name |
Type |
Required? |
Default |
Description |
first_name |
string |
Optional |
|
|
last_name |
string |
Optional |
|
|
email |
string |
Optional |
|
|
new_password |
string |
Optional |
|
|
current_password |
string |
Optional |
|
|
user_preference |
object |
Optional |
|
|
Response Schema
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
404 |
Resource Not Found |
500 |
Internal Server Error |
Get all organizations of the current session user.
Details
Headers
Query
Name |
Type |
Required? |
Description |
query |
string |
Optional |
Search query
|
order_by |
string |
Optional |
Order by fields
|
order_direction |
string |
Optional |
ASC or DESC
Allowed values:
- "ASC"
- "DESC"
|
limit |
integer |
Optional |
limit
|
offset |
integer |
Optional |
offset
|
Response Schema
{
"type": "object",
"properties": {
"organizations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"uid": {
"type": "string"
},
"name": {
"type": "string"
},
"locked_at": {
"type": "string",
"format": "date-time"
},
"account_uid": {
"type": "string"
},
"created_at": {
"type": "string",
"format": "date-time"
},
"updated_at": {
"type": "string",
"format": "date-time"
},
"expiration": {
"type": "string",
"format": "date-time"
},
"is_guest_invite_requires_approval": {
"type": "boolean",
"default": false
},
"is_cam_enabled": {
"type": "boolean",
"default": false
},
"is_custom_role_enabled": {
"type": "boolean",
"default": false
},
"denyOnNoCamData": {
"type": "boolean",
"default": true
},
"organization_role": {
"type": "object",
"properties": {
"uid": {
"type": "string"
},
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"type": {
"type": "string"
},
"is_default": {
"type": "boolean"
},
"display_order": {
"type": "integer"
},
"organization_uid": {
"type": "string"
},
"is_custom": {
"type": "boolean"
},
"can_add_user": {
"type": "boolean"
},
"can_remove_user": {
"type": "boolean"
},
"can_edit_user_info": {
"type": "boolean"
},
"can_list_organization_users": {
"type": "boolean"
},
"can_add_admin": {
"type": "boolean"
},
"can_remove_admin": {
"type": "boolean"
},
"can_edit_admin_info": {
"type": "boolean"
},
"can_add_guest": {
"type": "boolean"
},
"can_remove_guest": {
"type": "boolean"
},
"can_edit_guest_info": {
"type": "boolean"
},
"can_create_workspace": {
"type": "boolean"
},
"can_view_public_workspace": {
"type": "boolean"
},
"can_approve_guest_invite": {
"type": "boolean"
},
"can_change_organization_settings": {
"type": "boolean"
},
"can_add_organization_role": {
"type": "boolean"
},
"can_edit_organization_role": {
"type": "boolean"
},
"can_delete_organization_role": {
"type": "boolean"
},
"can_add_workspace_role": {
"type": "boolean"
},
"can_edit_workspace_role": {
"type": "boolean"
},
"can_delete_workspace_role": {
"type": "boolean"
},
"can_change_admin_role": {
"type": "boolean"
},
"can_change_user_role": {
"type": "boolean"
},
"can_change_guest_role": {
"type": "boolean"
},
"can_upgrade_guest_to_user": {
"type": "boolean"
},
"can_downgrade_user_to_guest": {
"type": "boolean"
},
"can_upgrade_user_to_admin": {
"type": "boolean"
},
"can_downgrade_admin_to_user": {
"type": "boolean"
},
"can_list_organization_roles": {
"type": "boolean"
},
"can_list_workspace_roles": {
"type": "boolean"
},
"can_upgrade_guest_to_admin": {
"type": "boolean"
},
"can_downgrade_admin_to_guest": {
"type": "boolean"
}
},
"required": ["uid", "name"]
},
"plan": {
"type": "object",
"properties": {
"uid": {
"type": "string"
},
"name": {
"type": "string"
}
}
}
}
}
},
"total": {
"type": "integer"
},
"limit": {
"type": "integer"
},
"offset": {
"type": "integer"
},
"size": {
"type": "integer"
},
"paging": {
"type": "object",
"properties": {
"prev": {
"type": "string"
},
"self": {
"type": "string"
},
"next": {
"type": "string"
}
}
}
},
"required": ["organizations", "total", "limit", "offset", "size", "paging"]
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
500 |
Internal Server Error |
Get all the workspaces of the current session user. Require User Authentication
Details
Headers
Query
Name |
Type |
Required? |
Description |
query |
string |
Optional |
Search query
|
filter_by |
string |
Optional |
Filter by field
|
order_by |
string |
Optional |
Order by fields
|
order_direction |
string |
Optional |
ASC or DESC
Allowed values:
- "ASC"
- "DESC"
|
limit |
integer |
Optional |
limit
|
offset |
integer |
Optional |
offset
|
my_workspace |
boolean |
Optional |
Exclude all public Workspaces that session user have NOT been explicitly invited to collaborate or Return all the workspace list
|
Response Schema
{
"type": "object",
"properties": {
"workspaces": {
"type": "array",
"items": {
"type": "object",
"properties": {
"uid": {
"type": "string"
},
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"organization_uid": {
"type": "string"
},
"public": {
"type": "boolean"
},
"has_meeting": {
"type": "boolean"
},
"published_at": {
"type": "string",
"format": "date-time"
},
"published_url": {
"type": "string"
},
"publish_state": {
"type": "string"
},
"publish_state_at": {
"type": "string",
"format": "date-time"
},
"classification": {
"type": "string"
},
"created_at": {
"type": "string",
"format": "date-time"
},
"updated_at": {
"type": "string",
"format": "date-time"
},
"accessed_at": {
"type": "string",
"format": "date-time"
},
"workspace_role": {
"type": "object",
"properties": {
"uid": {
"type": "string"
},
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"type": {
"type": "string"
},
"is_default": {
"type": "boolean"
},
"display_order": {
"type": "integer"
},
"organization_uid": {
"type": "string"
},
"is_custom": {
"type": "boolean"
},
"is_saml": {
"type": "boolean"
},
"can_edit_workspace_settings": {
"type": "boolean"
},
"can_edit_workspace_content": {
"type": "boolean"
},
"can_duplicate_workspace": {
"type": "boolean"
},
"can_delete_workspace": {
"type": "boolean"
},
"can_add_user": {
"type": "boolean"
},
"can_remove_user": {
"type": "boolean"
},
"can_add_guest": {
"type": "boolean"
},
"can_remove_guest": {
"type": "boolean"
},
"can_send_to_wall": {
"type": "boolean"
},
"can_change_publish_state": {
"type": "boolean"
},
"can_change_public_state": {
"type": "boolean"
},
"can_download_assets": {
"type": "boolean"
},
"can_change_user_role": {
"type": "boolean"
},
"can_change_owner": {
"type": "boolean"
},
"can_change_organization": {
"type": "boolean"
},
"can_list_collaborators": {
"type": "boolean"
},
"can_send_message": {
"type": "boolean"
},
"can_view_workspace_settings": {
"type": "boolean"
},
"can_comment": {
"type": "boolean"
},
"can_at_mention": {
"type": "boolean"
},
"can_view_workspace_content": {
"type": "boolean"
},
"can_export_workspace": {
"type": "boolean"
},
"can_import_workspace": {
"type": "boolean"
}
},
"required": ["uid", "name"]
},
"workspace_owner": {
"type": "object",
"properties": {
"uid": {
"type": "string"
},
"email": {
"type": "string"
},
"first_name": {
"type": "string"
},
"last_name": {
"type": "string"
},
"title": {
"type": "string"
},
"industry": {
"type": "string"
},
"phone_number": {
"type": "string"
},
"avatar_url": {
"type": "string"
},
"locked_at": {
"type": "string",
"format": "date-time"
},
"created_at": {
"type": "string",
"format": "date-time"
},
"updated_at": {
"type": "string",
"format": "date-time"
}
}
},
"users_count": {
"type": "integer"
},
"active_users_count": {
"type": "integer"
},
"favorite": {
"type": "boolean"
}
}
}
},
"total": {
"type": "integer"
},
"limit": {
"type": "integer"
},
"offset": {
"type": "integer"
},
"size": {
"type": "integer"
},
"paging": {
"type": "object",
"properties": {
"prev": {
"type": "string"
},
"self": {
"type": "string"
},
"next": {
"type": "string"
}
}
}
},
"required": ["workspaces", "total", "limit", "offset", "size", "paging"]
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
500 |
Internal Server Error |
Create a new workspace in an organization. Require Create Workspace permission group.
Details
Headers
Path
Name |
Type |
Required? |
Description |
organization_uid |
string |
Required |
Organization uid
|
Body
Name |
Type |
Required? |
Default |
Description |
name |
string |
Required |
|
|
description |
string |
Optional |
|
|
public |
boolean |
Optional |
false |
|
has_meeting |
boolean |
Optional |
false |
|
default_role_uid |
string |
Optional |
|
|
users |
array |
Optional |
|
|
Response Schema
{
"type": "object",
"properties": {
"workspace": {
"type": "object",
"properties": {
"uid": {
"type": "string"
},
"publish_state": {
"type": "string"
},
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"organization_uid": {
"type": "string"
},
"public": {
"type": "boolean"
},
"permanent_delete_pending": {
"type": "boolean",
"default": false
},
"has_meeting": {
"type": "boolean"
},
"default_role_uid": {
"type": "string"
},
"users": {
"type": "array",
"items": {
"type": "object",
"properties": {
"user_uid": {
"type": "string"
},
"workspace_uid": {
"type": "string"
},
"workspace_role_uid": {
"type": "string"
},
"created_at": {
"type": "string",
"format": "date-time"
},
"updated_at": {
"type": "string",
"format": "date-time"
}
}
}
},
"created_at": {
"type": "string",
"format": "date-time"
},
"updated_at": {
"type": "string",
"format": "date-time"
}
}
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
500 |
Internal Server Error |
Send workspace to wall. Require Send to Wall permission group. The user must also belong to the organization that owns the wall.
See more details in the Wall APIs page.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_id |
string |
Required |
The Unique ID of the workspace
|
Body
Name |
Type |
Required? |
Default |
Description |
wallUid |
string |
Required |
|
The Unique ID of the wall
|
Response Schema
{
"type": "object",
"properties": {
"wallUid": {
"type": "string"
},
"wallName": {
"type": "string"
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
401 |
Unauthorized |
403 |
ForbiddenError |
404 |
Resource Not Found |
500 |
Internal Server Error |
Unsend workspace from wall. Require Send to Wall or Unsend Workspace From Walls permission group. A workspace owner can unsend the workspace from any wall. A workspace user with Editor or Editor+ role can unsend the workspace if they were the sender of the workspace previously.
See more details in the Wall APIs page.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_id |
string |
Required |
The Unique ID of the workspace
|
Body
Name |
Type |
Required? |
Default |
Description |
wallUid |
string |
Required |
|
The Unique ID of the wall
|
Response Schema
null
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
BadRequest |
401 |
Unauthorized |
403 |
ForbiddenError |
500 |
Internal Server Error |
Get workspace by workspace uid. Require the user is a member of workspace OR can use Wall Access Token.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_uid |
string |
Required |
Workspace uid
|
Response Schema
{
"type": "object",
"properties": {
"workspace": {
"type": "object",
"properties": {
"uid": {
"type": "string"
},
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"organization_uid": {
"type": "string"
},
"public": {
"type": "boolean"
},
"has_meeting": {
"type": "boolean"
},
"default_role_uid": {
"type": "string"
},
"published_at": {
"type": "string",
"format": "date-time"
},
"published_url": {
"type": "string"
},
"publish_state": {
"type": "string"
},
"publish_state_at": {
"type": "string",
"format": "date-time"
},
"classification": {
"type": "string"
},
"created_at": {
"type": "string",
"format": "date-time"
},
"updated_at": {
"type": "string",
"format": "date-time"
},
"workspace_role": {
"type": "object",
"properties": {
"uid": {
"type": "string"
},
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"type": {
"type": "string"
},
"is_default": {
"type": "boolean"
},
"display_order": {
"type": "integer"
},
"organization_uid": {
"type": "string"
},
"is_custom": {
"type": "boolean"
},
"is_saml": {
"type": "boolean"
},
"can_edit_workspace_settings": {
"type": "boolean"
},
"can_edit_workspace_content": {
"type": "boolean"
},
"can_duplicate_workspace": {
"type": "boolean"
},
"can_delete_workspace": {
"type": "boolean"
},
"can_add_user": {
"type": "boolean"
},
"can_remove_user": {
"type": "boolean"
},
"can_add_guest": {
"type": "boolean"
},
"can_remove_guest": {
"type": "boolean"
},
"can_send_to_wall": {
"type": "boolean"
},
"can_change_publish_state": {
"type": "boolean"
},
"can_change_public_state": {
"type": "boolean"
},
"can_download_assets": {
"type": "boolean"
},
"can_change_user_role": {
"type": "boolean"
},
"can_change_owner": {
"type": "boolean"
},
"can_change_organization": {
"type": "boolean"
},
"can_list_collaborators": {
"type": "boolean"
},
"can_send_message": {
"type": "boolean"
},
"can_view_workspace_settings": {
"type": "boolean"
},
"can_comment": {
"type": "boolean"
},
"can_at_mention": {
"type": "boolean"
},
"can_view_workspace_content": {
"type": "boolean"
},
"can_export_workspace": {
"type": "boolean"
},
"can_import_workspace": {
"type": "boolean"
}
},
"required": ["uid", "name"]
}
}
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
403 |
ForbiddenError |
500 |
Internal Server Error |
Update the metadata of a workspace. Based on the update target field, require Edit Workspace Settings or Manage Workspace permission group.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_uid |
string |
Required |
Workspace uid
|
Body
Name |
Type |
Required? |
Default |
Description |
name |
string |
Optional |
|
|
description |
string |
Optional |
|
|
public |
boolean |
Optional |
|
|
has_meeting |
boolean |
Optional |
|
|
default_role_uid |
string |
Optional |
|
|
user_uid |
string |
Optional |
|
|
Response Schema
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
404 |
Resource Not Found |
500 |
Internal Server Error |
Delete a workspace temporarily or permanently. Require Manage Workspace permission group.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_uid |
string |
Required |
Workspace uid
|
Body
Name |
Type |
Required? |
Default |
Description |
is_permanent |
boolean |
Optional |
false |
|
Response Schema
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
500 |
Internal Server Error |
Get users currently active in the specified workspace.
Supported `query` fields: `email`, `first_name`, `last_name`.
The value of `query` will be searched against all of these fields.
Supported `order_by` fields: `email`, `first_name`, `last_name`.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_uid |
string |
Required |
Workspace uid
|
Query
Name |
Type |
Required? |
Description |
query |
string |
Optional |
Search query
|
order_by |
string |
Optional |
Order by fields
|
order_direction |
string |
Optional |
ASC or DESC
Allowed values:
- "ASC"
- "DESC"
|
limit |
integer |
Optional |
limit
|
offset |
integer |
Optional |
offset
|
Response Schema
{
"type": "object",
"properties": {
"active_users": {
"type": "array",
"items": {
"type": "object",
"properties": {
"uid": {
"type": "string"
},
"type": {
"type": "string"
},
"email": {
"type": "string"
},
"first_name": {
"type": "string"
},
"last_name": {
"type": "string"
},
"leader": {
"type": "boolean"
}
},
"required": ["uid", "email", "first_name", "last_name", "leader"]
}
},
"total": {
"type": "integer"
},
"limit": {
"type": "integer"
},
"offset": {
"type": "integer"
},
"size": {
"type": "integer"
},
"paging": {
"type": "object",
"properties": {
"prev": {
"type": "string"
},
"self": {
"type": "string"
},
"next": {
"type": "string"
}
}
}
},
"required": ["active_users", "total", "limit", "offset", "size", "paging"]
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
403 |
ForbiddenError |
404 |
Resource Not Found |
500 |
Internal Server Error |
Get all users from a specific workspace by workspace uid. Require View Workspace Collaborators permission group.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_uid |
string |
Required |
Workspace UID
|
Query
Name |
Type |
Required? |
Description |
filter_by |
string |
Optional |
Filter by field
|
Response Schema
{
"type": "object",
"properties": {
"workspace_users": {
"type": "array",
"items": {
"type": "object",
"properties": {
"uid": {
"type": "string"
},
"email": {
"type": "string"
},
"first_name": {
"type": "string"
},
"last_name": {
"type": "string"
}
}
}
},
"total": {
"type": "integer"
}
},
"required": ["workspace_users", "total"]
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
404 |
Resource Not Found |
500 |
Internal Server Error |
Make a copy of a specific workspace by workspace uid. Require Manage Workspace permission group.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_uid |
string |
Required |
Workspace uid
|
Body
Name |
Type |
Required? |
Default |
Description |
new_workspace_name |
string |
Optional |
|
|
new_workspace_description |
string |
Optional |
|
|
Response Schema
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
404 |
Resource Not Found |
500 |
Internal Server Error |
Mark a specific workspace as user favorite workspace
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_uid |
string |
Required |
Workspace uid
|
Body
Name |
Type |
Required? |
Default |
Description |
favorite |
boolean |
Optional |
true |
|
Response Schema
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
404 |
Resource Not Found |
500 |
Internal Server Error |
Add a user by user uid to a specific workspace by workspace uid
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_uid |
string |
Required |
Workspace uid
|
Body
Name |
Type |
Required? |
Default |
Description |
users |
array |
Required |
|
array of users => email (string), workspace_role_uid (string)
|
Response Schema
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
500 |
Internal Server Error |
Update a user's role in a specific workspace. Require Edit Workspace Collaborators permission group.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_uid |
string |
Required |
Workspace uid
|
user_uid |
string |
Required |
User uid
|
Body
Name |
Type |
Required? |
Default |
Description |
workspace_role_uid |
string |
Required |
|
|
Response Schema
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
500 |
Internal Server Error |
Remove a user or guest from a workspace. Require Edit Workspace Collaborators permission group.
Details
Headers
Path
Name |
Type |
Required? |
Description |
workspace_uid |
string |
Required |
Workspace uid
|
user_uid |
string |
Required |
User uid
|
Response Schema
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
}
Errors
This table lists the expected errors that this method could return. However, other errors can be returned in the case where the service is down or other unexpected factors affect processing.
Code |
Description |
400 |
Bad Request |
401 |
Unauthorized |
500 |
Internal Server Error |