Skip to content

WebWork Tracker REST API V2 (2.0.0)

Modern REST API for WebWork Tracker with OAuth2 authentication. This API provides access to workspaces, members, projects, and time tracking features.

Languages
Servers
Production Server
https://api.webwork-tracker.com/api/v2/

Workspaces

Read workspace information for the authenticated user for using it in the other endpoints

Operations

Members

Manage workspace members - invite, update roles, and remove members

Operations

Projects

Manage projects within workspaces

Operations

Contracts

Manage contracts (project-member assignments) within workspaces. Contracts define which members are assigned to which projects, with settings for rates, hours limits, and screenshot modes. Rate information is only visible if you have permission to view rates and the project is billable.

Operations

Tasks

Manage tasks within projects

Operations

Get All Tasks

Request

Retrieve all tasks for a specific workspace and project. Requires workspace_id and project_id as query parameters.

Security
oauth2 or apiKey
Query
workspace_idintegerrequired
Example: workspace_id=1
project_idintegerrequired
Example: project_id=100
curl -i -X GET \
  'https://api.webwork-tracker.com/api/v2/tasks?workspace_id=1&project_id=100' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Request successful

Bodyapplication/json
successboolean
Example: true
dataobject
messagestring
metaobject(Meta)
Response
application/json
{ "success": true, "data": {}, "message": "string", "meta": { "api_version": "2.0.0", "timestamp": "2019-08-24T14:15:22Z" } }

Create Task

Request

Security
oauth2 or apiKey
Bodyapplication/jsonrequired
workspace_idintegerrequired
project_idintegerrequired
titlestringrequired
curl -i -X POST \
  https://api.webwork-tracker.com/api/v2/tasks \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "workspace_id": 0,
    "project_id": 0,
    "title": "string"
  }'

Responses

Resource created successfully

Bodyapplication/json
successboolean
Example: true
dataobject
messagestring
metaobject(Meta)
Response
application/json
{ "success": true, "data": {}, "message": "string", "meta": { "api_version": "2.0.0", "timestamp": "2019-08-24T14:15:22Z" } }

Get Task

Request

Security
oauth2 or apiKey
Path
taskIdstringrequired
Query
workspace_idintegerrequired
project_idintegerrequired
curl -i -X GET \
  'https://api.webwork-tracker.com/api/v2/tasks/{taskId}?workspace_id=0&project_id=0' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Request successful

Bodyapplication/json
successboolean
Example: true
dataobject
messagestring
metaobject(Meta)
Response
application/json
{ "success": true, "data": {}, "message": "string", "meta": { "api_version": "2.0.0", "timestamp": "2019-08-24T14:15:22Z" } }

Update Task

Request

Security
oauth2 or apiKey
Path
taskIdstringrequired
Bodyapplication/jsonrequired
workspace_idintegerrequired
project_idintegerrequired
titlestring
curl -i -X PUT \
  'https://api.webwork-tracker.com/api/v2/tasks/{taskId}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "workspace_id": 0,
    "project_id": 0,
    "title": "string"
  }'

Responses

Request successful

Bodyapplication/json
successboolean
Example: true
dataobject
messagestring
metaobject(Meta)
Response
application/json
{ "success": true, "data": {}, "message": "string", "meta": { "api_version": "2.0.0", "timestamp": "2019-08-24T14:15:22Z" } }

Delete Task

Request

Security
oauth2 or apiKey
Path
taskIdstringrequired
Bodyapplication/jsonrequired
workspace_idintegerrequired
project_idintegerrequired
curl -i -X DELETE \
  'https://api.webwork-tracker.com/api/v2/tasks/{taskId}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "workspace_id": 0,
    "project_id": 0
  }'

Responses

Request successful

Bodyapplication/json
successboolean
Example: true
dataobject
messagestring
metaobject(Meta)
Response
application/json
{ "success": true, "data": {}, "message": "string", "meta": { "api_version": "2.0.0", "timestamp": "2019-08-24T14:15:22Z" } }

Get Task Assignees

Request

Security
oauth2 or apiKey
Path
taskIdstringrequired
Query
workspace_idintegerrequired
project_idintegerrequired
curl -i -X GET \
  'https://api.webwork-tracker.com/api/v2/tasks/{taskId}/assignees?workspace_id=0&project_id=0' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Request successful

Bodyapplication/json
successboolean
Example: true
dataobject
messagestring
metaobject(Meta)
Response
application/json
{ "success": true, "data": {}, "message": "string", "meta": { "api_version": "2.0.0", "timestamp": "2019-08-24T14:15:22Z" } }

Assign User to Task

Request

Security
oauth2 or apiKey
Path
taskIdstringrequired
userIdintegerrequired
Query
workspace_idintegerrequired
project_idintegerrequired
curl -i -X POST \
  'https://api.webwork-tracker.com/api/v2/tasks/{taskId}/assign/{userId}?workspace_id=0&project_id=0' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Request successful

Bodyapplication/json
successboolean
Example: true
dataobject
messagestring
metaobject(Meta)
Response
application/json
{ "success": true, "data": {}, "message": "string", "meta": { "api_version": "2.0.0", "timestamp": "2019-08-24T14:15:22Z" } }

Unassign User from Task

Request

Security
oauth2 or apiKey
Path
taskIdstringrequired
userIdintegerrequired
Query
workspace_idintegerrequired
project_idintegerrequired
curl -i -X DELETE \
  'https://api.webwork-tracker.com/api/v2/tasks/{taskId}/unassign/{userId}?workspace_id=0&project_id=0' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Request successful

Bodyapplication/json
successboolean
Example: true
dataobject
messagestring
metaobject(Meta)
Response
application/json
{ "success": true, "data": {}, "message": "string", "meta": { "api_version": "2.0.0", "timestamp": "2019-08-24T14:15:22Z" } }

Project Viewers

Manage project viewers - external users who can view specific projects

Operations

Timesheets

Manage timesheet approvals and submissions

Operations

Time Requests

Manage manual time requests and approvals

Operations

Leaves

Manage leave requests, balances, and policies

Operations

Expenses

Manage expenses and expense categories

Operations

Time Tracking

Track and manage time entries

Operations

Reports

Generate and retrieve various reports including tracked hours, timeline, activity descriptions, tasks, and activity level reports

Operations

Webhooks

Manage webhooks for event notifications

Operations