Timely integration: operations for AI agents
Timely connects to Type.com as an integration. This page lists the 92 operations documented for Claude and Codex in Type.com: 37 read, 24 write, 31 destructive.
About Timely
Timely is an automatic time-tracking platform capturing activity across applications, calendars, and devices, creating detailed timesheets for billing or productivity insights
Categories: Productivity & Project Management
How to connect Timely to Type.com
- Access
- Organization connection: one shared account for the workspace.
To add the connection, follow the steps in Space connections.
Documented operations
92 operations. Your connection's permissions determine which operations are available. API references describe the vendor surface; they do not expand your connection's credentials or access.
92 operations listed.
Webhook Events
- Read
Webhook event types
This is a documentation-only endpoint describing the webhook event payloads.
GET /webhook-events
Projects
- Read
List projects of an account
List all projects in the Timely account. The projects will be returned in a paginated format.
GET /1.1/{account_id}/projects - Read
Show project
Retrieve details for a specific project.
GET /1.1/{account_id}/projects/{id} - Write
Change client across selected projects
PATCH /1.1/{account_id}/bulk/projects
PATCH /1.1/{account_id}/bulk/projects - Write
Change people or team assignments across selected projects
PATCH /1.1/{account_id}/bulk/projects/people
PATCH /1.1/{account_id}/bulk/projects/people - Write
Set the tag requirement on selected projects
PATCH /1.1/{account_id}/bulk/projects/tag_settings
PATCH /1.1/{account_id}/bulk/projects/tag_settings - Write
Pin a project
Pin a project for the current person. Up to 50 accessible projects may be pinned per workspace. Repeating an existing pin is allowed.
POST /1.1/{account_id}/projects/{project_id}/pin - Write
Creates a new project
Create a new project in the Timely account. The project will be created with the provided details.
POST /1.1/{account_id}/projects - Destructive
Update project
Update an existing project. Only the provided fields will be updated.
PUT /1.1/{account_id}/projects/{id} - Destructive
Delete project
Delete a project. This will permanently remove the project from the account.
DELETE /1.1/{account_id}/projects/{id}
Bulk Operations
- Write
Bulk import time entries (create/update/delete)
Create, update, or delete multiple time entries in a single request. For large operations (100+ records), the operation runs asynchronously and returns a job ID.
POST /1.1/{account_id}/bulk/hours - Write
Bulk import events (create/update/delete)
Create, update, or delete multiple events in a single request. Events are the same as time entries - this is an alias endpoint. For large operations (100+ records), the operation runs asynchronously and returns a job ID.
POST /1.1/{account_id}/bulk/events
Clients
- Read
List all clients of an account
NOTE: By default, client list will return first 10000 clients in alphabetical order. You can also use optional parameters like “limit”, “offset”, “show” and “order” to change the results.
GET /1.1/{account_id}/clients - Read
Client details
Client details and project counts
GET /1.1/{account_id}/clients/{id} - Write
Client create
This API lets you create a client for an account.
POST /1.1/{account_id}/clients - Destructive
Client update
Update client details just by using a client ID.
PUT /1.1/{account_id}/clients/{id}
Compliance
- Read
List per-user compliance metrics
Returns per-user time-tracking compliance metrics for a configurable date window.
GET /1.1/{account_id}/users/compliance
Day Properties
- Read
List day properties
Retrieve day properties (locked days) for users in the account. Day properties control whether time entries can be modified for specific dates. You can filter by date range using since and until parameters, or by specific dates using the dates parameter.
GET /1.1/{account_id}/day_properties - Write
Create or update day properties
Create or update day properties to lock or unlock days for time entry modifications. This endpoint allows bulk operations across multiple users and dates. When a day is locked, users cannot create, update, or delete time entries for that date.
POST /1.1/{account_id}/day_properties - Destructive
Update day properties
Update day properties to lock or unlock days for time entry modifications. This endpoint allows bulk operations across multiple users and dates. Use locked: false to unlock previously locked days, allowing users to modify time entries for those dates again.
PUT /1.1/{account_id}/day_properties
Forecasts (Tasks)
- Read
List tasks
List all tasks in the account. Tasks are returned in a paginated format with optional filtering by date range, user, project, and completion status.
GET /1.1/{account_id}/forecasts - Read
Show task
Retrieve details for a specific task.
GET /1.1/{account_id}/forecasts/{id} - Read
Task summaries
Get task summaries grouped by resource type (users or projects). Returns aggregate counts and duration totals.
GET /1.1/{account_id}/forecasts/{resource}/summary - Write
Create task
Create a new task. Requires the Planning feature to be enabled.
POST /1.1/{account_id}/forecasts - Write
Update task
Update an existing task. Only the provided fields will be updated.
PATCH /1.1/{account_id}/forecasts/{id} - Destructive
Delete task
Delete a task.
DELETE /1.1/{account_id}/forecasts/{id}
Events
- Read
List time entries
List all time entries in the Timely account. Time entries will be returned in a paginated format with optional filtering.
GET /1.1/{account_id}/hours - Read
Show time entry
Retrieve details for a specific time entry.
GET /1.1/{account_id}/hours/{id} - Write
Create time entry
Create a new time entry in the Timely account. The time entry will be created with the provided details.
POST /1.1/{account_id}/hours - Destructive
Update time entry
Update an existing time entry. Only the provided fields will be updated.
PUT /1.1/{account_id}/hours/{id} - Destructive
Delete time entry
Delete a time entry. Locked or invoiced time entries cannot be deleted.
DELETE /1.1/{account_id}/hours/{id}
Event Timers
- Destructive
Start timer
Start the timer for a specific time entry.
PUT /1.1/{account_id}/hours/{id}/start - Destructive
Stop timer
Stop the timer for a specific time entry.
PUT /1.1/{account_id}/hours/{id}/stop
Event States
- Read
List time entry states
List all available time entry states for the account.
GET /1.1/{account_id}/hours/states - Read
List all states
Retrieve all states for the specified account, including their permissions.
GET /1.1/{account_id}/states - Write
Create time entry state
Create a new time entry state. Only admin users can create states.
POST /1.1/{account_id}/hours/states - Write
Create or update state permissions
Create or update permissions for a state. Admin access required. System-managed states cannot be modified.
POST /1.1/{account_id}/states/{state_id}/permissions - Write
Create a new state
Create a new state for the specified account. Only admin users can create states.
POST /1.1/{account_id}/states - Destructive
Update time entry state
Update an existing time entry state. Only admin users can update states.
PUT /1.1/{account_id}/hours/states/{id} - Destructive
Delete time entry state
Delete a time entry state. Only admin users can delete states and system-managed states cannot be deleted.
DELETE /1.1/{account_id}/hours/states/{id} - Destructive
Delete state permissions
Delete all permissions for a state. Admin access required. System-managed states cannot be modified.
DELETE /1.1/{account_id}/states/{state_id}/permissions/{id} - Destructive
Update a state
Update an existing state. Only admin users can update states.
PUT /1.1/{account_id}/states/{id} - Destructive
Delete a state
Delete a state. Only admin users can delete states and system-managed states cannot be deleted.
DELETE /1.1/{account_id}/states/{id}
Insights
- Read
Billable utilisation and where time went
Billable utilisation against a target, the billable/non-billable split, and where the time went — for one of three views. Durations are MINUTES throughout, matching how every reporting total in the product is computed.
GET /1.1/{account_id}/insights - Destructive
Change the Insights page settings
Admin only. All four settings change what EVERY reader on the account sees, not one reader's view of it: naming individuals is a privacy decision, the metric and its target decide which number the whole account is judged on, and the minimum team size decides which teams are smal…
PUT /1.1/{account_id}/insights/settings
Tags
- Read
List all tags
Retrieve all labels (tags) for the specified account. Labels help classify work, group related tasks, and require certain information for events. Supports filtering by status and pagination.
GET /1.1/{account_id}/labels - Read
Get a single tag
Retrieve a specific label by ID. The response includes child labels if any exist.
GET /1.1/{account_id}/labels/{id} - Write
Create a new tag
Create a new label (tag) for the account. Labels can be hierarchical by specifying a parentid.
POST /1.1/{account_id}/labels - Destructive
Manage selected tags
PUT /1.1/{account_id}/labels/bulk
PUT /1.1/{account_id}/labels/bulk - Destructive
Update a tag
Update an existing label. All fields are optional for partial updates. Set active to false to archive a label.
PUT /1.1/{account_id}/labels/{id} - Destructive
Delete a tag
Delete a label from the account. This will permanently remove the label.
DELETE /1.1/{account_id}/labels/{id}
Linked Work Items
- Read
List linked work items
Retrieve linked work items for the account. Supports filtering by search query, status, project, assigned user and externalid, plus limit/offset pagination. Items are ordered by most recently updated first, with ties broken by descending id.
GET /1.1/{account_id}/linked_work_items - Read
Get a single linked work item
Retrieve a specific linked work item by ID.
GET /1.1/{account_id}/linked_work_items/{id} - Write
Create a linked work item
Create a new linked work item for the account. If a deleted item in the account has the same externalid, that item is revived instead: it keeps its id and takes the request body as a fresh create would.
POST /1.1/{account_id}/linked_work_items - Destructive
Update a linked work item
Update an existing linked work item. All fields are optional for partial updates.
PUT /1.1/{account_id}/linked_work_items/{id} - Destructive
Delete a linked work item
Delete a linked work item from the account. Existing time entries linked to the item keep rendering its metadata. The item keeps its externalid, so creating or upserting that externalid again revives it with the same id.
DELETE /1.1/{account_id}/linked_work_items/{id} - Destructive
Create or update a linked work item by externalid
Idempotent upsert keyed on your own externalid. Creates the item when no item with that externalid exists in the account (201), revives it with the same id when it was deleted (201), and updates it otherwise (200).
PUT /1.1/{account_id}/linked_work_items/external/{external_id}
OAuth
- Read
Get current token info
Get information about the current access token.
GET /1.1/oauth/token/info - Read
List authorized applications
List applications that the current user has authorized.
GET /1.1/oauth/authorized_applications - Write
Exchange authorization code for access token
Exchange an authorization code for an access token using OAuth 2.0 authorization code flow.
POST /1.1/oauth/token - Write
Introspect access token
Check if an access token is active and get its metadata.
POST /1.1/oauth/introspect - Destructive
Revoke access token
Revoke an access token or refresh token.
POST /1.1/oauth/revoke - Destructive
Revoke application authorization
Revoke authorization for a specific application.
DELETE /1.1/oauth/authorized_applications/{id}
Permissions
- Read
List current user permissions
Retrieve all resource permissions for the currently authenticated user.
GET /1.1/{account_id}/users/current/permissions - Read
List a user's permissions
Retrieve all resource permissions for a specific user. Requires read access to users.
GET /1.1/{account_id}/users/{user_id}/permissions
Reports
- Read
Get report totals
Retrieve report totals grouped by clients and projects. This endpoint provides aggregated time tracking data including durations, costs, and billing information. The response includes clients with their associated projects and calculated metrics.
GET /1.1/{account_id}/reports - Read
Filter reports
Filter and retrieve report data with flexible grouping options. Returns aggregated totals grouped by clients, projects, users, labels, days, or teams. Use scope=events to retrieve individual time entries instead of aggregated totals.
GET /1.1/{account_id}/reports/filter
Roles
- Read
List all roles
Retrieve all roles available in the account. Roles define permissions and access levels for users, including admin, manager, employee, and team lead roles.
GET /1.1/{account_id}/roles
Teams
- Read
Search teams
Search for teams by name
GET /1.1/{account_id}/teams/search - Read
List all teams of an account
NOTE: By default, team list will return first 100 teams in alphabetical order. You can also use optional parameters like "limit", "offset", and "order" to change the results.
GET /1.1/{account_id}/teams - Read
Team details
Team details including users and project IDs
GET /1.1/{account_id}/teams/{id} - Write
Team create
This API lets you create a team for an account.
POST /1.1/{account_id}/teams - Write
Team patch
Patch team details just by using a team ID.
PATCH /1.1/{account_id}/teams/{id} - Destructive
Team update
Update team details just by using a team ID.
PUT /1.1/{account_id}/teams/{id} - Destructive
Team delete
Delete a team by ID.
DELETE /1.1/{account_id}/teams/{id}
Users
- Read
Get current user
Returns the current user information for the authenticated user.
GET /1.1/{account_id}/users/current - Read
List users
Lists users in the account. Requires global user read permission or project update permission.
GET /1.1/{account_id}/users - Read
Get user details
Get specific user details. Requires read permission for the user.
GET /1.1/{account_id}/users/{id} - Read
Search users
Search users. Requires create or update project permission.
GET /1.1/{account_id}/users/search - Write
Send timesheet reminders
Asks the given users to complete their timesheets. Callers need global User Notify, User Notify on the recipients, or to lead teams containing every recipient. With scope=compliance, every recipient must also be visible to the caller on the compliance dashboard.
POST /1.1/{account_id}/users/timesheet_requests - Write
Invites user to the account
Invites user to the account. Requires trial/active subscription as also available seats in the workspace to accommodate additional users.
POST /1.1/{account_id}/users - Destructive
Update user
Update user details. Requires update permission for the user.
PUT /1.1/{account_id}/users/{id} - Destructive
Delete user
Delete/remove user from account. Requires delete permission for the user.
DELETE /1.1/{account_id}/users/{id} - Destructive
Set user avatar
Upload a PNG or JPEG (max 2 MB) as the user's avatar. Requires update permission for the user. The avatar belongs to the person, so it changes in every workspace they are in.
PUT /1.1/{account_id}/users/{id}/avatar - Destructive
Remove user avatar
Remove the user's avatar so the Gravatar fallback is shown. Requires update permission for the user.
DELETE /1.1/{account_id}/users/{id}/avatar
User Capacities
- Read
List a user's capacities
Retrieve capacity configurations for a specific user. Capacities define a user's working hours, working days, and daily/weekly hour limits.
GET /1.1/{account_id}/users/{user_id}/capacities - Read
List capacities for multiple users
Retrieve capacity configurations for multiple users in the account. Supports filtering by user IDs and date range.
GET /1.1/{account_id}/users/capacities
Webhooks
- Read
List all webhooks
Retrieve all webhooks configured for the account. Webhooks allow you to receive HTTP POST notifications when events occur.
GET /1.1/{account_id}/webhooks - Read
Show webhook
Retrieve details for a specific webhook.
GET /1.1/{account_id}/webhooks/{id} - Write
Create a new webhook
Create a new webhook subscription. Webhooks allow you to receive HTTP POST notifications when events occur in your account.
POST /1.1/{account_id}/webhooks - Destructive
Update webhook
Update an existing webhook. Only the provided fields will be updated.
PUT /1.1/{account_id}/webhooks/{id} - Destructive
Delete webhook
Delete a webhook. This will permanently remove the webhook and stop all future notifications.
DELETE /1.1/{account_id}/webhooks/{id}
No operations match.
See How connections work for access and permissions, or browse all integrations.