Working with post drafts

Drafts let you develop content over time instead of publishing in one shot. They live in Crispy, not on LinkedIn, until you publish.

The draft lifecycle

1. save_draft creates a draft and returns a draft ID. Drafts support everything a live post does: up to 3000 characters, attachments, @-mentions, a link preview, and company page targeting. They also carry two fields that are never published: private notes and a target audience description, useful for planning the angle.
2. update_draft edits any subset of fields on a draft in 'draft' or 'archived' status. Change just the text, just the notes, or swap the attachments.
3. list_drafts shows your pipeline, sorted by most recently updated. It defaults to status 'draft'; pass status 'published' to see drafts that became live posts, each with its published post ID and publish time.
4. publish_draft turns a draft into a live LinkedIn post. It is idempotent: if the draft was already published, you get the existing post ID back instead of a duplicate post. If publishing fails, the draft rolls back to 'draft' status so nothing is lost.
5. delete_draft permanently removes a draft in 'draft' or 'archived' status. Drafts that are publishing or published cannot be deleted.

Limits

Publishing counts toward the same 10-per-day posting cap as create_post. Saving and editing drafts costs nothing; only the publish consumes budget.

Why drafts beat posting directly

Your agent can queue a week of ideas as drafts, each with a private note on the angle. You review and edit at your own pace, and only the posts you approve go live.