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"

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)