Move diagram
Move a diagram to specified fodler.
Method
GET, POST
URL
https://cacoo.com/api/v1/diagrams/diagramId/move.format
Example : https://cacoo.com/api/v1/diagrams/00e77f4dc9973517/move.json
json, xml
Authentication
required
Error
| Status Code |
Message |
Content |
| 400 |
Message to verify entered text |
Error found in entered text |
| 404 |
FOLDER_NOT_FOUND |
Cannot move the diagram as the folder does not exist or you have no permission. |
Parameters
| Parameter Name |
Type |
Content |
Example |
| diagramId (Required) |
String |
Diagram Id |
00e77f4dc9973517 |
| folderId (Required) |
Integer |
Destination folder’s ID |
123 |
| organizationKey (Required) |
String |
Organization Key from the Organizations API |
abcdefghij |
*If you are using a legacy plan (i.e. the old Free Plan or Plus Plan), you do not need to add organizationKey to the parameters.
Response
| Field |
Type |
Description |
Example |
| url |
String |
Public URL for Diagram |
https://cacoo.com/diagrams/00e77f4dc9973517 |
| imageUrl |
String |
URL of the first image |
https://cacoo.com/diagrams/00e77f4dc9973517.png |
| imageUrlForApi |
String |
String to interact with the image using the API |
https://cacoo.com/api/v1/diagrams/00e77f4dc9973517.png |
| diagramId |
String |
Diagram ID |
00e77f4dc9973517 |
| title |
String |
Title of Diagram |
Wireframe |
| description |
String |
Diagram description |
Current project wireframe |
JSON Response Example
{
"url": "https://cacoo.com/diagrams/00e77f4dc9973517",
"imageUrl": "https://cacoo.com/diagrams/00e77f4dc9973517.png",
"imageUrlForApi": "https://cacoo.com/api/v1/diagrams/00e77f4dc9973517.png",
"diagramId": "00e77f4dc9973517",
"title": "Wireframe",
"description": "Current project wireframe"
}
XML Response Example
<?xml version="1.0" encoding="utf-8"?>
<diagram>
<url>https://cacoo.com/diagrams/00e77f4dc9973517</url>
<imageUrl>https://cacoo.com/diagrams/00e77f4dc9973517.png</imageUrl>
<imageUrlForApi>https://cacoo.com/api/v1/diagrams/00e77f4dc9973517.png</imageUrlForApi>
<diagramId>00e77f4dc9973517</diagramId>
<title>Wireframe</title>
<description>Current project wireframe</description>
</diagram>