---
schema_version: "1"
id: db34905717c8fc9f75536fbcb42957539a4743c3ad238bb5dee5f9aed02027bf
title: Handle Resource Absence Action
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/health_cloud_object_reference/actions_obj_handle_resource_absence.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/actions_obj_handle_resource_absence.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: ffb2efd4b17de27e7bdd2f953480c0f7a7e38ea37c9cf8d4847db3815f6a62e7
description: Remove a service resource’s visit assignments for a specified period and optionally update the status of the affected visits to a specified value.
---
# Handle Resource Absence Action

Remove a service resource’s visit assignments for a specified period and optionally update the status of the affected visits to a specified value.

This action is available in API version 58.0 and later.

## Special Access Rules

The Remove Visit Assignments action is available in Enterprise and Unlimited Editions with Health Cloud enabled with the Home Health setting.

## Supported REST HTTP Methods

**URI**: /services/data/vXX.X/actions/standard/handleResourceAbsence

Where XX.X is the latest API version.

**Formats**: JSON, XML

**HTTP Methods**: POST

**Authentication**: Authorization: Bearer TOKEN

Where TOKEN is your OAuth access token.

## Inputs

<table class="featureTable sort_table" summary="">



          <thead class="thead sorted" align="left">
            <tr>
              <th class="featureTableHeader  " id="d309621e107">Input</th>

              <th class="featureTableHeader  " id="d309621e110">Type</th>

              <th class="featureTableHeader  " id="d309621e113">Description</th>

            </tr>

          </thead>

          <tbody class="tbody">
            <tr>
              <td class="entry" headers="d309621e107" data-title="Input"><span class="keyword parmname">endDateTime</span></td>

              <td class="entry" headers="d309621e110" data-title="Type">datetime</td>

              <td class="entry" headers="d309621e113" data-title="Description">Required.<p class="p">End date and time of the period to remove service
                  resource assignments from home visits.</p>
              </td>

            </tr>

            <tr>
              <td class="entry" headers="d309621e107" data-title="Input"><span class="keyword parmname">newServiceAppointmentStatus</span></td>

              <td class="entry" headers="d309621e110" data-title="Type">string</td>

              <td class="entry" headers="d309621e113" data-title="Description">Status of affected service appointments after the
                service resource has been removed.</td>

            </tr>

            <tr>
              <td class="entry" headers="d309621e107" data-title="Input"><span class="keyword parmname">serviceResourceId</span></td>

              <td class="entry" headers="d309621e110" data-title="Type">string</td>

              <td class="entry" headers="d309621e113" data-title="Description">Required.<p class="p">ID of the service resource record to remove from home
                  visits.</p>
              </td>

            </tr>

            <tr>
              <td class="entry" headers="d309621e107" data-title="Input"><span class="keyword parmname">startDateTime</span></td>

              <td class="entry" headers="d309621e110" data-title="Type">datetime</td>

              <td class="entry" headers="d309621e113" data-title="Description">Required.<p class="p">Start date and time of the period to remove service
                  resource assignments from home visits.</p>
              </td>

            </tr>

          </tbody>

        </table>

## Outputs

None.

## Example

**POST**

This sample request is for the Handle Resource Absence action.

{ 
  "inputs" : \[
    {
      "endDateTime" : "2023-07-04T12:15:45.200-700",
      "newServiceAppointmentStatus" : "Resolved",
      "serviceResourceId" : "0Hnxx0000004C92CAE",
      "startDateTime" : "2023-07-04T11:00:56.235-700"
    }
  \]
}

This sample response is for the Handle Resource Absence action.

\[ {
  "actionName" : "handleResourceAbsence",
  "errors" : null,
  "isSuccess" : true,
  "outputValues" : null,
  "version" : 1
} \]