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.

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

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

Get All Webhooks

Request

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

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

Responses

Request successful

Bodyapplication/json
successboolean
Example: true
dataArray of objects
Example: [{"id":"encoded_id_string","events":["tracker.started","member.invited","project.created","task.updated"],"url":"https://example.com/webhook","token":"encoded_string"}]
metaobject
Response
application/json
{
  "success": true,
  "data": [
    { … }
  ],
  "meta": {
    "api_version": "2.0.0",
    "timestamp": "2019-08-24T14:15:22Z",
    "pagination": { … }
  }
}

Create Webhook

Request

Security
oauth2 or apiKey
Bodyapplication/jsonrequired
workspace_idintegerrequired
urlstring(uri)required
eventsArray of strings

Array of event types to subscribe to. You can subscribe to one or more events.

Items Enum"tracker.started""tracker.stopped""member.invited""member.updated""member.deleted""member.activated""member.archived""project.created""project.updated""project.deleted"
Example: ["tracker.started","member.invited","project.created"]
curl -i -X POST \
  https://api.webwork-tracker.com/api/v2/webhooks \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "workspace_id": 0,
    "url": "http://example.com",
    "events": [
      "tracker.started",
      "member.invited",
      "project.created"
    ]
  }'

Responses

Resource created successfully

Bodyapplication/json
successboolean
Example: true
dataobject
Example: {"id":"encoded_id_string","events":["tracker.started","member.invited","project.created","task.updated"],"url":"https://example.com/webhook","token":"encoded_string"}
metaobject(Meta)
Response
application/json
{
  "success": true,
  "data": {
    "id": "encoded_id_string",
    "events": [ … ],
    "url": "https://example.com/webhook",
    "token": "encoded_string"
  },
  "meta": {
    "api_version": "2.0.0",
    "timestamp": "2019-08-24T14:15:22Z"
  }
}

Get Webhook

Request

Security
oauth2 or apiKey
Path
webhookIdstringrequired
Query
workspace_idintegerrequired
curl -i -X GET \
  'https://api.webwork-tracker.com/api/v2/webhooks/{webhookId}?workspace_id=0' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Request successful

Bodyapplication/json
successboolean
Example: true
dataobject
Example: {"id":"encoded_id_string","events":["tracker.started","member.invited","project.created","task.updated"],"url":"https://example.com/webhook","token":"encoded_string"}
metaobject(Meta)
Response
application/json
{
  "success": true,
  "data": {
    "id": "encoded_id_string",
    "events": [ … ],
    "url": "https://example.com/webhook",
    "token": "encoded_string"
  },
  "meta": {
    "api_version": "2.0.0",
    "timestamp": "2019-08-24T14:15:22Z"
  }
}

Update Webhook

Request

Security
oauth2 or apiKey
Path
webhookIdstringrequired
Bodyapplication/jsonrequired
workspace_idintegerrequired
urlstring(uri)
eventsArray of strings

Array of event types to subscribe to. You can subscribe to one or more events.

Items Enum"tracker.started""tracker.stopped""member.invited""member.updated""member.deleted""member.activated""member.archived""project.created""project.updated""project.deleted"
Example: ["tracker.started","member.invited","project.created"]
curl -i -X PUT \
  'https://api.webwork-tracker.com/api/v2/webhooks/{webhookId}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "workspace_id": 0,
    "url": "http://example.com",
    "events": [
      "tracker.started",
      "member.invited",
      "project.created"
    ]
  }'

Responses

Request successful

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

Delete Webhook

Request

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

Responses

Request successful

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