openclaw-backups/archive/inactive-skills/api-gateway/references/toggl-track.md

Toggl Track Routing Reference

App name: toggl-track Base URL proxied: api.track.toggl.com

API Path Pattern

/toggl-track/api/v9/{resource}

Common Endpoints

Get Current User

GET /toggl-track/api/v9/me

List Workspaces

GET /toggl-track/api/v9/me/workspaces

Get Workspace

GET /toggl-track/api/v9/workspaces/{workspace_id}

List Workspace Users

GET /toggl-track/api/v9/workspaces/{workspace_id}/users

List Time Entries

GET /toggl-track/api/v9/me/time_entries
GET /toggl-track/api/v9/me/time_entries?start_date=2026-02-01&end_date=2026-02-28

Get Current Time Entry

GET /toggl-track/api/v9/me/time_entries/current

Create Time Entry

POST /toggl-track/api/v9/workspaces/{workspace_id}/time_entries
Content-Type: application/json

{
  "description": "Working on task",
  "start": "2026-02-13T10:00:00Z",
  "duration": -1,
  "workspace_id": 21180405,
  "created_with": "maton-api"
}

Stop Time Entry

PATCH /toggl-track/api/v9/workspaces/{workspace_id}/time_entries/{time_entry_id}/stop

Update Time Entry

PUT /toggl-track/api/v9/workspaces/{workspace_id}/time_entries/{time_entry_id}
Content-Type: application/json

{
  "description": "Updated description"
}

Delete Time Entry

DELETE /toggl-track/api/v9/workspaces/{workspace_id}/time_entries/{time_entry_id}

List Projects

GET /toggl-track/api/v9/workspaces/{workspace_id}/projects
GET /toggl-track/api/v9/workspaces/{workspace_id}/projects?active=true

Create Project

POST /toggl-track/api/v9/workspaces/{workspace_id}/projects
Content-Type: application/json

{
  "name": "New Project",
  "active": true,
  "color": "#0b83d9"
}

Update Project

PUT /toggl-track/api/v9/workspaces/{workspace_id}/projects/{project_id}
Content-Type: application/json

{
  "name": "Updated Project"
}

Delete Project

DELETE /toggl-track/api/v9/workspaces/{workspace_id}/projects/{project_id}

List Clients

GET /toggl-track/api/v9/workspaces/{workspace_id}/clients

Create Client

POST /toggl-track/api/v9/workspaces/{workspace_id}/clients
Content-Type: application/json

{
  "name": "New Client"
}

Update Client

PUT /toggl-track/api/v9/workspaces/{workspace_id}/clients/{client_id}
Content-Type: application/json

{
  "name": "Updated Client"
}

Delete Client

DELETE /toggl-track/api/v9/workspaces/{workspace_id}/clients/{client_id}

List Tags

GET /toggl-track/api/v9/workspaces/{workspace_id}/tags

Create Tag

POST /toggl-track/api/v9/workspaces/{workspace_id}/tags
Content-Type: application/json

{
  "name": "New Tag"
}

Update Tag

PUT /toggl-track/api/v9/workspaces/{workspace_id}/tags/{tag_id}
Content-Type: application/json

{
  "name": "Updated Tag"
}

Delete Tag

DELETE /toggl-track/api/v9/workspaces/{workspace_id}/tags/{tag_id}

Notes

• Workspace IDs and time entry IDs are integers
• Duration is in seconds; use -1 to start a running timer
• Timestamps use ISO 8601 format (e.g., 2026-02-13T19:58:43Z)
• The created_with field is required when creating time entries
• Pagination uses page and per_page query parameters
• Time entries list supports since, start_date, and end_date filters

Resources

• Toggl Track API Documentation
• Time Entries API
• Projects API
• Clients API
• Tags API