vPlan
  1. Time Tracking
vPlan
  • General
    • Structure
    • Synchronize Data
    • Pagination
    • Sorting
    • Filtering
    • Show & Hide
    • Eager Loading
    • Deep Insertion
    • Deprecated
    • External Reference
    • Rate Limits
    • Authentication
      • Authentication
        • Get authorization
        • Token Exchange
      • Me
        • Retrieve information about current authentication
    • Errors
      • Empty values in created object
      • Memory Exhausted
      • Report an issue
      • Service Unavailable
      • Retrieve Api Messages
  • Endpoints
    • Base Data
      • Board
        • Label
        • Status
        • Capacity
          • Capacity Stage
          • Capacity Resource Type Stage
          • Capacity Resource
          • Capacity Group
        • View
          • Create New BoardView
        • Retrieve Board List
        • Create New Board
        • Retrieve Single Board
        • Update Single Board
        • Remove Single Board
      • Stage
        • Retrieve Stage List
        • Create New Stage
        • Retrieve Single Stage
        • Update Single Stage
        • Remove Single Stage
      • Activity
        • Retrieve Activity List
        • Create New Activity
        • Retrieve Single Activity
        • Update Single Activity
        • Remove Single Activity
      • Resource
        • Schedule
        • Schedule Deviation
          • Retrieve Deviation List
          • Create New Schedule Deviation
          • Retrieve Single Schedule Deviation
          • Update Single Schedule Deviation
          • Remove Single Schedule Deviation
        • Retrieve Resource List
        • Create New Resource
        • Retrieve Single Resource
        • Update Single Resource
        • Remove Single Resource
      • Schedule
        • Retrieve Schedule List
        • Retrieve Schedule Year
        • Retrieve Schedule Month
        • Schedule Retrieve Day
      • Group
        • Retrieve Group List
        • Create New Group
        • Retrieve Single Group
        • Update Single Group
        • Remove Single Group
      • User
        • Invite User
        • Retrieve User List
        • Retrieve Single User
        • Update Single User
    • Card Data
      • Collection
        • Custom Fields
          • Update Custom Field By Name
          • Delete Custom Field By Name
        • Retrieve Collection List
        • Create New Collection
        • Retrieve Single Collection
        • Remove Single Collection
        • Move Collection to Backlog
        • Update Single Collection
        • Move Collection to Board
      • Card
        • Custom Field
          • Update Custom Field By Name
          • Delete Custom Field By Name
        • Retrieve Card List
        • Create New Card
        • Retrieve Single Card
        • Update Single Card
        • Remove Single Card
        • Split Card
        • All Cards List
      • Attachment
        • Retrieve Attachment List
        • Upload New Attachment
        • Add New Attachment Link
        • Retrieve Single Attachment
        • Remove Single Attachment
      • Comment
        • Retrieve Comment List
        • Create New Comment
        • Retrieve Single Comment
        • Update Single Comment
        • Remove Single Comment
      • Checklist
        • Collection
          • Retrieve Collection Checklist List
          • Create New Collection Checklist
          • Retrieve Single Collection Checklist
          • Update Single Collection Checklist
          • Remove Single Collection Checklist
        • Card
          • Retrieve Card Checklist List
          • Create New Card Checklist
          • Retrieve Single Card Checklist
          • Update Single Card Checklist
          • Remove Single Card Checklist
      • Time Tracking
        • Retrieve TimeTracking List
          GET
        • Create New TimeTracking
          POST
        • Retrieve Single TimeTracking
          GET
        • Update Single TimeTracking
          PUT
        • Remove Single TimeTracking
          DELETE
        • Export TimeTracking
          GET
      • Relations between cards
        • Retrieve CardRelation List
        • Create New CardRelation
        • Retrieve Single CardRelation
        • Remove Single CardRelation
    • Order Data
      • Address
      • Order
        • Retrieve Order List
        • Create New Order
        • Retrieve Single Order
        • Update Single Order
        • Remove Single Order
      • Row
        • Retrieve OrderRow List
        • Create New OrderRow
        • Retrieve Single OrderRow
        • Update Single OrderRow
        • Remove Single OrderRow
      • Item
        • Retrieve Item List
        • Create New Item
        • Retrieve Single Item
        • Update Single Item
        • Remove Single Item
      • Project
        • Retrieve Project List
        • Create New Project
        • Retrieve Single Project
        • Update Single Project
        • Remove Single Project
      • Relation
        • Retrieve Relation List
        • Create New Relation
        • Retrieve Single Relation
        • Update Single Relation
        • Remove Single Relation
      • Warehouse
        • Retrieve Warehouse List
        • Create New Warehouse
        • Retrieve Single Warehouse
        • Update Single Warehouse
        • Remove Single Warehouse
    • Webhook
      • Retrieve Webhook List
      • Create New Webhook
      • Retrieve Single Webhook
      • Update Single Webhook
      • Remove Single Webhook
    • Payload send to webhook url
      • Normal Object
      • Nested Object
      • Nested Object with Pivot
  1. Time Tracking

Create New TimeTracking

POST
/time_tracking
Create a new TimeTracking and store it for this collection
Because oAuth is authenticated by a user, this is the user creating this time tracking.
For integrations that are not user specific, customers are advised to
create a separate user specifically for this integration.

Request

Header Params
x-api-key
string 
required
Default:
{{api_key}}
x-api-env
string 
required
Default:
{{api_env}}
Body Params application/json
start
string <date-time>
optional
end
string <date-time>
optional
duration
integer 
optional
status
enum<string> 
optional
Allowed values:
draftpendingapprovedrejected
Default:
draft
locked
boolean 
optional
note
string  | null 
optional
card_id
string <uuid>
required
Unique identifier of the Card
activity_id
string <uuid>
optional
Unique identifier of the Activity
user_id
string <uuid>
required
Unique identifier of the User
external_note
string 
optional
external_failed
boolean 
optional
Example
{
    "start": "2019-08-24T14:15:22Z",
    "end": "2019-08-24T14:15:22Z",
    "duration": 0,
    "status": "draft",
    "locked": true,
    "note": "string",
    "card_id": "66f6e46c-f6a1-4af8-a1bd-49666bc01304",
    "activity_id": "98dae057-958f-4b2f-9ed4-41f109afdc3f",
    "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5",
    "external_note": "string",
    "external_failed": true
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.vplan.com/v1/time_tracking' \
--header 'x-api-key;' \
--header 'x-api-env;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "start": "2019-08-24T14:15:22Z",
    "end": "2019-08-24T14:15:22Z",
    "duration": 0,
    "status": "draft",
    "locked": true,
    "note": "string",
    "card_id": "66f6e46c-f6a1-4af8-a1bd-49666bc01304",
    "activity_id": "98dae057-958f-4b2f-9ed4-41f109afdc3f",
    "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5",
    "external_note": "string",
    "external_failed": true
}'

Responses

🟢201Created
application/json
Body
id
string <uuid>
read-onlyoptional
Unique identifier
start
string <date-time>
optional
end
string <date-time>
optional
duration
integer 
optional
status
enum<string> 
optional
Allowed values:
draftpendingapprovedrejected
Default:
draft
locked
boolean 
optional
note
string  | null 
optional
running
boolean 
read-onlyoptional
card_id
string <uuid>
required
Unique identifier of the Card
activity_id
string <uuid>
optional
Unique identifier of the Activity
user_id
string <uuid>
required
Unique identifier of the User
external_note
string 
optional
external_failed
boolean 
optional
external_ref
string  | null 
read-onlyoptional
Third-party reference of the object, for informational purposes only
Example:
fb1033a2ed70
synchronized_at
string <date-time> | null 
read-onlyoptional
created_at
string <date-time>
read-onlyoptional
Date and time of creation
Example:
2024-04-11T10:22:15Z
updated_at
string <date-time>
read-onlyoptional
Date and time of last update
Example:
2024-04-11T10:22:15Z
Example
{
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "start": "2019-08-24T14:15:22Z",
    "end": "2019-08-24T14:15:22Z",
    "duration": 0,
    "status": "draft",
    "locked": true,
    "note": "string",
    "running": true,
    "card_id": "66f6e46c-f6a1-4af8-a1bd-49666bc01304",
    "activity_id": "98dae057-958f-4b2f-9ed4-41f109afdc3f",
    "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5",
    "external_note": "string",
    "external_failed": true,
    "external_ref": "fb1033a2ed70",
    "synchronized_at": "2019-08-24T14:15:22Z",
    "created_at": "2024-04-11T10:22:15Z",
    "updated_at": "2024-04-11T10:22:15Z"
}
🟠422Unprocessable Content
🟠401Not Logged In
Modified at 2025-05-26 13:17:47
Previous
Retrieve TimeTracking List
Next
Retrieve Single TimeTracking
Built with