| Requires any of the permissions: | DISPATCH:HAUL:MANAGE, DISPATCH:JOB:MANAGE, DISPATCH:ONDEMAND:MANAGE |
| POST,OPTIONS | /v1/dispatch/holds |
|---|
"use strict";
export class DispatchHoldView {
/** @param {{HoldId?:number,Code?:string,ScopeKind?:string,ScopeKey?:string,ScopeLabel?:string,Reason?:string,Note?:string,StartUtc?:string,EndUtc?:string,Source?:string,IncidentRef?:string,LiftedUtc?:string,LiftedBy?:string,CreatedUtc?:string,CreatedBy?:string,Status?:string}} [init] */
constructor(init) { Object.assign(this, init) }
/** @type {number} */
HoldId;
/** @type {string} */
Code;
/** @type {string} */
ScopeKind;
/** @type {string} */
ScopeKey;
/** @type {string} */
ScopeLabel;
/** @type {string} */
Reason;
/** @type {string} */
Note;
/** @type {string} */
StartUtc;
/** @type {string} */
EndUtc;
/** @type {string} */
Source;
/** @type {string} */
IncidentRef;
/** @type {?string} */
LiftedUtc;
/** @type {string} */
LiftedBy;
/** @type {?string} */
CreatedUtc;
/** @type {string} */
CreatedBy;
/** @type {string} */
Status;
}
export class DispatchOfflineWindowView {
/** @param {{OfflineWindowId?:number,FromHour?:string,ToHour?:string}} [init] */
constructor(init) { Object.assign(this, init) }
/** @type {number} */
OfflineWindowId;
/** @type {string} */
FromHour;
/** @type {string} */
ToHour;
}
export class DispatchHoldScopeView {
/** @param {{Kind?:string,Key?:string,Label?:string}} [init] */
constructor(init) { Object.assign(this, init) }
/** @type {string} */
Kind;
/** @type {string} */
Key;
/** @type {string} */
Label;
}
export class DispatchHoldSuggestionView {
/** @param {{ForDate?:string,Kind?:string,Severity?:number,Headline?:string,DayLabel?:string,ScopeKind?:string,ScopeLabel?:string,Reason?:string,StartUtc?:string,EndUtc?:string,WindowLocal?:string,Text?:string}} [init] */
constructor(init) { Object.assign(this, init) }
/** @type {string} */
ForDate;
/** @type {string} */
Kind;
/** @type {number} */
Severity;
/** @type {string} */
Headline;
/** @type {string} */
DayLabel;
/** @type {string} */
ScopeKind;
/** @type {string} */
ScopeLabel;
/** @type {string} */
Reason;
/** @type {string} */
StartUtc;
/** @type {string} */
EndUtc;
/** @type {string} */
WindowLocal;
/** @type {string} */
Text;
}
export class DispatchHoldsResponse {
/** @param {{Holds?:DispatchHoldView[],Windows?:DispatchOfflineWindowView[],Scopes?:DispatchHoldScopeView[],Suggestion?:DispatchHoldSuggestionView,ResponseStatus?:ResponseStatus}} [init] */
constructor(init) { Object.assign(this, init) }
/** @type {DispatchHoldView[]} */
Holds = [];
/** @type {DispatchOfflineWindowView[]} */
Windows = [];
/** @type {DispatchHoldScopeView[]} */
Scopes = [];
/** @type {DispatchHoldSuggestionView} */
Suggestion;
/** @type {ResponseStatus} */
ResponseStatus;
}
export class DispatchHoldCreateRequest {
/** @param {{ScopeKind?:string,ScopeKey?:string,ScopeLabel?:string,Reason?:string,Note?:string,StartUtc?:string,EndUtc?:string,SuggestionDate?:string,SuggestionKind?:string}} [init] */
constructor(init) { Object.assign(this, init) }
/** @type {string} */
ScopeKind;
/** @type {string} */
ScopeKey;
/** @type {string} */
ScopeLabel;
/** @type {string} */
Reason;
/** @type {string} */
Note;
/** @type {string} */
StartUtc;
/** @type {string} */
EndUtc;
/** @type {string} */
SuggestionDate;
/** @type {string} */
SuggestionKind;
}
JavaScript DispatchHoldCreateRequest DTOs
To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
POST /v1/dispatch/holds HTTP/1.1
Host: api.dev.dynamics.trendsic.com
Accept: application/xml
Content-Type: application/xml
Content-Length: length
<DispatchHoldCreateRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/CRM.AgencyPlatform.API.Internal">
<EndUtc>String</EndUtc>
<Note>String</Note>
<Reason>String</Reason>
<ScopeKey>String</ScopeKey>
<ScopeKind>String</ScopeKind>
<ScopeLabel>String</ScopeLabel>
<StartUtc>String</StartUtc>
<SuggestionDate>String</SuggestionDate>
<SuggestionKind>String</SuggestionKind>
</DispatchHoldCreateRequest>
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length
<DispatchHoldsResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/CRM.AgencyPlatform.API.Internal">
<Holds>
<DispatchHoldView>
<Code>String</Code>
<CreatedBy>String</CreatedBy>
<CreatedUtc>0001-01-01T00:00:00</CreatedUtc>
<EndUtc>0001-01-01T00:00:00</EndUtc>
<HoldId>0</HoldId>
<IncidentRef>String</IncidentRef>
<LiftedBy>String</LiftedBy>
<LiftedUtc>0001-01-01T00:00:00</LiftedUtc>
<Note>String</Note>
<Reason>String</Reason>
<ScopeKey>String</ScopeKey>
<ScopeKind>String</ScopeKind>
<ScopeLabel>String</ScopeLabel>
<Source>String</Source>
<StartUtc>0001-01-01T00:00:00</StartUtc>
<Status>String</Status>
</DispatchHoldView>
</Holds>
<ResponseStatus xmlns:d2p1="http://schemas.servicestack.net/types">
<d2p1:ErrorCode>String</d2p1:ErrorCode>
<d2p1:Message>String</d2p1:Message>
<d2p1:StackTrace>String</d2p1:StackTrace>
<d2p1:Errors>
<d2p1:ResponseError>
<d2p1:ErrorCode>String</d2p1:ErrorCode>
<d2p1:FieldName>String</d2p1:FieldName>
<d2p1:Message>String</d2p1:Message>
<d2p1:Meta xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<d5p1:KeyValueOfstringstring>
<d5p1:Key>String</d5p1:Key>
<d5p1:Value>String</d5p1:Value>
</d5p1:KeyValueOfstringstring>
</d2p1:Meta>
</d2p1:ResponseError>
</d2p1:Errors>
<d2p1:Meta xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<d3p1:KeyValueOfstringstring>
<d3p1:Key>String</d3p1:Key>
<d3p1:Value>String</d3p1:Value>
</d3p1:KeyValueOfstringstring>
</d2p1:Meta>
</ResponseStatus>
<Scopes>
<DispatchHoldScopeView>
<Key>String</Key>
<Kind>String</Kind>
<Label>String</Label>
</DispatchHoldScopeView>
</Scopes>
<Suggestion>
<DayLabel>String</DayLabel>
<EndUtc>0001-01-01T00:00:00</EndUtc>
<ForDate>String</ForDate>
<Headline>String</Headline>
<Kind>String</Kind>
<Reason>String</Reason>
<ScopeKind>String</ScopeKind>
<ScopeLabel>String</ScopeLabel>
<Severity>0</Severity>
<StartUtc>0001-01-01T00:00:00</StartUtc>
<Text>String</Text>
<WindowLocal>String</WindowLocal>
</Suggestion>
<Windows>
<DispatchOfflineWindowView>
<FromHour>String</FromHour>
<OfflineWindowId>0</OfflineWindowId>
<ToHour>String</ToHour>
</DispatchOfflineWindowView>
</Windows>
</DispatchHoldsResponse>