NAiOS IconNAiOS Logo
Volver al catálogo

Worksnaps

worksnaps

Worksnaps is a time-tracking service designed for remote work that offers detailed project and user activity insights.

Acciones
14
Triggers
0
Autenticación
OAuth gestionado
No
Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

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ón

Tool to create a new project in worksnaps. use after gathering project details before logging time.

Parámetros de entrada

  • namestringObligatorio

    Name of the project

  • budgetnumber

    Budget of the project

  • statusstring

    Status of the project (e.g., 'Active')

  • end_datestring

    End date/time of the project in ISO8601 format

  • client_idinteger

    ID of the client associated with the project

  • start_datestring

    Start date/time of the project in ISO8601 format

  • descriptionstring

    Description of the project

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create taskWORKSNAPS_CREATE_TASKAcción

Tool to create a new task in a specified project. use after confirming project id exists.

Parámetros de entrada

  • namestringObligatorio

    Name of the task

  • due_datestring

    Due date in YYYY-MM-DD format

  • project_idintegerObligatorio

    ID of the project to create the task in

  • assigned_tointeger

    ID of the user to assign the task

  • descriptionstring

    Brief description of the task

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete TaskWORKSNAPS_DELETE_TASKAcción

Tool 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_idintegerObligatorio

    The ID of the task to delete

  • project_idintegerObligatorio

    The ID of the project containing the task

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Project DetailsWORKSNAPS_GET_PROJECT_DETAILSAcción

Tool to retrieve details of a specific project. use when you have a project id and need its details.

Parámetros de entrada

  • project_idintegerObligatorio

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

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Project ReportWORKSNAPS_GET_PROJECT_REPORTAcción

Tool 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_dateanydate

    End date for the report in YYYY-MM-DD format

  • user_idinteger

    Optional user ID to filter the report

  • from_dateanydate

    Start date for the report in YYYY-MM-DD format

  • project_idintegerObligatorio

    ID of the project to retrieve the report for

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get ProjectsWORKSNAPS_GET_PROJECTSAcción

Tool to retrieve a paginated list of projects. use after authenticating to list accessible projects.

Parámetros de entrada

  • pageinteger

    Page number for pagination (>=1)

  • per_pageinteger

    Number of projects per page (1-100)

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Task DetailsWORKSNAPS_GET_TASK_DETAILSAcción

Tool to retrieve details of a specific task within a project. use after confirming project id and task id.

Parámetros de entrada

  • task_idintegerObligatorio

    The unique identifier of the task to retrieve

  • project_idintegerObligatorio

    The unique identifier of the project containing the task

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Project TasksWORKSNAPS_GET_TASKSAcción

Tool 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

  • pageinteger

    Page number for pagination (optional, default=1)

  • statusstringenum

    Filter tasks by status: 'open' or 'closed' (optional)

    openclosed
  • user_idinteger

    Filter tasks by user ID (optional)

  • per_pageinteger

    Number of tasks per page (optional, default=50)

  • project_idintegerObligatorio

    ID of the project to retrieve tasks for

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get User AccountWORKSNAPS_GET_USER_ACCOUNTAcción

Tool to retrieve information about a specific user account. use after confirming the user id.

Parámetros de entrada

  • user_idintegerObligatorio

    The unique identifier of the user to retrieve

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get User AssignmentsWORKSNAPS_GET_USER_ASSIGNMENTSAcción

Tool 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_idintegerObligatorio

    ID of the project to retrieve assignments for

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get UsersWORKSNAPS_GET_USERSAcción

Tool 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

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update ProjectWORKSNAPS_PUT_UPDATE_PROJECTAcción

Tool to update an existing project. use when you have project id and fields to modify.

Parámetros de entrada

  • namestring

    New project name (optional)

  • statusstringenum

    Project status: 'active' or 'archived' (optional)

    activearchived
  • end_datestring

    Project end date YYYY-MM-DD (optional)

  • client_idinteger

    New client ID (optional)

  • project_idintegerObligatorio

    ID of the project to update

  • start_datestring

    Project start date YYYY-MM-DD (optional)

  • descriptionstring

    New project description (optional)

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update TaskWORKSNAPS_PUT_UPDATE_TASKAcción

Tool to update details of an existing task. use when you have project id, task id, and fields to update.

Parámetros de entrada

  • namestring

    New task name (optional)

  • statusstringenum

    New task status: 'open' or 'closed' (optional)

    openclosed
  • task_idintegerObligatorio

    ID of the task to update

  • due_datestring

    New due date in YYYY-MM-DD format (optional)

  • project_idintegerObligatorio

    ID of the project containing the task

  • descriptionstring

    New task description (optional)

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update User AccountWORKSNAPS_PUT_UPDATE_USER_ACCOUNTAcción

Tool to update information for a specific user account. use when modifying user details after confirming the user exists.

Parámetros de entrada

  • emailstring

    New email address for the user

  • user_idintegerObligatorio

    ID of the user account to be updated

  • passwordstring

    New password for the user

  • is_activeboolean

    Set to true to activate or false to deactivate the user

  • last_namestring

    New last name for the user

  • time_zonestring

    IANA time zone identifier, e.g., 'America/Los_Angeles'

  • first_namestring

    New first name for the user

  • is_managerboolean

    Set to true to grant manager privileges

  • password_confirmationstring

    Confirmation of the new password

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not