app.bsky.draft.createDraft Documentation (EN)

main procedure

Inserts a draft using private storage (stash). An upper limit of drafts might be enforced. Requires authentication.

Input

Encodingapplication/json

draft refapp.bsky.draft.defs#draft Required

No description available.

Output

Encodingapplication/json

id string Required

The ID of the created draft.

Errors

DraftLimitReached Trying to insert a new draft when the limit was already reached.

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Service Endpoint Base URL for XRPC calls (e.g., https://bsky.social)

Request Body (JSON) Enter valid JSON for the request body

View raw schema

{
  "type": "procedure",
  "input": {
    "schema": {
      "type": "object",
      "required": [
        "draft"
      ],
      "properties": {
        "draft": {
          "ref": "app.bsky.draft.defs#draft",
          "type": "ref"
        }
      }
    },
    "encoding": "application/json"
  },
  "errors": [
    {
      "name": "DraftLimitReached",
      "description": "Trying to insert a new draft when the limit was already reached."
    }
  ],
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "id"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "The ID of the created draft."
        }
      }
    },
    "encoding": "application/json"
  },
  "description": "Inserts a draft using private storage (stash). An upper limit of drafts might be enforced. Requires authentication."
}