tududi

name	tududi
description	Manage tasks, projects, and notes in tududi (self-hosted task manager). Use for todo lists, task management, project organization.

tududi Task Management

Configuration

Uses environment variables (set in openclaw.json under skills.entries.tududi.env):

• TUDUDI_URL - Base URL (e.g., http://localhost:3004)
• TUDUDI_API_TOKEN - API token from tududi Settings → API Tokens

Authentication

All API calls require the header:

Authorization: Bearer $TUDUDI_API_TOKEN

API Route Convention

• Plural nouns (/tasks, /projects, /inbox) for GET (list)
• Singular nouns (/task, /project) for POST/PUT/DELETE (create/update/delete)
• Use UID (not numeric ID) for update/delete operations

Common Operations

List tasks

curl -s $TUDUDI_URL/api/v1/tasks \
  -H "Authorization: Bearer $TUDUDI_API_TOKEN"

Create a task

curl -s -X POST $TUDUDI_URL/api/v1/task \
  -H "Authorization: Bearer $TUDUDI_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Task title", "due_date": "2026-02-10", "priority": 2, "project_id": 1, "tags": [{"name": "bug"}]}'

Priority: 1 (low) to 4 (urgent) Tags: [{"name": "tagname"}, ...]

Update a task

curl -s -X PATCH $TUDUDI_URL/api/v1/task/{uid} \
  -H "Authorization: Bearer $TUDUDI_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"status": 1, "tags": [{"name": "bug"}]}'

Status: 0=not_started, 1=in_progress, 2=completed, 6=archived Tags: [{"name": "tagname"}, ...]

Delete a task

curl -s -X DELETE $TUDUDI_URL/api/v1/task/{uid} \
  -H "Authorization: Bearer $TUDUDI_API_TOKEN"

List projects

curl -s $TUDUDI_URL/api/v1/projects \
  -H "Authorization: Bearer $TUDUDI_API_TOKEN"

Create project

curl -s -X POST $TUDUDI_URL/api/v1/project \
  -H "Authorization: Bearer $TUDUDI_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Project name"}'

Inbox

# List inbox items
curl -s $TUDUDI_URL/api/v1/inbox \
  -H "Authorization: Bearer $TUDUDI_API_TOKEN"

# Delete inbox item (use UID)
curl -s -X DELETE $TUDUDI_URL/api/v1/inbox/{uid} \
  -H "Authorization: Bearer $TUDUDI_API_TOKEN"

Tags

curl -s $TUDUDI_URL/api/v1/tags \
  -H "Authorization: Bearer $TUDUDI_API_TOKEN"

Task Statuses

• not_started
• in_progress
• completed
• archived

Filters

• $TUDUDI_URL/api/v1/tasks?filter=today - Due today
• $TUDUDI_URL/api/v1/tasks?filter=upcoming - Future tasks
• $TUDUDI_URL/api/v1/tasks?filter=someday - No due date
• $TUDUDI_URL/api/v1/tasks?project_id={id} - By project

API Docs

Swagger UI available at $TUDUDI_URL/swagger (requires login)