latestOpenAPI 3.0.02026-08-12207455917.9 KB

bad0d2db9b7a

Listing Documents

Update listing document

Patches listing document metadata. Supports fileName and folder updates.

Validation & Requirements

Required Parameters

  • listingGuid (path, string, format=guid)
  • documentGuid (path, string, format=guid)

Required JSON Body Fields

  • None

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.
patch/api/files/listings/{listingGuid}/documents/{documentGuid}

Path parameters

listingGuidstring guid required

GUID of the listing that owns the document.

documentGuidstring guid required

GUID of the document to update.

Query parameters

FileNamestring nullable

The filename of the document

Folderstring nullable

Can be Admin or Trash or null

Response

warningsstring[] nullable