Policy Transactions Schedules API
| Action | Endpoint |
|---|---|
| Get Schedules for a transaction | GET/policy/{tenantLocator}/transactions/{locator}/schedules |
| Get a Schedule and items | GET/policy/{tenantLocator}/transactions/{locator}/schedules/{staticElementLocator} |
| Upload Transaction Schedule Items for Deserialization | POST/policy/{tenantLocator}/transactions/{locator}/schedules/{staticElementLocator}/deserialize |
| Add items to schedule | PUT/policy/{tenantLocator}/transactions/{locator}/schedules/{staticElementLocator} |
| Upload a CSV of schedule items | POST/policy/{tenantLocator}/transactions/{locator}/schedules/{staticElementLocator} |
| Delete an item from schedule | DELETE/policy/{tenantLocator}/transactions/{locator}/schedules/{staticElementLocator} |
| Update a schedule item | PATCH/policy/{tenantLocator}/transactions/{locator}/schedules/{staticElementLocator} |
Fetch
Get Schedules for a transaction
Get Schedules for a transaction
getTransactionSchedulesGET
/policy/{tenantLocator}/transactions/{locator}/schedulesParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
locator | path | ulid | Yes |
Response:
map<string, ElementScheduleResponse>Security Group:
transactionsPermissions:
read,schedule-readElementScheduleResponse
Required properties
| Property | Type | Description |
|---|---|---|
staticElementLocator | ulid | |
complexData | boolean | |
elementType | string | |
maxValidationErrors | integer | |
scheduleItemType | string |
Get a Schedule and items
Get a Schedule and items
getTransactionScheduleGET
/policy/{tenantLocator}/transactions/{locator}/schedules/{staticElementLocator}Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
locator | path | ulid | Yes | |
staticElementLocator | path | ulid | Yes | |
lastSeenLocator | query | ulid? | No |
Response:
ScheduleItemsResponseSecurity Group:
transactionsPermissions:
read,schedule-readScheduleItemsResponse
Required properties
| Property | Type | Description |
|---|---|---|
lastSeenLocator | ulid | |
items | ScheduleItem[] |
ScheduleItem
Required properties
| Property | Type | Description |
|---|---|---|
locator | ulid | |
staticElementLocator | ulid | |
type | string | |
data | map<string, object> | |
createdAt | datetime | |
createdBy | uuid |
Upload Transaction Schedule Items for Deserialization
Upload Transaction Schedule Items for Deserialization
uploadDeserializedTransactionSchedulePOST
/policy/{tenantLocator}/transactions/{locator}/schedules/{staticElementLocator}/deserializeParameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
locator | path | ulid | Yes | |
staticElementLocator | path | ulid | Yes | |
params | query | map<string, string> | Yes |
Request:
fileResponse:
DeserializationResponseSecurity Group:
transactionsPermissions:
write,schedule-addDeserializationResponse
Required properties
| Property | Type | Description |
|---|---|---|
jobLocator | ulid |
Updating
Add items to schedule
Add items to schedule
addTransactionSchedulePUT
/policy/{tenantLocator}/transactions/{locator}/schedules/{staticElementLocator}Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
locator | path | ulid | Yes | |
staticElementLocator | path | ulid | Yes |
Request:
AddScheduleItemRequest[]Response:
ValidationResultSecurity Group:
transactionsPermissions:
write,schedule-addAddScheduleItemRequest
Required properties
| Property | Type | Description |
|---|---|---|
data | map<string, object> |
API requests to add items to a schedule are limited to 500 items
Upload a CSV of schedule items
Upload a CSV of schedule items
uploadTransactionSchedulePOST
/policy/{tenantLocator}/transactions/{locator}/schedules/{staticElementLocator}Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
locator | path | ulid | Yes | |
staticElementLocator | path | ulid | Yes |
CSV for bulk upload of schedule items only support flat item data structures i.e. no nested objects in the schedule definition.
Delete an item from schedule
Delete an item from schedule
deleteTransactionScheduleDELETE
/policy/{tenantLocator}/transactions/{locator}/schedules/{staticElementLocator}Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
locator | path | ulid | Yes | |
staticElementLocator | path | ulid | Yes |
Request:
ulid[]Response:
voidSecurity Group:
transactionsPermissions:
write,schedule-deleteDelete individual items from a schedule by specifying their locator within the string array of the request.
Update a schedule item
Update a schedule item
updateTransactionSchedulePATCH
/policy/{tenantLocator}/transactions/{locator}/schedules/{staticElementLocator}Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tenantLocator | path | uuid | Yes | |
locator | path | ulid | Yes | |
staticElementLocator | path | ulid | Yes |
Request:
PatchScheduleItemRequest[]Response:
ValidationResultSecurity Group:
transactionsPermissions:
write,schedule-updatePatchScheduleItemRequest
Required properties
| Property | Type | Description |
|---|---|---|
locator | ulid | |
removeData | map<string, object> | |
setData | map<string, object> |