
Worksnaps
worksnapsWorksnaps is a time-tracking service designed for remote work that offers detailed project and user activity insights.
Acciones disponibles (14)
Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.
Create ProjectWORKSNAPS_CREATE_PROJECTAcciónTool to create a new project in worksnaps. use after gathering project details before logging time.
WORKSNAPS_CREATE_PROJECTAcciónTool to create a new project in worksnaps. use after gathering project details before logging time.
Parámetros de entrada
namestringObligatorioName of the project
budgetnumberBudget of the project
statusstringStatus of the project (e.g., 'Active')
end_datestringEnd date/time of the project in ISO8601 format
client_idintegerID of the client associated with the project
start_datestringStart date/time of the project in ISO8601 format
descriptionstringDescription of the project
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create taskWORKSNAPS_CREATE_TASKAcciónTool to create a new task in a specified project. use after confirming project id exists.
WORKSNAPS_CREATE_TASKAcciónTool to create a new task in a specified project. use after confirming project id exists.
Parámetros de entrada
namestringObligatorioName of the task
due_datestringDue date in YYYY-MM-DD format
project_idintegerObligatorioID of the project to create the task in
assigned_tointegerID of the user to assign the task
descriptionstringBrief description of the task
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete TaskWORKSNAPS_DELETE_TASKAcciónTool to delete a task from a project. use when you need to remove a task by its id after confirming the project context.
WORKSNAPS_DELETE_TASKAcciónTool to delete a task from a project. use when you need to remove a task by its id after confirming the project context.
Parámetros de entrada
task_idintegerObligatorioThe ID of the task to delete
project_idintegerObligatorioThe ID of the project containing the task
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Project DetailsWORKSNAPS_GET_PROJECT_DETAILSAcciónTool to retrieve details of a specific project. use when you have a project id and need its details.
WORKSNAPS_GET_PROJECT_DETAILSAcciónTool to retrieve details of a specific project. use when you have a project id and need its details.
Parámetros de entrada
project_idintegerObligatorioID of the project to retrieve. Must be a positive integer.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Project ReportWORKSNAPS_GET_PROJECT_REPORTAcciónTool to retrieve a project's time tracking report. use when you need summary of logged time per day for a project within an optional date range.
WORKSNAPS_GET_PROJECT_REPORTAcciónTool to retrieve a project's time tracking report. use when you need summary of logged time per day for a project within an optional date range.
Parámetros de entrada
to_dateanydateEnd date for the report in YYYY-MM-DD format
user_idintegerOptional user ID to filter the report
from_dateanydateStart date for the report in YYYY-MM-DD format
project_idintegerObligatorioID of the project to retrieve the report for
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get ProjectsWORKSNAPS_GET_PROJECTSAcciónTool to retrieve a paginated list of projects. use after authenticating to list accessible projects.
WORKSNAPS_GET_PROJECTSAcciónTool to retrieve a paginated list of projects. use after authenticating to list accessible projects.
Parámetros de entrada
pageintegerPage number for pagination (>=1)
per_pageintegerNumber of projects per page (1-100)
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Task DetailsWORKSNAPS_GET_TASK_DETAILSAcciónTool to retrieve details of a specific task within a project. use after confirming project id and task id.
WORKSNAPS_GET_TASK_DETAILSAcciónTool to retrieve details of a specific task within a project. use after confirming project id and task id.
Parámetros de entrada
task_idintegerObligatorioThe unique identifier of the task to retrieve
project_idintegerObligatorioThe unique identifier of the project containing the task
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Project TasksWORKSNAPS_GET_TASKSAcciónTool to retrieve tasks for a specific project. use when you have a project id and need its tasks. example: 'get tasks for project 42'.
WORKSNAPS_GET_TASKSAcciónTool to retrieve tasks for a specific project. use when you have a project id and need its tasks. example: 'get tasks for project 42'.
Parámetros de entrada
pageintegerPage number for pagination (optional, default=1)
statusstringenumFilter tasks by status: 'open' or 'closed' (optional)
opencloseduser_idintegerFilter tasks by user ID (optional)
per_pageintegerNumber of tasks per page (optional, default=50)
project_idintegerObligatorioID of the project to retrieve tasks for
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get User AccountWORKSNAPS_GET_USER_ACCOUNTAcciónTool to retrieve information about a specific user account. use after confirming the user id.
WORKSNAPS_GET_USER_ACCOUNTAcciónTool to retrieve information about a specific user account. use after confirming the user id.
Parámetros de entrada
user_idintegerObligatorioThe unique identifier of the user to retrieve
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get User AssignmentsWORKSNAPS_GET_USER_ASSIGNMENTSAcciónTool to retrieve a list of all user assignments for the authenticated user. use after authenticating to see which projects you're assigned to.
WORKSNAPS_GET_USER_ASSIGNMENTSAcciónTool to retrieve a list of all user assignments for the authenticated user. use after authenticating to see which projects you're assigned to.
Parámetros de entrada
project_idintegerObligatorioID of the project to retrieve assignments for
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get UsersWORKSNAPS_GET_USERSAcciónTool to retrieve a list of all users. use when you need to fetch all users in the worksnaps account.
WORKSNAPS_GET_USERSAcciónTool to retrieve a list of all users. use when you need to fetch all users in the worksnaps account.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Update ProjectWORKSNAPS_PUT_UPDATE_PROJECTAcciónTool to update an existing project. use when you have project id and fields to modify.
WORKSNAPS_PUT_UPDATE_PROJECTAcciónTool to update an existing project. use when you have project id and fields to modify.
Parámetros de entrada
namestringNew project name (optional)
statusstringenumProject status: 'active' or 'archived' (optional)
activearchivedend_datestringProject end date YYYY-MM-DD (optional)
client_idintegerNew client ID (optional)
project_idintegerObligatorioID of the project to update
start_datestringProject start date YYYY-MM-DD (optional)
descriptionstringNew project description (optional)
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Update TaskWORKSNAPS_PUT_UPDATE_TASKAcciónTool to update details of an existing task. use when you have project id, task id, and fields to update.
WORKSNAPS_PUT_UPDATE_TASKAcciónTool to update details of an existing task. use when you have project id, task id, and fields to update.
Parámetros de entrada
namestringNew task name (optional)
statusstringenumNew task status: 'open' or 'closed' (optional)
openclosedtask_idintegerObligatorioID of the task to update
due_datestringNew due date in YYYY-MM-DD format (optional)
project_idintegerObligatorioID of the project containing the task
descriptionstringNew task description (optional)
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Update User AccountWORKSNAPS_PUT_UPDATE_USER_ACCOUNTAcciónTool to update information for a specific user account. use when modifying user details after confirming the user exists.
WORKSNAPS_PUT_UPDATE_USER_ACCOUNTAcciónTool to update information for a specific user account. use when modifying user details after confirming the user exists.
Parámetros de entrada
emailstringNew email address for the user
user_idintegerObligatorioID of the user account to be updated
passwordstringNew password for the user
is_activebooleanSet to true to activate or false to deactivate the user
last_namestringNew last name for the user
time_zonestringIANA time zone identifier, e.g., 'America/Los_Angeles'
first_namestringNew first name for the user
is_managerbooleanSet to true to grant manager privileges
password_confirmationstringConfirmation of the new password
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not