NAiOS IconNAiOS Logo
Volver al catálogo

Toggl

toggl

Toggl is a time tracking application that helps users monitor and manage their work hours efficiently.

Acciones
31
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 (31)

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

Tool to create a new client in a workspace. use when you need to add a client to a workspace after workspace setup.

Parámetros de entrada

  • namestringObligatorio

    Name of the client to create

  • workspace_idintegerObligatorio

    ID of the workspace where the client will be created

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

Tool to create a new organization with a default workspace. use when initializing a werklog organization and workspace in one step.

Parámetros de entrada

  • namestringObligatorio

    Name of the new organization; 1–140 characters.

  • workspace_namestringObligatorio

    Name of the default workspace; 1–140 characters.

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

Tool to create a new project in a workspace. use after confirming workspace id and desired project parameters.

Parámetros de entrada

  • namestringObligatorio

    Name of the new project

  • colorinteger

    Project color code as integer

  • activeboolean

    Whether the project is active (true) or archived (false)

  • billableboolean

    Default billable status for entries in this project

  • currencystring

    ISO currency code for fixed fee and hourly rate

  • client_idinteger

    ID of the client the project belongs to

  • fixed_feenumber

    Fixed-price fee for this project in chosen currency

  • is_privateboolean

    Whether the project is private (true) or public (false)

  • hourly_ratenumber

    Default hourly rate for this project in chosen currency

  • is_templateboolean

    Mark this project as a template for future use

  • template_idinteger

    ID of an existing template project to base this project on

  • workspace_idintegerObligatorio

    ID of the workspace where the project will be created

  • estimated_hoursnumber

    Estimated total hours for 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 TagTOGGL_CREATE_TAGAcción

Tool to create a new tag in a workspace. use when you need to add a tag after confirming workspace id and desired tag name.

Parámetros de entrada

  • namestringObligatorio

    Name of the new tag

  • client_idinteger

    Optional client ID to associate with the tag

  • workspace_idintegerObligatorio

    ID of the workspace where the tag will be created

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

Tool to create a new time entry in the specified workspace. use when you have workspace id, start time, and client name ready.

Parámetros de entrada

  • stopstring

    ISO 8601 timestamp when the entry stopped; omit to leave running

  • tagsstring[]

    List of tags to attach to the entry

  • startstringObligatorio

    ISO 8601 timestamp when the entry started

  • task_idinteger

    Task ID associated with the time entry

  • billableboolean

    Whether the entry is billable

  • durationinteger

    Duration in seconds; omit for running entries

  • project_idinteger

    Project ID to associate the entry with

  • descriptionstring

    Description of the time entry

  • created_withstringObligatorio

    Name of the client application creating this entry

  • workspace_idintegerObligatorio

    Workspace ID where the time entry will be created

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

Tool to delete a client in toggl. use when you have confirmed the workspace and client ids and want to remove a client permanently.

Parámetros de entrada

  • client_idstringObligatorio

    The ID of the client to delete.

  • workspace_idstringObligatorio

    The ID of the workspace where the client resides.

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

Tool to delete a tag from a workspace. use when you need to remove an unused tag after confirming its workspace and tag ids.

Parámetros de entrada

  • tag_idstringObligatorio

    The tag's unique identifier within the workspace.

  • workspace_idstringObligatorio

    The workspace's unique identifier.

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

Tool to retrieve details of a specific client. use when you need to fetch client metadata by its id from toggl.

Parámetros de entrada

  • client_idintegerObligatorio

    The unique ID of the client to retrieve details for

  • workspace_idintegerObligatorio

    The workspace ID the client belongs to

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 Current Time EntryTOGGL_GET_CURRENT_TIME_ENTRYAcción

Tool to retrieve the current running time entry for the authenticated user. use after starting the timer to fetch the active time entry.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

  • dataobject

    Model representing a Toggl time entry object.

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List ClientsTOGGL_GET_LIST_CLIENTSAcción

Tool to retrieve a list of clients from a toggl workspace. use when you need to list all clients with optional filters.

Parámetros de entrada

  • pageinteger

    Page number for pagination (minimum is 1)

  • sincestring

    Return clients modified after this timestamp (ISO 8601 format)

  • untilstring

    Return clients modified before this timestamp (ISO 8601 format)

  • activeboolean

    Filter by active status. True for active clients, False for inactive.

  • per_pageinteger

    Number of clients per page (1-200)

  • workspace_idintegerObligatorio

    The unique ID of the workspace to list clients from

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

Tool to retrieve details of a specific organization by its id. use when you need organizational metadata after confirming the organization id.

Parámetros de entrada

  • organization_idintegerObligatorio

    Unique ID of the organization 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 Organization GroupsTOGGL_GET_ORGANIZATION_GROUPSAcción

Tool to retrieve list of groups in a specified organization. use after confirming organization id.

Parámetros de entrada

  • organization_idintegerObligatorio

    Unique identifier of the organization

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

Tool to retrieve all users in a toggl organization by organization id. use after confirming the target organization id.

Parámetros de entrada

  • organization_idintegerObligatorio

    The unique ID of the organization to list users 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 Project DetailsTOGGL_GET_PROJECT_DETAILSAcción

Tool to retrieve details of a specific project. use after confirming the workspace id and project id.

Parámetros de entrada

  • project_idintegerObligatorio

    Unique identifier of the project to retrieve

  • workspace_idintegerObligatorio

    Workspace ID the project belongs to

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

Tool to retrieve a list of projects from a toggl workspace. use after confirming workspace id. returns filtered and paginated projects with optional client details.

Parámetros de entrada

  • pageinteger

    Page number for pagination (minimum is 1)

  • sincestring

    Return projects modified after this timestamp (ISO 8601 format)

  • untilstring

    Return projects modified before this timestamp (ISO 8601 format)

  • clientsboolean

    Include full client details when true

  • user_idinteger

    Filter projects visible by this user ID

  • page_sizeinteger

    Number of projects per page (1-200)

  • project_idsstring

    Comma-separated list of project IDs to filter (max 200 IDs)

  • workspace_idintegerObligatorio

    The unique ID of the workspace to list projects from

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

Tool to retrieve all tags in a toggl workspace. use after confirming the workspace id.

Parámetros de entrada

  • workspace_idintegerObligatorio

    The ID of the workspace to retrieve tags 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

List TasksTOGGL_GET_TASKSAcción

Tool to list tasks in a workspace or within a specific project.

Parámetros de entrada

  • pageinteger

    Page number for pagination (minimum is 1)

  • activeboolean

    If true, returns only active tasks

  • billableboolean

    If true, returns only billable tasks

  • page_sizeinteger

    Number of tasks per page (1-1000)

  • project_idinteger

    Filter tasks to only those belonging to this project ID

  • workspace_idintegerObligatorio

    Workspace ID to list tasks from

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

Tool to list the latest time entries for the authenticated user. use when you need to fetch or filter your logged time entries by start date or end date.

Parámetros de entrada

  • end_datestring

    Only include entries before this timestamp (ISO 8601 format)

  • start_datestring

    Only include entries after this timestamp (ISO 8601 format)

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

Tool to retrieve a specific time entry by its id. use when you have the entry id and need its full details.

Parámetros de entrada

  • time_entry_idintegerObligatorio

    The unique ID of the time entry to retrieve

Parámetros de salida

  • dataobjectObligatorio

    The requested time entry object

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get User ClientsTOGGL_GET_USER_CLIENTSAcción

Tool to fetch the list of clients accessible by the authenticated user. use when you need to see all clients available to the current toggl user.

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

Get User PreferencesTOGGL_GET_USER_PREFERENCESAcción

Tool to retrieve current user's preferences and alpha features. use when you need to access user settings for customized experiences.

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

Get User ProjectsTOGGL_GET_USER_PROJECTSAcción

Tool to retrieve all projects for the authenticated user. use after authenticating to list available projects.

Parámetros de entrada

  • workspace_idinteger

    Only return projects for the specified workspace ID

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

Tool to retrieve tags associated with the current user. use when you need to list all tags visible to your account.

Parámetros de entrada

  • workspace_idinteger

    Optional workspace ID to filter tags by a specific workspace.

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

Tool to retrieve tasks from projects in which the authenticated user is participating. use after authenticating to list all tasks across workspaces.

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

Get User WorkspacesTOGGL_GET_USER_WORKSPACESAcción

Tool to retrieve all workspaces the authenticated user belongs to. use when you need to list accessible workspaces before performing workspace-specific operations.

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

Get Workspace DetailsTOGGL_GET_WORKSPACE_DETAILSAcción

Tool to retrieve details of a specific workspace. use when you need to fetch workspace configuration and settings by its id.

Parámetros de entrada

  • workspace_idintegerObligatorio

    Unique ID of the workspace to retrieve details 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 Workspace PreferencesTOGGL_GET_WORKSPACE_PREFERENCESAcción

Tool to retrieve workspace preferences. use after confirming workspace id to inspect settings like week start, project creation rules, and time tracking options.

Parámetros de entrada

  • workspace_idintegerObligatorio

    The unique identifier of the workspace

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

Tool to retrieve all users in a toggl workspace by workspace id. use after confirming the target workspace id.

Parámetros de entrada

  • workspace_idintegerObligatorio

    The unique ID of the workspace to list users 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

Stop Time EntryTOGGL_PATCH_STOP_TIME_ENTRYAcción

Tool to stop a running time entry in a workspace. use when a time entry needs to be ended.

Parámetros de entrada

  • workspace_idintegerObligatorio

    ID of the workspace containing the time entry

  • time_entry_idintegerObligatorio

    ID of the time entry to stop

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

Tool to update an existing tag in a specified workspace. use after confirming the workspace id and tag id when renaming a tag. example: rename tag 'urgent' to 'high priority'.

Parámetros de entrada

  • namestringObligatorio

    New name for the tag

  • tag_idintegerObligatorio

    Numeric ID of the tag to update

  • workspace_idintegerObligatorio

    Numeric ID of the workspace containing the tag

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

Tool to update details of a specific client. use when you need to modify a client's name, notes, or other details after confirming workspace and client ids.

Parámetros de entrada

  • widinteger

    Workspace ID (must match workspace_id) if provided

  • namestring

    New name for the client

  • notesstring

    Additional notes for the client

  • client_idintegerObligatorio

    The unique ID of the client to update

  • workspace_idintegerObligatorio

    The unique ID of the workspace that owns the client

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