Skip to content
/
Assign Project to Viewer

WebWork Time Tracker API V2 Documentation (2.0.0)

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

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

Project Viewers

Manage project viewers - external users who can view specific projects

Operations

Get All Project Viewers

Request

Retrieve all project viewers for a specific workspace. Requires workspace_id as query parameter.

Security
oauth2(Required scopes:
read
) or apiKey
Query
workspace_idintegerrequired
Example: workspace_id=1
curl -i -X GET \
  'https://api.webwork-tracker.com/api/v2/project-viewers?workspace_id=1' \
  -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 Project Viewer

Request

Security
oauth2(Required scopes:
write
) or apiKey
Bodyapplication/jsonrequired
workspace_idintegerrequired
emailstring(email)
firstnamestring
lastnamestring
curl -i -X POST \
  https://api.webwork-tracker.com/api/v2/project-viewers \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "workspace_id": 0,
    "email": "user@example.com",
    "firstname": "string",
    "lastname": "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 Project Viewer

Request

Security
oauth2(Required scopes:
read
) or apiKey
Path
viewerIdstringrequired
Query
workspace_idintegerrequired
curl -i -X GET \
  'https://api.webwork-tracker.com/api/v2/project-viewers/{viewerId}?workspace_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"
  }
}

Delete Project Viewer

Request

Security
oauth2(Required scopes:
write
) or apiKey
Path
viewerIdstringrequired
Bodyapplication/jsonrequired
workspace_idintegerrequired
curl -i -X DELETE \
  'https://api.webwork-tracker.com/api/v2/project-viewers/{viewerId}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "workspace_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"
  }
}

Restore Project Viewer

Request

Security
oauth2(Required scopes:
write
) or apiKey
Path
viewerIdstringrequired
Bodyapplication/jsonrequired
workspace_idintegerrequired
curl -i -X POST \
  'https://api.webwork-tracker.com/api/v2/project-viewers/{viewerId}/restore' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "workspace_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"
  }
}

Assign Project to Viewer

Request

Security
oauth2(Required scopes:
write
) or apiKey
Path
viewerIdstringrequired
Bodyapplication/jsonrequired
workspace_idintegerrequired
project_idintegerrequired
curl -i -X POST \
  'https://api.webwork-tracker.com/api/v2/project-viewers/{viewerId}/assign-project' \
  -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"
  }
}

Unassign Project from Viewer

Request

Security
oauth2(Required scopes:
write
) or apiKey
Path
viewerIdstringrequired
Bodyapplication/jsonrequired
workspace_idintegerrequired
project_idintegerrequired
curl -i -X DELETE \
  'https://api.webwork-tracker.com/api/v2/project-viewers/{viewerId}/unassign-project' \
  -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"
  }
}

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

Start, stop, and monitor real-time tracking

Operations

Time Entries

Manage time entries - create, read, update, and delete time records

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