# Drafts

Endpoints for creating, reading, updating, and deleting drafts, as well as publishing them to posts

## Get all drafts for the current user

 - [GET /api/v1/drafts](https://docs.wellesley.social/openapi/drafts/paths/~1api~1v1~1drafts/get.md): Returns a list of all drafts created by the authenticated user, sorted by last modification date.

## Create a new draft

 - [POST /api/v1/drafts](https://docs.wellesley.social/openapi/drafts/paths/~1api~1v1~1drafts/post.md): Creates a new draft that can be saved and published later. Drafts can be associated with users, groups, or categories, and can be linked to existing posts for editing.

## Get all drafts for a specific owner

 - [GET /api/v1/drafts/owner/{ownerId}](https://docs.wellesley.social/openapi/drafts/paths/~1api~1v1~1drafts~1owner~1%7Bownerid%7D/get.md): Returns all drafts associated with a specific owner (user or category). Only drafts owned by the authenticated user are returned.

## Get a draft for a specific post

 - [GET /api/v1/drafts/post/{postId}](https://docs.wellesley.social/openapi/drafts/paths/~1api~1v1~1drafts~1post~1%7Bpostid%7D/get.md): Retrieves a draft associated with a specific post ID. Used for editing existing posts. Only the draft owner can access it.

## Update an existing draft

 - [PUT /api/v1/drafts/{draftId}](https://docs.wellesley.social/openapi/drafts/paths/~1api~1v1~1drafts~1%7Bdraftid%7D/put.md): Updates the content, title, privacy settings, or tags of an existing draft. Only the draft owner can update it.

## Get a draft by ID

 - [GET /api/v1/drafts/{draftId}](https://docs.wellesley.social/openapi/drafts/paths/~1api~1v1~1drafts~1%7Bdraftid%7D/get.md): Retrieves a specific draft by its unique identifier. Only the draft owner can access it.

## Delete a draft

 - [DELETE /api/v1/drafts/{draftId}](https://docs.wellesley.social/openapi/drafts/paths/~1api~1v1~1drafts~1%7Bdraftid%7D/delete.md): Permanently deletes a draft. Only the draft owner can delete it. This action cannot be undone.

## Publish a draft as a post

 - [POST /api/v1/drafts/{draftId}/publish](https://docs.wellesley.social/openapi/drafts/paths/~1api~1v1~1drafts~1%7Bdraftid%7D~1publish/post.md): Publishes a draft, converting it into a public post. The draft is deleted after successful publication. Only the draft owner can publish it.