# Timely API Documentation

This is the complete API documentation for connecting to the Timely API using MindCloud's Universal API.

MindCloud offers one normalized API to access 3,400+ apps from a single place. It centralizes authentication and normalizes app APIs so they are easier and more consistent to use.

## Quickstart

1. A **MindCloud account** — sign in or create an account at [MindCloud](https://app.mindcloud.co).
2. A **MindCloud API Key** — create one in [API Keys](https://app.mindcloud.co/user/api-keys). Keep it on your server.
3. At least one **Timely connection** — create or choose one in [Connections](https://app.mindcloud.co/credentials). Note its `connectionId`.

```text
POST https://connect.mindcloud.co/v2/universal/apps/timely/actions/{actionSlug}/run
```

## Timely actions

- POST `bulk-import-time-entries` Bulk Import Time Entries
- POST `create-client` Create Client
- POST `create-project` Create Project
- POST `create-tag` Create Tag
- POST `create-task` Create Task
- POST `create-time-entry` Create Time Entry
- POST `create-webhook` Create Webhook
- DELETE `delete-project` Delete Project
- DELETE `delete-tag` Delete Tag
- DELETE `delete-task` Delete Task
- DELETE `delete-time-entry` Delete Time Entry
- GET `filter-reports` Filter Reports
- GET `get-client` Get Client
- GET `get-current-token-info` Get Current Token Info
- GET `get-current-user` Get Current User
- GET `get-project` Get Project
- GET `get-report-totals` Get Report Totals
- GET `get-tag` Get Tag
- GET `get-task` Get Task
- GET `get-time-entry` Get Time Entry
- GET `get-user` Get User
- GET `get-webhook` Get Webhook
- POST `invite-user` Invite User
- GET `list-clients` List Clients
- GET `list-projects` List Projects
- GET `list-tags` List Tags
- GET `list-task-summaries` List Task Summaries
- GET `list-tasks` List Tasks
- GET `list-time-entries` List Time Entries
- GET `list-users` List Users
- GET `list-webhooks` List Webhooks
- GET `search-users` Search Users
- PUT `start-time-entry-timer` Start Time Entry Timer
- PUT `stop-time-entry-timer` Stop Time Entry Timer
- PUT `update-client` Update Client
- PUT `update-project` Update Project
- PUT `update-tag` Update Tag
- PUT `update-task` Update Task
- PUT `update-time-entry` Update Time Entry
- PUT `update-user` Update User