> Markdown versions of all pages of this connector library are available by appending `.md` to the page URL. For the full index of connectors, see [llms.txt](https://connectors.appmixer.com/llms.txt).

# Update Time Entry

- Component: `appmixer.toggl.core.UpdateTimeEntry`
- Kind: Action
- Version: 1.0.0
- Visibility: Public
- Connector: [appmixer.toggl 1.0.0](https://connectors.appmixer.com/connector/appmixer.toggl/1.0.0.md)
- Component page: <https://connectors.appmixer.com/connector/appmixer.toggl/1.0.0/component/appmixer.toggl.core.UpdateTimeEntry>

Update a time entry. Only the fields you fill in are changed.

## Input ports

### Port `in`

| Field | Type | Description |
| --- | --- | --- |
| Time Entry ID (`timeEntryId`) | text | Numeric ID of the time entry to update. |
| Description (`description`) | text | New description. Leave empty to keep the current one. |
| Start (`start`) | date-time | New start. Leave empty to keep the current one. |
| Stop (`stop`) | date-time | New end. Toggl stores it as the duration since Start. Leave empty to keep the current one. |
| Project (`projectId`) | text | Pick a project or type its numeric ID. Leave empty to keep the current one. |
| Task ID (`taskId`) | text | Numeric ID of a task. Leave empty to keep the current one. |
| Billable (`billable`) | select | Leave empty to keep the current value. |

## Output ports

### Port `out`

_No fields defined for this port._

## Full metadata (component.json)

```json
{
  "name": "appmixer.toggl.core.UpdateTimeEntry",
  "label": "Update Time Entry",
  "description": "Update a time entry. Only the fields you fill in are changed.",
  "author": "Appmixer <info@appmixer.com>",
  "version": "1.0.0",
  "auth": {
    "service": "appmixer:toggl"
  },
  "quota": {
    "manager": "appmixer:toggl",
    "resources": "requests",
    "scope": {
      "userId": "{{userId}}"
    }
  },
  "inPorts": [
    {
      "name": "in",
      "schema": {
        "type": "object",
        "properties": {
          "timeEntryId": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "start": {
            "type": "string",
            "format": "date-time"
          },
          "stop": {
            "type": "string",
            "format": "date-time"
          },
          "projectId": {
            "type": "string"
          },
          "taskId": {
            "type": "string"
          },
          "billable": {
            "type": "string"
          }
        },
        "required": [
          "timeEntryId"
        ]
      },
      "inspector": {
        "inputs": {
          "timeEntryId": {
            "type": "text",
            "label": "Time Entry ID",
            "tooltip": "Numeric ID of the time entry to update.",
            "index": 1
          },
          "description": {
            "type": "text",
            "label": "Description",
            "tooltip": "New description. Leave empty to keep the current one.",
            "index": 2
          },
          "start": {
            "type": "date-time",
            "label": "Start",
            "tooltip": "New start. Leave empty to keep the current one.",
            "index": 3
          },
          "stop": {
            "type": "date-time",
            "label": "Stop",
            "tooltip": "New end. Toggl stores it as the duration since Start. Leave empty to keep the current one.",
            "index": 4
          },
          "projectId": {
            "type": "text",
            "label": "Project",
            "tooltip": "Pick a project or type its numeric ID. Leave empty to keep the current one.",
            "source": {
              "url": "/component/appmixer/toggl/core/ListProjects?outPort=out",
              "data": {
                "messages": {
                  "in/outputType": "array"
                },
                "properties": {
                  "isSource": true
                },
                "transform": "./ListProjects#toSelectArray"
              }
            },
            "index": 5
          },
          "taskId": {
            "type": "text",
            "label": "Task ID",
            "tooltip": "Numeric ID of a task. Leave empty to keep the current one.",
            "index": 6
          },
          "billable": {
            "type": "select",
            "label": "Billable",
            "tooltip": "Leave empty to keep the current value.",
            "options": [
              {
                "label": "Yes",
                "value": "true"
              },
              {
                "label": "No",
                "value": "false"
              }
            ],
            "index": 7
          }
        }
      }
    }
  ],
  "outPorts": [
    "out"
  ],
  "icon": "(data URI omitted)"
}
```
