Skip to content

WebWork Tracker REST API V2 (2.0.0)

WebWork Tracker REST API V2 provides programmatic access to your workspace data. This API allows you to manage members, projects, tasks, time tracking, leaves, and expenses. Access is restricted to workspace owners and executive managers only.

Overview
URL
https://support.webwork-tracker.com/
API Support
api-support@webwork-tracker.com
Terms of Service
Languages
Servers
API 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

Tasks

Manage tasks within projects. As a workspace owner or executive manager, you have full access to all tasks in your workspace.

Operations

Project Viewers

Manage project viewers (clients) within workspaces. Project viewers are users with read-only access to specific projects. Project viewers can only view projects they are assigned to.

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.

Operations

Time Tracking

Track and manage time entries

Operations

Timesheets

Manage timesheet approvals - view, approve, reject, submit, and unsubmit timesheets.

Operations

Get All Timesheets

Request

Retrieve all timesheets in your workspace. Supports filtering by status (open, submitted, rejected, approved), date range, and ID. Results are paginated.

Security
oauth2 or apiKey
Query
workspace_idintegerrequired

ID of the workspace

Example: workspace_id=1
idstring(uuid)

UUID of the timesheet

Example: id=a1b2c3d4-e5f6-7890-abcd-ef1234567890
statusstring

Filter by timesheet status

Enum"open""submitted""rejected""approved"
Example: status=submitted
date_fromstring(date)

Filter timesheets from this date (YYYY-MM-DD)

Example: date_from=2024-01-01
date_tostring(date)

Filter timesheets to this date (YYYY-MM-DD)

Example: date_to=2024-01-31
pageinteger>= 1

Page number for pagination

Default 1
Example: page=1
per_pageinteger[ 1 .. 100 ]

Number of items per page (max 100)

Default 20
Example: per_page=20
curl -i -X GET \
  'https://api.webwork-tracker.com/api/v2/timesheets?workspace_id=1' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Timesheets retrieved successfully

Bodyapplication/json
successboolean
Example: true
dataArray of objects(Timesheet)
metaobject(Meta)
Response
application/json
{
  "success": true,
  "data": [
    { … }
  ],
  "meta": {
    "api_version": "2.0.0",
    "timestamp": "2019-08-24T14:15:22Z"
  }
}

Approve Timesheet

Request

Approve a submitted timesheet. Only Owners and Executive Managers can approve timesheets. The timesheet must be in 'submitted' status.

Security
oauth2 or apiKey
Path
timesheetIdstring(uuid)required

UUID of the timesheet

Example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
Bodyapplication/jsonrequired
workspace_idintegerrequired

ID of the workspace (Team.id from owner_user_rel table)

Example: 1
curl -i -X PUT \
  https://api.webwork-tracker.com/api/v2/timesheets/a1b2c3d4-e5f6-7890-abcd-ef1234567890/approve \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "workspace_id": 1
  }'

Responses

Timesheet approved successfully

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

Reject Timesheet

Request

Reject a submitted timesheet with a reason. Only Owners and Executive Managers can reject timesheets. The timesheet must be in 'submitted' status.

Security
oauth2 or apiKey
Path
timesheetIdstring(uuid)required

UUID of the timesheet

Example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
Bodyapplication/jsonrequired
workspace_idintegerrequired

ID of the workspace (Team.id from owner_user_rel table)

Example: 1
reasonstringrequired

Reason for rejecting the timesheet

Example: "Hours do not match project requirements"
curl -i -X PUT \
  https://api.webwork-tracker.com/api/v2/timesheets/a1b2c3d4-e5f6-7890-abcd-ef1234567890/reject \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "workspace_id": 1,
    "reason": "Hours do not match project requirements"
  }'

Responses

Timesheet rejected successfully

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

Submit Timesheet

Request

Submit a timesheet for approval. The timesheet must be in 'open' status.

Security
oauth2 or apiKey
Path
timesheetIdstring(uuid)required

UUID of the timesheet

Example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
Bodyapplication/jsonrequired
workspace_idintegerrequired

ID of the workspace (Team.id from owner_user_rel table)

Example: 1
curl -i -X PUT \
  https://api.webwork-tracker.com/api/v2/timesheets/a1b2c3d4-e5f6-7890-abcd-ef1234567890/submit \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "workspace_id": 1
  }'

Responses

Timesheet submitted successfully

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

Unsubmit Timesheet

Request

Unsubmit a timesheet, returning it to 'open' status. The timesheet must be in 'submitted' status.

Security
oauth2 or apiKey
Path
timesheetIdstring(uuid)required

UUID of the timesheet

Example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
Bodyapplication/jsonrequired
workspace_idintegerrequired

ID of the workspace (Team.id from owner_user_rel table)

Example: 1
curl -i -X PUT \
  https://api.webwork-tracker.com/api/v2/timesheets/a1b2c3d4-e5f6-7890-abcd-ef1234567890/unsubmit \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "workspace_id": 1
  }'

Responses

Timesheet unsubmitted successfully

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

Time Requests

Manage manual time requests - create time requests for team members, approve or reject pending requests.

Operations

Leaves

Manage leave requests - view, approve, reject leave requests, view leave balances and policies.

Operations

Expenses

Manage expenses - create, update, delete expenses and view expense categories.

Operations

Reports

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

Operations

Webhooks

Manage webhooks - register callback URLs to receive real-time event notifications from the platform.

Operations