> ## Documentation Index
> Fetch the complete documentation index at: https://www.posted.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# get_draft

> Get a draft with Posted MCP.

Read a draft's text, selected accounts, overrides and ordered media.

## Workflow

```mermaid theme={"system"}
flowchart LR
  step0["Choose a draft"] --> step1
  step1["Read text and account media"] --> step2
  step2["Keep its current version"]
```

## Access and behavior

A Read-only, Write or Administrator OAuth grant can call this tool within the user’s current team role. Tools are listed and callable only when the current grant and role permit them.

Resolved media and mediaOverrides contain media objects. Saving uses mediaIds and mediaOverrides containing IDs.

## Arguments

| Argument | Required | Type or meaning |
| - | - | - |
| `draftId` | Yes | Draft UUID; choose a new UUID when creating, or read the saved draft before updating. |

<Accordion title="Complete input schema">
  ```json theme={"system"}
  {
    "type": "object",
    "properties": {
      "draftId": {
        "type": "string",
        "format": "uuid",
        "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)$"
      }
    },
    "required": ["draftId"],
    "additionalProperties": false
  }
  ```
</Accordion>

## Example call

The client initializes the MCP connection before sending this JSON-RPC call. Example records are fictional.

```json theme={"system"}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_draft",
    "arguments": {
      "draftId": "33333333-3333-4333-8333-333333333333"
    }
  }
}
```

## Example result

Posted returns this object in `structuredContent` and a JSON text content block. A tool failure sets `isError`; never treat an error as a completed mutation.

```json theme={"system"}
{
  "draft": {
    "id": "33333333-3333-4333-8333-333333333333",
    "text": "An unfinished studio update.",
    "additionalPosts": [],
    "mediaOverrides": {},
    "textOverrides": {},
    "connectionIds": ["11111111-1111-4111-8111-111111111111"],
    "connections": [
      {
        "id": "11111111-1111-4111-8111-111111111111",
        "provider": "bluesky",
        "accountId": "did:plc:example",
        "name": "Alex Morgan",
        "handle": "alex.example.test",
        "avatarUrl": null,
        "state": "connected",
        "createdAt": "2027-01-18T09:30:00.000Z"
      }
    ],
    "media": [
      {
        "id": "44444444-4444-4444-8444-444444444444",
        "fileName": "studio.jpg",
        "contentType": "image/jpeg",
        "sizeBytes": 245760,
        "width": 1600,
        "height": 900,
        "alt": "A bright studio desk beside a window",
        "durationSeconds": null
      }
    ],
    "version": 1,
    "createdAt": "2027-01-18T09:30:00.000Z",
    "updatedAt": "2027-01-18T09:30:00.000Z",
    "draftedBy": {
      "id": "66666666-6666-4666-8666-666666666666",
      "name": "Alex Morgan",
      "avatarUrl": null
    }
  }
}
```

## Related reference

[HTTP operation](/api-reference/get_api_drafts_by_draftId) · [Connect an MCP client](/mcp-connections) · [Request conventions](/api-reference/overview)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.