Listings

Unassign a document from a checklist item. The document remains on the listing but is no longer linked to the checklist item; the checklist item returns to an unfulfilled state.

To completely remove the document, use DELETE /api/files/listings/{listingGuid}/documents/{documentGuid}.

Validation & Requirements

Required Parameters

  • listingGuid (path, string, format=guid)
  • checklistItemId (path, integer, format=int32)
  • form (body, object)

Required JSON Body Fields

  • documentGuid (format=guid, minLength=1)

Validations

  • Invalid GUID values in *Guid/*Guids fields return 422 Unprocessable Entity.
  • Invalid date values in *date* fields return 422 Unprocessable Entity.
  • Missing required request body returns 422 Unprocessable Entity with Missing request body..
  • Additional business-rule validation may return 422 with details in the errors array.

Integration Requirement

  • Retrieve the corresponding ...Form endpoint immediately before write operations to get current dynamic required fields and allowed values.
post/api/files/listings/{listingGuid}/checklist-items/{checklistItemId}/unassign

Path parameters

listingGuidstring guid required

The listing GUID.

checklistItemIdinteger required

The ActivityId of the checklist item (from the listing's checklist array).

Request body

documentGuidstring guid required

Existing document guid.

Response

warningsstring[] nullable