> ## Documentation Index
> Fetch the complete documentation index at: https://mako-docs.devinagiffy.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Task Draft

> Create a new task draft for confirmation

<Note>This endpoint requires authentication.</Note>

## Request

<ParamField body="title" type="string" required>
  Task title (1-200 characters)
</ParamField>

<ParamField body="description" type="string">
  Detailed description (max 2000 characters)
</ParamField>

<ParamField body="priority" type="integer" default="3">
  Priority level: 1 (highest) to 5 (lowest)
</ParamField>

<ParamField body="dueDate" type="string">
  Due date in ISO 8601 format
</ParamField>

<ParamField body="rawInput" type="string">
  Original natural language input (for AI learning)
</ParamField>

## Response

<ResponseField name="id" type="string">
  Draft UUID
</ResponseField>

<ResponseField name="title" type="string">
  Parsed task title
</ResponseField>

<ResponseField name="description" type="string">
  Task description
</ResponseField>

<ResponseField name="priority" type="integer">
  Priority level
</ResponseField>

<ResponseField name="status" type="string">
  Draft status: `pending`, `confirmed`, or `rejected`
</ResponseField>

<ResponseField name="dueDate" type="string">
  Due date if set
</ResponseField>

<ResponseField name="createdAt" type="string">
  Creation timestamp
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.hitler.app/api/tasks/drafts" \
    -H "Authorization: Bearer YOUR_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
      "title": "Review Q4 budget proposal",
      "priority": 2,
      "dueDate": "2024-01-20T17:00:00.000Z",
      "rawInput": "remind me to review the Q4 budget by Friday"
    }'
  ```

  ```typescript TypeScript theme={null}
  const draft = await api.createTaskDraft({
    title: "Review Q4 budget proposal",
    priority: 2,
    dueDate: new Date("2024-01-20T17:00:00.000Z"),
    rawInput: "remind me to review the Q4 budget by Friday",
  });
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "id": "draft-uuid-123",
    "title": "Review Q4 budget proposal",
    "description": null,
    "priority": 2,
    "status": "pending",
    "dueDate": "2024-01-20T17:00:00.000Z",
    "rawInput": "remind me to review the Q4 budget by Friday",
    "userId": "user-uuid",
    "organizationId": "org-uuid",
    "createdAt": "2024-01-15T10:30:00.000Z"
  }
  ```
</ResponseExample>