create_chore
Create chores in Donetick using simple natural language inputs like days of week and time. Automatically transforms parameters to the correct API format.
Instructions
Create a new chore in Donetick with easy natural language inputs. Use simple parameters like usernames, days_of_week, and time_of_day - they're automatically transformed to the correct API format.
EXAMPLES:
Simple recurring chore: {name: 'Take out trash', days_of_week: ['Mon', 'Thu'], time_of_day: '19:00', usernames: ['Alice']}
Weekly chore with reminders: {name: 'Team meeting', days_of_week: ['Tue'], time_of_day: '14:00', remind_minutes_before: 15, usernames: ['Alice', 'Bob']}
With subtasks and labels: {name: 'Weekly review', days_of_week: ['Fri'], time_of_day: '17:00', subtask_names: ['Check email', 'Update notes'], label_names: ['work', 'weekly']}
Daily chore with points: {name: 'Exercise', frequency_type: 'daily', time_of_day: '07:00', points: 10, usernames: ['Bob']}
One-time chore: {name: 'Fix leaky faucet', due_date: '2025-11-10', priority: 5, usernames: ['Alice']}
Returns the created chore with its assigned ID and all metadata.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Chore name (required, 1-200 characters) | |
| description | No | Chore description (optional, max 5000 characters) | |
| due_date | No | Due date in YYYY-MM-DD or RFC3339 format (optional) | |
| created_by | No | User ID of the creator (optional) | |
| frequency_type | No | How often the chore repeats (default: once). FREQUENCY TYPES: • once / no_repeat: One-time chore, no recurrence • daily: Repeats every day at specified time • weekly: Repeats every week (use with frequency for bi-weekly: frequency=2) • days_of_the_week: Specific days (Mon, Wed, Fri) - BEST for multiple days/week → Use with days_of_week parameter: ['Mon', 'Wed', 'Fri'] • monthly: Repeats every month • yearly: Repeats every year • day_of_the_month: Specific day of month (e.g., 15th of each month) • interval_based / interval: Custom interval (e.g., every N days) • adaptive: Smart scheduling based on completion patterns • trigger: Triggered by events or conditions TIP: For chores on specific days (Mon/Wed/Fri), use frequency_type='days_of_the_week' with days_of_week=['Mon', 'Wed', 'Fri'] instead of frequency_type='weekly' | |
| frequency | No | Frequency multiplier (e.g., 1=weekly, 2=biweekly, default: 1) | |
| frequency_metadata | No | Additional frequency config (e.g., {"days": [1,3,5], "time": "09:00"}) | |
| is_rolling | No | Rolling schedule (next due based on completion) vs fixed (default: false) | |
| assigned_to | No | Primary assigned user ID (optional) | |
| assignees | No | Multiple assignees as array of {"userId": int} objects | |
| assign_strategy | No | Assignment strategy: least_completed, least_assigned, round_robin, random, keep_last_assigned, random_except_last_assigned, no_assignee (default: least_completed) | |
| notification | No | Enable notifications for this chore (default: false) | |
| nagging | No | Enable nagging/reminder notifications (default: false) | |
| predue | No | Enable pre-due date notifications (default: false) | |
| priority | No | Priority level: 0=unset, 1=lowest, 2=low, 3=medium, 4=highest (optional) | |
| labels | No | Label tags for categorization (e.g., ["cleaning", "outdoor"]) | |
| is_active | No | Active status - inactive chores are hidden (default: true) | |
| is_private | No | Private chore visible only to creator (default: false) | |
| points | No | Points awarded for completion (optional) | |
| sub_tasks | No | Sub-tasks/checklist items (optional) | |
| usernames | No | EASY: Assign by usernames instead of IDs (e.g., ['Alice', 'Bob']). First user becomes primary assignee. | |
| label_names | No | EASY: Label by names instead of IDs (e.g., ['cleaning', 'urgent']) | |
| days_of_week | No | EASY: Days as short names (e.g., ['Mon', 'Wed', 'Fri'] or ['monday', 'wednesday']). Auto-sets frequency_type to days_of_the_week. REQUIRED when frequency_type='days_of_the_week'. Valid values: Mon/Monday, Tue/Tuesday, Wed/Wednesday, Thu/Thursday, Fri/Friday, Sat/Saturday, Sun/Sunday | |
| time_of_day | No | EASY: Time in HH:MM format (e.g., '16:00' for 4pm) | |
| timezone | No | Timezone name (default: America/New_York). Used with days_of_week and time_of_day. | |
| remind_minutes_before | No | EASY: Remind X minutes before due time (e.g., 15 for 15 minutes before) | |
| remind_at_due_time | No | EASY: Also remind exactly at due time (default: false) | |
| enable_nagging | No | EASY: Enable nagging notifications - repeated reminders if not completed (default: false) | |
| enable_predue | No | EASY: Enable pre-due notifications - reminders before due date arrives (default: false) | |
| subtask_names | No | EASY: Subtask names as simple strings (e.g., ['Do homework', 'Check work']) |