POST api/progression/sales/instructtosell

Instructs a role to be sold Processes this sales progression API request. The parameter and response sections describe the data exchanged with the API.

Request Information

URI Parameters

None.

Body Parameters

Details of the instruction

InstructToSellCommandDataContract

Name	Description	Type	Additional information
RoleId	The unique identifier of the related role resource.	integer	None.
ActualMarketingPrice	The actual marketing price value.	decimal number	None.
TeamId	The unique identifier of the related team resource.	integer	None.
PutOnMarket	Indicates whether put on market is true.	boolean	None.
InstructedDateTime	The instructed date time, expressed as a date and time.	date	None.
NegotiatorIds	The unique identifiers of the related negotiator resources.	Collection of integer	None.
LeaseType	The lease type value.	EnumDataContract	None.
ValidEpcInPlace	Indicates whether valid epc in place is true.	boolean	None.
ProofOfIdReceived	Indicates whether proof of id received is true.	boolean	None.
ProofOfOwnershipReceived	Indicates whether proof of ownership received is true.	boolean	None.
BranchId	The unique identifier of the related branch resource.	integer	None.
ExternalCompanyInstructorId	The unique identifier of the related external company instructor resource.	integer	None.
AgencyPeriod	The agency period value.	EnumDataContract	None.
PriceText	The price text value.	string	None.
PriceOnApplication	Indicates whether price on application is true.	boolean	None.
PriceQualifier	The price qualifier value.	EnumDataContract	None.
SendToPortal	Indicates whether send to portal is true.	boolean	None.

Request Formats

application/x-www-form-urlencoded

Sample:

Sample not available.

application/json, text/json

Sample:

{
  "RoleId": 1,
  "ActualMarketingPrice": 2.1,
  "TeamId": 3,
  "PutOnMarket": true,
  "InstructedDateTime": "2026-07-23T08:18:56.3301692Z",
  "NegotiatorIds": [
    1,
    2
  ],
  "LeaseType": {
    "Id": 1,
    "Name": "sample string 2",
    "SystemName": "sample string 3"
  },
  "ValidEpcInPlace": true,
  "ProofOfIdReceived": true,
  "ProofOfOwnershipReceived": true,
  "BranchId": 1,
  "ExternalCompanyInstructorId": 1,
  "AgencyPeriod": {
    "Id": 1,
    "Name": "sample string 2",
    "SystemName": "sample string 3"
  },
  "PriceText": "sample string 5",
  "PriceOnApplication": true,
  "PriceQualifier": {
    "Id": 1,
    "Name": "sample string 2",
    "SystemName": "sample string 3"
  },
  "SendToPortal": true
}

Response Information

Resource Description

The response returned after the operation completes.

InstructionToSellDataContract

Name	Description	Type	Additional information
ExternalCompanyInstructorId	The unique identifier of the related external company instructor resource.	integer	None.
Team	The team value.	EventTeamDataContract	None.
Notes	The collection of notes.	Collection of EventNoteCommandDataContract	None.
Documents	The collection of documents.	Collection of DocumentDataContract	None.
Name	The name value.	string	None.
Description	The description value.	string	None.
DateTime	The date time, expressed as a date and time.	date	None.
EventCategory	The event category value.	EnumDataContract	None.
EventType	The event type value.	EnumDataContract	None.
EventStatus	The event status value.	EnumDataContract	None.
Negotiators	The collection of negotiators.	Collection of ListNegotiatorDataContract	None.
BranchId	The unique identifier of the related branch resource.	integer	None.
OwningTeamId	The unique identifier of the related owning team resource.	integer	None.
TeamAccessType	The team access type value.	string	None.
CustomFields	The collection of custom fields.	Collection of CustomFieldGroupWithValuesDataContract	None.
CreatedDate	The created date, expressed as a date and time.	date	None.
CreatedBy	The created by value.	CreatedByDataContract	None.
Id	The unique identifier of this resource.	integer	None.

Response Formats

application/json

Sample:

Sample not available.

text/json

Sample:

Sample not available.