---
title: "Get details suggestion for given events."
method: POST
path: "/integrations/calendar/events/details-suggestion"
tags: ["calendar"]
---

# Get details suggestion for given events.

`POST /integrations/calendar/events/details-suggestion`

## Request

- Base URL: `https://localhost:8080/api/v9`
- URL: `https://localhost:8080/api/v9/integrations/calendar/events/details-suggestion`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/toggl/apis/toggl-api/docs/integrations/calendar/events/details-suggestion/post.ts> (a function with typed inputs; its response is checked against the schema)

Given one or more event IDs, this endpoint responds with the most probable event details
(and its accuracy) to assign to the to-be-created time entry for each event ID.
This endpoint will only suggests time entries with description and project not empty, because it uses
the description to tell if the TE is similar and the project as the main detail to be suggested.

If the description is equal, as well as all the other details, the accuracy will be 100%, in the case
the description is equal but the other details differs, the most frequent will be suggested and the
accuracy will be given based on the frequency. In the case there is no TE with the same description
the most similar will be suggested based on the Jaro-Winkler algorithm, and the accuracy will be the
similarity rating.

This endpoint returns status 200 OK with only the successful suggestions. Any event ID that is invalid
or the user does not have access to will be ignored, as well as any event that has no available suggestion.

## Request body

- HandlercalendarPostDetailsSuggestionRequest
  - `event_ids` integer[]

## Response `200`

Suggestions for specified events

- HandlercalendarPostDetailsSuggestionResponse
  - `suggestions` HandlercalendarPostDetailsSuggestionResponseItem[]
    - `event_id` integer
    - `suggestion` ModelsSuggestion
      - `accuracy` number
      - `billable` boolean
      - `description_match` boolean
      - `last_seen` string
      - `project_id` integer
      - `tag_ids` integer[]
      - `task_id` integer
      - `workspace_id` integer

## Other responses

- `400`: Invalid, missing or too many event IDs
- `500`: Internal Server Error

---

[API](https://skmtc.dev/toggl/apis/toggl-api.md) - [All operations](https://skmtc.dev/toggl/apis/toggl-api/llms.txt) - [OpenAPI document](https://skmtc.dev/toggl/apis/toggl-api/revisions/3085aee16990?raw)