Sign in

v1

latestOpenAPI 3.1.02026-07-1274177461.2 KB
Employees
Tasks

Get Employee Task

get/unified/hris/employees/{id}/tasks/{subResourceId}

Path parameters

idstring required
subResourceIdstring required

Query parameters

rawboolean nullable

Indicates that the raw request result should be returned in addition to the mapped result (default value is false)

proxyobject nullable

Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key

fieldsstring nullable
Example:id,remote_id,employee_id,remote_employee_id,name,description,type,status,due_date,completion_date,assigned_by_employee_id,remote_assigned_by_employee_id,assigned_by_employee_name,link_to_task,extracted_links,next_task_id,remote_next_task_id,parent_process_name,comments,attachments,created_at,updated_at,unified_custom_fields

The comma separated list of fields that will be returned in the response (if empty, all fields are returned)

expandstring nullable
Example:attachments

The comma separated list of fields that will be expanded in the response

Headers

x-account-idstring required

The account identifier

Preferstring
Example:heartbeat

Set to "heartbeat" to enable keep-alive newline heartbeats during long-running requests. Response includes Preference-Applied: heartbeat header when honored. (RFC 7240)

Response

The task with the given identifier for the employee was retrieved.

Example response

{
  "data": {
    "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
    "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
    "employee_id": "cx280928937",
    "name": "Complete onboarding documents",
    "description": "Please complete all required onboarding documents in the employee portal",
    "type": {
      "value": "action"
    },
    "status": {
      "value": "open"
    },
    "due_date": "2024-03-20T23:59:59.000Z",
    "completion_date": "2024-03-19T15:30:00.000Z",
    "assigned_by_employee_id": "cx280928938",
    "assigned_by_employee_name": "John Smith",
    "link_to_task": "https://provider.com/tasks/123",
    "extracted_links": [
      "https://provider.com/docs/1",
      "https://provider.com/forms/2"
    ],
    "next_task_id": "cx280928939",
    "parent_process_name": "Onboarding Tasks",
    "comments": [
      {
        "comment": "Approved based on in-person assessment",
        "created_at": "2024-03-15T10:00:00.000Z"
      }
    ],
    "attachments": [
      {
        "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
        "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
        "name": "My Document",
        "contents": [
          {
            "url": "https://example.com/file.pdf",
            "unified_url": "https://api.stackone.com/unified/hris/employees/12345/documents/67890/download",
            "file_format": {
              "value": "pdf"
            }
          }
        ],
        "category_id": "6530",
        "created_at": "2021-01-01T01:01:01.000Z",
        "updated_at": "2021-01-02T01:01:01.000Z",
        "remote_url": "https://example.com/file.pdf",
        "file_format": {
          "value": "pdf"
        }
      }
    ],
    "created_at": "2024-03-15T10:00:00.000Z",
    "updated_at": "2024-03-19T15:30:00.000Z"
  }
}