Skip to content
Changelog

Report a bug

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}

See How connections work for access and permissions, or browse all integrations.