Update a time entry

PUT /api/v1/time-entry/{id}

Personal access token & OAuth2

Headers

Authorization string
Content-Type string
Accept string

Path parameters

id string Required

The ID of the time entry.

application/json

Body Required

trackable_type string Required

The type of the model that is being tracked.. Valid types are: client, board_task, case, circle, firm, task
trackable_uuid string Required

The UUID of the model that is being tracked
name string

The name of the time entry.
description string

The description of the time entry.
start_date date

The start time of the time entry.
end_date date

The end time of the time entry.
total_time_in_minutes integer

The length of the time entry, can be used instead of dates.

Responses

200 application/json
Hide response attributes Show response attributes object
- uuid string
  
  The UUID of the resource.
- created_at string
  
  The timestamp of when the resource was created.
- updated_at string
  
  The timestamp of when the resource was updated.
- name string
  
  The name of the time entry.
- description string
  
  The description of the time entry.
- trackable_type string
  
  The model type that is being tracked. The example given is a client, but it can be a case, firm, circle or task.
- trackable object
  
  The model that is being tracked. The example given is a client, but it can be a case, firm, or task.
  
  Additional properties are allowed.
- start_date string
  
  The start time of the time entry.
- end_date string
  
  The end time of the time entry.
- is_active boolean
  
  Determines if the time entry is currently ongoing.
- total_time_in_minutes integer
  
  Total time in minutes.
- computed_time_elapsed_in_seconds integer
  
  Computed time elapsed in seconds.
- account object
  
  Who started the timer.
  
  Additional properties are allowed.

PUT /api/v1/time-entry/{id}

curl \
 --request PUT https://api.plannrcrm.com/api/v1/time-entry/id \
 --header "Authorization: Bearer {OAUTH_ACCESS_TOKEN or PERSONAL_ACCESS_TOKEN}" \
 --header "Content-Type: application/json" \
 --header "Accept: application/json" \
 --data '{"trackable_type":"Client","trackable_uuid":"5d5eaccf-15ca-4de3-8d68-b2e654bafc6c","name":"Research","description":"Research for the client","start_date":"2025-02-20T09:28:03+00:00","end_date":"2025-02-20T10:13:03+00:00","total_time_in_minutes":200}'

Request examples

# Headers
Authorization: Bearer {OAUTH_ACCESS_TOKEN or PERSONAL_ACCESS_TOKEN}
Content-Type: application/json
Accept: application/json

# Payload
{
  "trackable_type": "Client",
  "trackable_uuid": "5d5eaccf-15ca-4de3-8d68-b2e654bafc6c",
  "name": "Research",
  "description": "Research for the client",
  "start_date": "2025-02-20T09:28:03+00:00",
  "end_date": "2025-02-20T10:13:03+00:00",
  "total_time_in_minutes": 200
}

Response examples (200)

{
  "name": "Research",
  "uuid": "4ddf4f2a-47d5-49cf-ade2-b9181ae08c78",
  "account": {
    "name": "Gareth Thompson",
    "role": "client",
    "type": "client",
    "uuid": "0494939a-8cbf-41e7-95b7-f6a76d950bd7",
    "email": "gareth@codepotato.co.uk",
    "last_name": "Thompson",
    "photo_url": "https://eu.ui-avatars.com/api/?name=Gareth+Thompson",
    "created_at": "2025-02-20T10:13:03+00:00",
    "first_name": "Gareth",
    "updated_at": "2025-02-20T10:13:03+00:00",
    "external_references": "App\\Http\\Resources\\ExternalReferenceResource"
  },
  "end_date": "2025-02-20T09:51:03+00:00",
  "is_active": true,
  "trackable": {
    "name": "Gareth Thompson",
    "role": "client",
    "type": "client",
    "uuid": "832b61b1-73e0-4c8c-ac44-1a59666cae20",
    "email": "gareth@codepotato.co.uk",
    "last_name": "Thompson",
    "photo_url": "https://eu.ui-avatars.com/api/?name=Gareth+Thompson",
    "created_at": "2025-02-20T10:13:03+00:00",
    "first_name": "Gareth",
    "updated_at": "2025-02-20T10:13:03+00:00",
    "external_references": "App\\Http\\Resources\\ExternalReferenceResource"
  },
  "created_at": "2025-02-20T10:13:03+00:00",
  "start_date": "2025-02-20T09:23:03+00:00",
  "updated_at": "2025-02-20T10:13:03+00:00",
  "description": "This is a description.",
  "trackable_type": "Client",
  "total_time_in_minutes": 28,
  "computed_time_elapsed_in_seconds": 1680
}