| Requires any of the permissions: | DISPATCH:HAUL:MANAGE, DISPATCH:JOB:MANAGE, DISPATCH:ONDEMAND:MANAGE |
| POST,OPTIONS | /v1/dispatch/holds |
|---|
export class DispatchHoldView
{
public HoldId: number;
public Code: string;
public ScopeKind: string;
public ScopeKey: string;
public ScopeLabel: string;
public Reason: string;
public Note: string;
public StartUtc: string;
public EndUtc: string;
public Source: string;
public IncidentRef: string;
public LiftedUtc?: string;
public LiftedBy: string;
public CreatedUtc?: string;
public CreatedBy: string;
public Status: string;
public constructor(init?: Partial<DispatchHoldView>) { (Object as any).assign(this, init); }
}
export class DispatchOfflineWindowView
{
public OfflineWindowId: number;
public FromHour: string;
public ToHour: string;
public constructor(init?: Partial<DispatchOfflineWindowView>) { (Object as any).assign(this, init); }
}
export class DispatchHoldScopeView
{
public Kind: string;
public Key: string;
public Label: string;
public constructor(init?: Partial<DispatchHoldScopeView>) { (Object as any).assign(this, init); }
}
export class DispatchHoldSuggestionView
{
public ForDate: string;
public Kind: string;
public Severity: number;
public Headline: string;
public DayLabel: string;
public ScopeKind: string;
public ScopeLabel: string;
public Reason: string;
public StartUtc: string;
public EndUtc: string;
public WindowLocal: string;
public Text: string;
public constructor(init?: Partial<DispatchHoldSuggestionView>) { (Object as any).assign(this, init); }
}
export class DispatchHoldsResponse
{
public Holds: DispatchHoldView[] = [];
public Windows: DispatchOfflineWindowView[] = [];
public Scopes: DispatchHoldScopeView[] = [];
public Suggestion: DispatchHoldSuggestionView;
public ResponseStatus: ResponseStatus;
public constructor(init?: Partial<DispatchHoldsResponse>) { (Object as any).assign(this, init); }
}
export class DispatchHoldCreateRequest
{
public ScopeKind: string;
public ScopeKey: string;
public ScopeLabel: string;
public Reason: string;
public Note: string;
public StartUtc: string;
public EndUtc: string;
public SuggestionDate: string;
public SuggestionKind: string;
public constructor(init?: Partial<DispatchHoldCreateRequest>) { (Object as any).assign(this, init); }
}
TypeScript 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>