put_space_diagram
Writes DGMO diagrams to a Diagrammo Cloud space by folder and title: updates an existing diagram or creates a private one, returning created/updated status.
Instructions
Write a DGMO diagram into a Diagrammo Cloud space, by folder and title: updates the diagram with that title in that folder, or creates it (private) when there is none. Re-sending identical source changes nothing. Returns JSON { action: "created" | "updated", id, title, folder, version }. Needs DGMO_API_KEY (a space API key) in the server environment. Errors name the cause: 401 bad or revoked key, 403 not allowed, 404 no such space or folder, 409 another write landed first (call again). Call validate_diagram first; this does not validate.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"space_id": "<space_id>",
"title": "<title>",
"dgmo": "<dgmo>"
},
"name": "put_space_diagram"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dgmo | Yes | DGMO diagram markup | |
| title | Yes | Diagram title within the folder. | |
| folder | No | Folder path from the space root, e.g. "docs/architecture". Omit for the root. | |
| space_id | Yes | The space the API key belongs to (the key does not name it). Shown beside the key when it is made at https://online.diagrammo.app/account. |