Manual Time Requests

List and approve/deny manual time entry requests

Endpoints

GET/v2/manual_time_requests/{manual_time_request_id}
PUT/v2/manual_time_requests/{manual_time_request_id}/status
GET/v2/organizations/{organization_id}/manual_time_requests

Get manual time request

GET/v2/manual_time_requests/{manual_time_request_id}

Returns the manual time request with the given ID.

Parameters

Name	In	Type	Description
manual_time_request_idrequired	path	integer (int32)

Responses

200—

object

manual_time_requestobject
object
ManualTimeRequest model
- idinteger required
  Manual time request ID
- member_idinteger required
  Member (user) ID who submitted the request
- project_idinteger required
  Project ID
- task_idinteger
  Task ID if associated with a task
- start_timestring required
  Start time of the manual time entry
- stop_timestring required
  Stop time of the manual time entry
- submitted_atstring required
  When the request was submitted
- approved_atstring
  When the request was approved
- denied_atstring
  When the request was denied
- duration_secondsinteger required
  Duration in seconds
- notesstring
  Notes for the time entry
- statusstring required
  Status: submitted, approved, or denied
- reviewer_idinteger
  ID of user who approved or denied (approved_by when approved, denied_by when denied)
- denial_reasonstring
  Reason for denial (only present when status is denied)
- organization_idinteger required
  Organization ID
- datestring required
  Calendar date (org tz) from start_time. The list date[] filter is overlap on starts/stops (in_range).
- billableboolean required
  Whether the time is billable
- reason_to_submitstring required
  Reason the manual time was submitted
- submitted_by_idinteger required
  User ID who submitted the request
- approved_by_idinteger
  User ID who approved the request
- denied_by_idinteger
  User ID who denied the request
- attachment_original_filenamestring
  Original filename of attachment if present
- created_atstring required
  When the record was created
- updated_atstring required
  When the record was last updated

Example response

json

{
  "manual_time_request": {
    "id": 0,
    "member_id": 0,
    "project_id": 0,
    "task_id": 0,
    "start_time": "2024-01-15T10:30:00Z",
    "stop_time": "2024-01-15T10:30:00Z",
    "submitted_at": "2024-01-15T10:30:00Z",
    "approved_at": "2024-01-15T10:30:00Z",
    "denied_at": "2024-01-15T10:30:00Z",
    "duration_seconds": 0,
    "notes": "string",
    "status": "string",
    "reviewer_id": 0,
    "denial_reason": "string",
    "organization_id": 0,
    "date": "2024-01-15",
    "billable": false,
    "reason_to_submit": "string",
    "submitted_by_id": 0,
    "approved_by_id": 0,
    "denied_by_id": 0,
    "attachment_original_filename": "string",
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-15T10:30:00Z"
  }
}

400Invalid parameters

object

Hubstaff_Public_V2_Entities_Error model

codestring required
Legacy string error code for backward compatibility
error_codeinteger
Numeric error code for i18n/programmatic handling. Ranges: 10000-10999 (Auth), 11000-11999 (Validation), 12000-12999 (Resource), 13000-13999 (Rate Limit), 14000-14999 (Time Entry/Activity), 15000-15999 (System). See GET /v2/error_codes for full reference.
errorstring required
Human-readable error message
detailsarray
Per-attribute validation errors: [{attribute, error}]. Present on validation failures.
array<string>
Per-attribute validation errors: [{attribute, error}]. Present on validation failures.
items
string

Example response

json

{
  "code": "string",
  "error_code": 0,
  "error": "string",
  "details": [
    "string"
  ]
}

401Unauthorized

object

Hubstaff_Public_V2_Entities_Error model

codestring required
Legacy string error code for backward compatibility
error_codeinteger
Numeric error code for i18n/programmatic handling. Ranges: 10000-10999 (Auth), 11000-11999 (Validation), 12000-12999 (Resource), 13000-13999 (Rate Limit), 14000-14999 (Time Entry/Activity), 15000-15999 (System). See GET /v2/error_codes for full reference.
errorstring required
Human-readable error message
detailsarray
Per-attribute validation errors: [{attribute, error}]. Present on validation failures.
array<string>
Per-attribute validation errors: [{attribute, error}]. Present on validation failures.
items
string

Example response

json

{
  "code": "string",
  "error_code": 0,
  "error": "string",
  "details": [
    "string"
  ]
}

403API access is only for organizations on an active plan

object

Hubstaff_Public_V2_Entities_Error model

codestring required
Legacy string error code for backward compatibility
error_codeinteger
Numeric error code for i18n/programmatic handling. Ranges: 10000-10999 (Auth), 11000-11999 (Validation), 12000-12999 (Resource), 13000-13999 (Rate Limit), 14000-14999 (Time Entry/Activity), 15000-15999 (System). See GET /v2/error_codes for full reference.
errorstring required
Human-readable error message
detailsarray
Per-attribute validation errors: [{attribute, error}]. Present on validation failures.
array<string>
Per-attribute validation errors: [{attribute, error}]. Present on validation failures.
items
string

Example response

json

{
  "code": "string",
  "error_code": 0,
  "error": "string",
  "details": [
    "string"
  ]
}

404Could not find record

object

Hubstaff_Public_V2_Entities_Error model

codestring required
Legacy string error code for backward compatibility
error_codeinteger
Numeric error code for i18n/programmatic handling. Ranges: 10000-10999 (Auth), 11000-11999 (Validation), 12000-12999 (Resource), 13000-13999 (Rate Limit), 14000-14999 (Time Entry/Activity), 15000-15999 (System). See GET /v2/error_codes for full reference.
errorstring required
Human-readable error message
detailsarray
Per-attribute validation errors: [{attribute, error}]. Present on validation failures.
array<string>
Per-attribute validation errors: [{attribute, error}]. Present on validation failures.
items
string

Example response

json

{
  "code": "string",
  "error_code": 0,
  "error": "string",
  "details": [
    "string"
  ]
}

429Rate limit exceeded

object

Hubstaff_Public_V2_Entities_Error model

codestring required
Legacy string error code for backward compatibility
error_codeinteger
Numeric error code for i18n/programmatic handling. Ranges: 10000-10999 (Auth), 11000-11999 (Validation), 12000-12999 (Resource), 13000-13999 (Rate Limit), 14000-14999 (Time Entry/Activity), 15000-15999 (System). See GET /v2/error_codes for full reference.
errorstring required
Human-readable error message
detailsarray
Per-attribute validation errors: [{attribute, error}]. Present on validation failures.
array<string>
Per-attribute validation errors: [{attribute, error}]. Present on validation failures.
items
string

Example response

json

{
  "code": "string",
  "error_code": 0,
  "error": "string",
  "details": [
    "string"
  ]
}

Update manual time request status

PUT/v2/manual_time_requests/{manual_time_request_id}/status

Approves or denies a submitted manual time request.

Parameters

Name	In	Type	Description
manual_time_request_idrequired	path	integer (int32)

Request body

object

Update manual time request status

statusstring required
New status for the request: approved or denied.
denial_reasonstring
Required when status is denied. Reason recorded on the request.
accept_collisionsboolean
Confirm approval when the request overlaps existing time the approver is authorized to override. Covers ordinary tracked-time collisions and associated data within role permissions: unprocessed paid time, client invoices, user invoices, timesheets, and integration-synced time. May remove time from unprocessed payments and leave invoices or integrations out of sync.
allow_above_project_budgetboolean
Allow approval when the created activity would exceed the project budget only.
discard_exceeding_hoursboolean
Approve only time within member limits. Cannot be combined with increase_limit.
increase_limitboolean
Automatically increase exceeded daily and weekly member limits. Organization owners and managers only.

Responses

200—

object

manual_time_requestobject
object
ManualTimeRequest model
- idinteger required
  Manual time request ID
- member_idinteger required
  Member (user) ID who submitted the request
- project_idinteger required
  Project ID
- task_idinteger
  Task ID if associated with a task
- start_timestring required
  Start time of the manual time entry
- stop_timestring required
  Stop time of the manual time entry
- submitted_atstring required
  When the request was submitted
- approved_atstring
  When the request was approved
- denied_atstring
  When the request was denied
- duration_secondsinteger required
  Duration in seconds
- notesstring
  Notes for the time entry
- statusstring required
  Status: submitted, approved, or denied
- reviewer_idinteger
  ID of user who approved or denied (approved_by when approved, denied_by when denied)
- denial_reasonstring
  Reason for denial (only present when status is denied)
- organization_idinteger required
  Organization ID
- datestring required
  Calendar date (org tz) from start_time. The list date[] filter is overlap on starts/stops (in_range).
- billableboolean required
  Whether the time is billable
- reason_to_submitstring required
  Reason the manual time was submitted
- submitted_by_idinteger required
  User ID who submitted the request
- approved_by_idinteger
  User ID who approved the request
- denied_by_idinteger
  User ID who denied the request
- attachment_original_filenamestring
  Original filename of attachment if present
- created_atstring required
  When the record was created
- updated_atstring required
  When the record was last updated

Example response

json

{
  "manual_time_request": {
    "id": 0,
    "member_id": 0,
    "project_id": 0,
    "task_id": 0,
    "start_time": "2024-01-15T10:30:00Z",
    "stop_time": "2024-01-15T10:30:00Z",
    "submitted_at": "2024-01-15T10:30:00Z",
    "approved_at": "2024-01-15T10:30:00Z",
    "denied_at": "2024-01-15T10:30:00Z",
    "duration_seconds": 0,
    "notes": "string",
    "status": "string",
    "reviewer_id": 0,
    "denial_reason": "string",
    "organization_id": 0,
    "date": "2024-01-15",
    "billable": false,
    "reason_to_submit": "string",
    "submitted_by_id": 0,
    "approved_by_id": 0,
    "denied_by_id": 0,
    "attachment_original_filename": "string",
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-15T10:30:00Z"
  }
}

400Invalid parameters

object

Hubstaff_Public_V2_Entities_Error model

codestring required
Legacy string error code for backward compatibility
error_codeinteger
Numeric error code for i18n/programmatic handling. Ranges: 10000-10999 (Auth), 11000-11999 (Validation), 12000-12999 (Resource), 13000-13999 (Rate Limit), 14000-14999 (Time Entry/Activity), 15000-15999 (System). See GET /v2/error_codes for full reference.
errorstring required
Human-readable error message
detailsarray
Per-attribute validation errors: [{attribute, error}]. Present on validation failures.
array<string>
Per-attribute validation errors: [{attribute, error}]. Present on validation failures.
items
string

Example response

json

{
  "code": "string",
  "error_code": 0,
  "error": "string",
  "details": [
    "string"
  ]
}

401Unauthorized

object

Hubstaff_Public_V2_Entities_Error model

codestring required
Legacy string error code for backward compatibility
error_codeinteger
Numeric error code for i18n/programmatic handling. Ranges: 10000-10999 (Auth), 11000-11999 (Validation), 12000-12999 (Resource), 13000-13999 (Rate Limit), 14000-14999 (Time Entry/Activity), 15000-15999 (System). See GET /v2/error_codes for full reference.
errorstring required
Human-readable error message
detailsarray
Per-attribute validation errors: [{attribute, error}]. Present on validation failures.
array<string>
Per-attribute validation errors: [{attribute, error}]. Present on validation failures.
items
string

Example response

json

{
  "code": "string",
  "error_code": 0,
  "error": "string",
  "details": [
    "string"
  ]
}

403API access is only for organizations on an active plan

object

Hubstaff_Public_V2_Entities_Error model

codestring required
Legacy string error code for backward compatibility
error_codeinteger
Numeric error code for i18n/programmatic handling. Ranges: 10000-10999 (Auth), 11000-11999 (Validation), 12000-12999 (Resource), 13000-13999 (Rate Limit), 14000-14999 (Time Entry/Activity), 15000-15999 (System). See GET /v2/error_codes for full reference.
errorstring required
Human-readable error message
detailsarray
Per-attribute validation errors: [{attribute, error}]. Present on validation failures.
array<string>
Per-attribute validation errors: [{attribute, error}]. Present on validation failures.
items
string

Example response

json

{
  "code": "string",
  "error_code": 0,
  "error": "string",
  "details": [
    "string"
  ]
}

404Could not find record

object

Hubstaff_Public_V2_Entities_Error model

codestring required
Legacy string error code for backward compatibility
error_codeinteger
Numeric error code for i18n/programmatic handling. Ranges: 10000-10999 (Auth), 11000-11999 (Validation), 12000-12999 (Resource), 13000-13999 (Rate Limit), 14000-14999 (Time Entry/Activity), 15000-15999 (System). See GET /v2/error_codes for full reference.
errorstring required
Human-readable error message
detailsarray
Per-attribute validation errors: [{attribute, error}]. Present on validation failures.
array<string>
Per-attribute validation errors: [{attribute, error}]. Present on validation failures.
items
string

Example response

json

{
  "code": "string",
  "error_code": 0,
  "error": "string",
  "details": [
    "string"
  ]
}

429Rate limit exceeded

object

Hubstaff_Public_V2_Entities_Error model

codestring required
Legacy string error code for backward compatibility
error_codeinteger
Numeric error code for i18n/programmatic handling. Ranges: 10000-10999 (Auth), 11000-11999 (Validation), 12000-12999 (Resource), 13000-13999 (Rate Limit), 14000-14999 (Time Entry/Activity), 15000-15999 (System). See GET /v2/error_codes for full reference.
errorstring required
Human-readable error message
detailsarray
Per-attribute validation errors: [{attribute, error}]. Present on validation failures.
array<string>
Per-attribute validation errors: [{attribute, error}]. Present on validation failures.
items
string

Example response

json

{
  "code": "string",
  "error_code": 0,
  "error": "string",
  "details": [
    "string"
  ]
}

List manual time requests

GET/v2/organizations/{organization_id}/manual_time_requests

Date range filter (date[start]/date[stop]) returns requests whose time span overlaps the given organization-local dates: it converts the dates to the org’s day range and applies in_range (overlap on starts_at/stops_at). This is not an exact filter on the date response field (see entity docs). Overnight entries or tz shifts may cause an entry to overlap a date even if its date column differs. Both bounds are required (otherwise 400).

Parameters

Name	In	Type	Description
organization_idrequired	path	integer (int32)
page_start_id	query	integer (int32)	The page start ID.
page_limit	query	integer (int32)	The default page size
date[start]	query	string (date)	Start date (ISO 8601)
date[stop]	query	string (date)	Stop date (ISO 8601, Inclusive)
updated_at[start]	query	string (date-time)
updated_at[stop]	query	string (date-time)
status	query	string	Possible values`submittedapproveddenied`
user_ids	query	array integer[]	List of user IDs
project_ids	query	array integer[]	List of project IDs
task_ids	query	array integer[]	List of task IDs
team_ids	query	array integer[]	List of team IDs
include	query	array string[]	Specify related data to side load. Possible values`usersprojectstasks`

Responses

200—

object

manual_time_requestsarray
array<object>
items
object
ManualTimeRequest model
- idinteger required
  Manual time request ID
- member_idinteger required
  Member (user) ID who submitted the request
- project_idinteger required
  Project ID
- task_idinteger
  Task ID if associated with a task
- start_timestring required
  Start time of the manual time entry
- stop_timestring required
  Stop time of the manual time entry
- submitted_atstring required
  When the request was submitted
- approved_atstring
  When the request was approved
- denied_atstring
  When the request was denied
- duration_secondsinteger required
  Duration in seconds
- notesstring
  Notes for the time entry
- statusstring required
  Status: submitted, approved, or denied
- reviewer_idinteger
  ID of user who approved or denied (approved_by when approved, denied_by when denied)
- denial_reasonstring
  Reason for denial (only present when status is denied)
- organization_idinteger required
  Organization ID
- datestring required
  Calendar date (org tz) from start_time. The list date[] filter is overlap on starts/stops (in_range).
- billableboolean required
  Whether the time is billable
- reason_to_submitstring required
  Reason the manual time was submitted
- submitted_by_idinteger required
  User ID who submitted the request
- approved_by_idinteger
  User ID who approved the request
- denied_by_idinteger
  User ID who denied the request
- attachment_original_filenamestring
  Original filename of attachment if present
- created_atstring required
  When the record was created
- updated_atstring required
  When the record was last updated

Example response

json

{
  "manual_time_requests": [
    {
      "id": 0,
      "member_id": 0,
      "project_id": 0,
      "task_id": 0,
      "start_time": "2024-01-15T10:30:00Z",
      "stop_time": "2024-01-15T10:30:00Z",
      "submitted_at": "2024-01-15T10:30:00Z",
      "approved_at": "2024-01-15T10:30:00Z",
      "denied_at": "2024-01-15T10:30:00Z",
      "duration_seconds": 0,
      "notes": "string",
      "status": "string",
      "reviewer_id": 0,
      "denial_reason": "string",
      "organization_id": 0,
      "date": "2024-01-15",
      "billable": false,
      "reason_to_submit": "string",
      "submitted_by_id": 0,
      "approved_by_id": 0,
      "denied_by_id": 0,
      "attachment_original_filename": "string",
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T10:30:00Z"
    }
  ]
}

400Invalid parameters

object

Hubstaff_Public_V2_Entities_Error model

codestring required
Legacy string error code for backward compatibility
error_codeinteger
Numeric error code for i18n/programmatic handling. Ranges: 10000-10999 (Auth), 11000-11999 (Validation), 12000-12999 (Resource), 13000-13999 (Rate Limit), 14000-14999 (Time Entry/Activity), 15000-15999 (System). See GET /v2/error_codes for full reference.
errorstring required
Human-readable error message
detailsarray
Per-attribute validation errors: [{attribute, error}]. Present on validation failures.
array<string>
Per-attribute validation errors: [{attribute, error}]. Present on validation failures.
items
string

Example response

json

{
  "code": "string",
  "error_code": 0,
  "error": "string",
  "details": [
    "string"
  ]
}

401Unauthorized

object

Hubstaff_Public_V2_Entities_Error model

codestring required
Legacy string error code for backward compatibility
error_codeinteger
Numeric error code for i18n/programmatic handling. Ranges: 10000-10999 (Auth), 11000-11999 (Validation), 12000-12999 (Resource), 13000-13999 (Rate Limit), 14000-14999 (Time Entry/Activity), 15000-15999 (System). See GET /v2/error_codes for full reference.
errorstring required
Human-readable error message
detailsarray
Per-attribute validation errors: [{attribute, error}]. Present on validation failures.
array<string>
Per-attribute validation errors: [{attribute, error}]. Present on validation failures.
items
string

Example response

json

{
  "code": "string",
  "error_code": 0,
  "error": "string",
  "details": [
    "string"
  ]
}

403API access is only for organizations on an active plan

object

Hubstaff_Public_V2_Entities_Error model

codestring required
Legacy string error code for backward compatibility
error_codeinteger
Numeric error code for i18n/programmatic handling. Ranges: 10000-10999 (Auth), 11000-11999 (Validation), 12000-12999 (Resource), 13000-13999 (Rate Limit), 14000-14999 (Time Entry/Activity), 15000-15999 (System). See GET /v2/error_codes for full reference.
errorstring required
Human-readable error message
detailsarray
Per-attribute validation errors: [{attribute, error}]. Present on validation failures.
array<string>
Per-attribute validation errors: [{attribute, error}]. Present on validation failures.
items
string

Example response

json

{
  "code": "string",
  "error_code": 0,
  "error": "string",
  "details": [
    "string"
  ]
}

404Could not find record

object

Hubstaff_Public_V2_Entities_Error model

codestring required
Legacy string error code for backward compatibility
error_codeinteger
Numeric error code for i18n/programmatic handling. Ranges: 10000-10999 (Auth), 11000-11999 (Validation), 12000-12999 (Resource), 13000-13999 (Rate Limit), 14000-14999 (Time Entry/Activity), 15000-15999 (System). See GET /v2/error_codes for full reference.
errorstring required
Human-readable error message
detailsarray
Per-attribute validation errors: [{attribute, error}]. Present on validation failures.
array<string>
Per-attribute validation errors: [{attribute, error}]. Present on validation failures.
items
string

Example response

json

{
  "code": "string",
  "error_code": 0,
  "error": "string",
  "details": [
    "string"
  ]
}

429Rate limit exceeded

object

Hubstaff_Public_V2_Entities_Error model

codestring required
Legacy string error code for backward compatibility
error_codeinteger
Numeric error code for i18n/programmatic handling. Ranges: 10000-10999 (Auth), 11000-11999 (Validation), 12000-12999 (Resource), 13000-13999 (Rate Limit), 14000-14999 (Time Entry/Activity), 15000-15999 (System). See GET /v2/error_codes for full reference.
errorstring required
Human-readable error message
detailsarray
Per-attribute validation errors: [{attribute, error}]. Present on validation failures.
array<string>
Per-attribute validation errors: [{attribute, error}]. Present on validation failures.
items
string

Example response

json

{
  "code": "string",
  "error_code": 0,
  "error": "string",
  "details": [
    "string"
  ]
}