API Reference
  1. DeskDay API
  2. Time Entries

Log a time entry

post
https://public-api.deskday.ai/v1/time-entries

Create a time entry against a ticket. Requires scope time_entries:write. Supports X-Idempotency-Key.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
uuid
required

Ticket mapping_id to log time against. Required.

string
required
length ≤ 75

Resource / technician id who performed the work. Required.

number
≥ 1

Total minutes worked. Provide this or both start_time and end_time.

number
≥ 0

Minutes to deduct from the logged total (e.g. breaks).

date-time

ISO 8601 start timestamp.

date-time

ISO 8601 end timestamp.

boolean
Defaults to true

Whether the entry is billable. Defaults to true.

string
length ≤ 4096

Free-text note describing the work performed.

string
enum
Defaults to service

Activity classification for the logged time. Defaults to "service".

Allowed:
string
enum
Defaults to public

Visibility of the entry. Defaults to "public".

Allowed:
string
enum

Alias for access_specifier.

Allowed:
boolean
Defaults to false

Whether to mark the entry as the ticket resolution. Defaults to false.

uuid

Work type mapping_id classifying the work.

uuid

Work role mapping_id classifying the work.

boolean

Whether the time fell within the customer's operating hours.

string
length ≤ 128

Opaque reference to an external system record.

notes_attachments
array of strings
length ≤ 50

Attachment mapping_ids to attach to the note. Maximum 50.

notes_attachments
Responses

Updated 2 months ago

Did this page help you?
Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 2 months ago

Did this page help you?