# attach_plotwork_diagram

> Page: https://docs.flung.dev/mcp/tools/attach-plotwork-diagram. Index of every page: https://docs.flung.dev/llms.txt

Add a Plotwork diagram as an image. Imports a Plotwork diagram as a PNG with its name as alt text; pass the returned id in mediaIds to schedule_post or update_post.

## TL;DR

| Question | Answer |
|---|---|
| What does it do? | Imports a Plotwork diagram as a PNG with its name as alt text; pass the returned id in mediaIds to schedule_post or update_post. |
| Does it change anything? | Changes something. |
| Which endpoint does it call? | [`POST /v1/plotwork/diagrams/{id}/import`](https://docs.flung.dev/reference/api/post-v1-plotwork-diagrams-id-import.md) |
| Which server? | `https://mcp.flung.dev/mcp-oauth` (sign in) or `https://mcp.flung.dev/mcp` (API key). |

## Arguments

| Argument | Type | Required | Description |
|---|---|---|---|
| `diagramId` | `string` | yes | From list_plotwork_diagrams. pattern `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}\|00000000-0000-0000-0000-000000000000\|ffffffff-ffff-ffff-ffff-ffffffffffff)$`. |
| `scheme` | `"light" \| "dark"` | no |  |
| `altText` | `string` | no | Instead of the name. at least 1 character; at most 1000 characters. |

## Example call

```json
{
  "name": "attach_plotwork_diagram",
  "arguments": {
    "diagramId": "00000000-0000-4000-8000-000000000003",
    "scheme": "light"
  }
}
```

## Things a person might say

- "Post our checkout flow diagram from Plotwork to LinkedIn."

## Annotations

| Hint | Value |
|---|---|
| `readOnlyHint` | false |
| `destructiveHint` | false |
| `idempotentHint` | false |
| `openWorldHint` | true |

## See also

| Doc | Why |
|---|---|
| [MCP tools](https://docs.flung.dev/mcp/tools.md) | Every tool |
| [Connect an AI agent](https://docs.flung.dev/mcp.md) | Install the server in your client |
| [`POST /v1/plotwork/diagrams/{id}/import`](https://docs.flung.dev/reference/api/post-v1-plotwork-diagrams-id-import.md) | The same operation over HTTP |