Skip to main content
Worksnaps logo
  • Category: time tracking software
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 14
  • Triggers: 0
  • Slug: WORKSNAPS
  • Version: 20261101_00

Tools

Slug: WORKSNAPS_CREATE_PROJECTCreates a new project in Worksnaps for tracking time and tasks. Use this tool when you need to set up a new project for time tracking. Projects serve as containers for tasks and time entries. Each project must have a unique name within the account. Note: Account plan limits may restrict the number of projects that can be created.

Input Parameters

string
required
Name of the project. Must be unique within the account.
string
Description of the project explaining its purpose and scope.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WORKSNAPS_CREATE_TASKTool to create a new task in a specified project. Use after confirming project ID exists.

Input Parameters

string
required
Name of the task
integer
ID of the user to assign the task
string
Due date in YYYY-MM-DD format
integer
required
ID of the project to create the task in
string
Brief description of the task

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WORKSNAPS_DELETE_TASKPermanently deletes a task from a Worksnaps project. This action is destructive and cannot be undone. Use GET_TASKS first to find the task_id, and GET_PROJECTS to find the project_id. Returns success=true if the task was deleted. Returns 404 error if project or task does not exist.

Input Parameters

integer
required
The unique ID of the task to delete. Can be obtained from GET_TASKS or CREATE_TASK actions.
integer
required
The unique ID of the Worksnaps project that contains the task. Can be obtained from GET_PROJECTS or GET_PROJECT_DETAILS actions.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WORKSNAPS_GET_PROJECT_DETAILSTool to retrieve details of a specific project. Use when you have a project_id and need its details.

Input Parameters

integer
required
ID of the project to retrieve. Must be a positive integer.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WORKSNAPS_GET_PROJECT_REPORTRetrieves individual Worksnaps time entries for a project and timestamp range, with the total duration in minutes. Optionally filter by user IDs, task IDs, or online versus offline entries. Timestamps must be Unix seconds at 10-minute interval boundaries; a bad request can also return an empty report.

Input Parameters

string
Optional semicolon-separated list of task IDs to filter time entries (e.g., ‘100;200’).
string
Optional semicolon-separated list of user IDs to filter time entries (e.g., ‘123;456’). If not provided, returns entries for all users in the project.
integer
required
ID of the project to retrieve time entries for.
integer
required
End of the time range as a Unix timestamp (seconds since epoch). Must be at a 10-minute interval boundary and after from_timestamp.
integer
required
Start of the time range as a Unix timestamp (seconds since epoch). Must be at a 10-minute interval boundary.
string
Optional filter by time entry type. Use ‘online’ for tracked time with screenshots or ‘offline’ for manual entries.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WORKSNAPS_GET_PROJECTSTool to retrieve a paginated list of projects. Use after authenticating to list accessible projects.

Input Parameters

integer
Page number for pagination (>=1)
integer
Number of projects per page (1-100)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WORKSNAPS_GET_TASK_DETAILSTool to retrieve details of a specific task within a project. Use after confirming project_id and task_id.

Input Parameters

integer
required
The unique identifier of the task to retrieve
integer
required
The unique identifier of the project containing the task

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WORKSNAPS_GET_TASKSTool to retrieve tasks for a specific project. Use when you have a project ID and need its tasks. Example: ‘Get tasks for project 42’.

Input Parameters

integer
Page number for pagination (optional, default=1)
string ("open" | "closed")
Filter tasks by status: ‘open’ or ‘closed’ (optional)
integer
Filter tasks by user ID (optional)
integer
Number of tasks per page (optional, default=50)
integer
required
ID of the project to retrieve tasks for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WORKSNAPS_GET_USER_ACCOUNTTool to retrieve information about a specific user account. Use after confirming the user_id.

Input Parameters

integer
required
The unique identifier of the user to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WORKSNAPS_GET_USER_ASSIGNMENTSTool to retrieve a list of all user assignments for a specific project. Returns details about users assigned to the project including their roles, permissions, and contact information.

Input Parameters

integer
required
ID of the project to retrieve assignments for

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WORKSNAPS_GET_USERSRetrieves a list of all users in the Worksnaps account. Returns user details including id, login, name, email, time zone, and active status. Use this to get user IDs for other user-related operations.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WORKSNAPS_PUT_UPDATE_PROJECTTool to update an existing project. Use when you have project_id and fields to modify.

Input Parameters

string
New project name (optional)
string ("active" | "archived")
Project status: ‘active’ or ‘archived’ (optional)
string
Project end date YYYY-MM-DD (optional)
integer
New client ID (optional)
integer
required
ID of the project to update
string
Project start date YYYY-MM-DD (optional)
string
New project description (optional)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WORKSNAPS_PUT_UPDATE_TASKTool to update details of an existing task. Use when you have project_id, task_id, and fields to update.

Input Parameters

string
New task name (optional)
string ("open" | "closed")
New task status: ‘open’ or ‘closed’. Note: Must be combined with ‘name’ or ‘description’ update.
integer
required
ID of the task to update
string
New due date in YYYY-MM-DD format. Note: Must be combined with ‘name’ or ‘description’ update.
integer
required
ID of the project containing the task
string
New task description (optional)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WORKSNAPS_PUT_UPDATE_USER_ACCOUNTTool to update information for a specific user account. Use when modifying user details after confirming the user exists. Note: This can only be done by the user himself or by a trusted partner using partner’s API token.

Input Parameters

string
New email address for the user
integer
required
ID of the user account to be updated
string
New password for the user
string
New last name for the user
string
New first name for the user
integer
Timezone ID for the user (integer ID representing the timezone)
string
Confirmation of the new password (required when setting password)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not