Socotra
API ReferencePolicy Management API

Policy Transactions Schedules API

ActionEndpoint
Get Schedules for a transactionGET/policy/{tenantLocator}/transactions/{locator}/schedules
Get a Schedule and itemsGET/policy/{tenantLocator}/transactions/{locator}/schedules/{staticElementLocator}
Upload Transaction Schedule Items for DeserializationPOST/policy/{tenantLocator}/transactions/{locator}/schedules/{staticElementLocator}/deserialize
Add items to schedulePUT/policy/{tenantLocator}/transactions/{locator}/schedules/{staticElementLocator}
Upload a CSV of schedule itemsPOST/policy/{tenantLocator}/transactions/{locator}/schedules/{staticElementLocator}
Delete an item from scheduleDELETE/policy/{tenantLocator}/transactions/{locator}/schedules/{staticElementLocator}
Update a schedule itemPATCH/policy/{tenantLocator}/transactions/{locator}/schedules/{staticElementLocator}

Fetch

Get Schedules for a transaction

Get Schedules for a transactiongetTransactionSchedules
GET/policy/{tenantLocator}/transactions/{locator}/schedules

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Response:map<string, ElementScheduleResponse>
Security Group:transactions
Permissions:
read,schedule-read
ElementScheduleResponse

Required properties

PropertyTypeDescription
staticElementLocatorulid
complexDataboolean
elementTypestring
maxValidationErrorsinteger
scheduleItemTypestring

Get a Schedule and items

Get a Schedule and itemsgetTransactionSchedule
GET/policy/{tenantLocator}/transactions/{locator}/schedules/{staticElementLocator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
staticElementLocatorpathulidYes
lastSeenLocatorqueryulid?No
Security Group:transactions
Permissions:
read,schedule-read
ScheduleItemsResponse

Required properties

PropertyTypeDescription
lastSeenLocatorulid
itemsScheduleItem[]
ScheduleItem

Required properties

PropertyTypeDescription
locatorulid
staticElementLocatorulid
typestring
datamap<string, object>
createdAtdatetime
createdByuuid

Upload Transaction Schedule Items for Deserialization

Upload Transaction Schedule Items for DeserializationuploadDeserializedTransactionSchedule
POST/policy/{tenantLocator}/transactions/{locator}/schedules/{staticElementLocator}/deserialize

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
staticElementLocatorpathulidYes
paramsquerymap<string, string>Yes
Request:file
Security Group:transactions
Permissions:
write,schedule-add
DeserializationResponse

Required properties

PropertyTypeDescription
jobLocatorulid

Updating

Add items to schedule

Add items to scheduleaddTransactionSchedule
PUT/policy/{tenantLocator}/transactions/{locator}/schedules/{staticElementLocator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
staticElementLocatorpathulidYes
Security Group:transactions
Permissions:
write,schedule-add
AddScheduleItemRequest

Required properties

PropertyTypeDescription
datamap<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 itemsuploadTransactionSchedule
POST/policy/{tenantLocator}/transactions/{locator}/schedules/{staticElementLocator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
staticElementLocatorpathulidYes
Request:file
Security Group:transactions
Permissions:
write,schedule-add

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 scheduledeleteTransactionSchedule
DELETE/policy/{tenantLocator}/transactions/{locator}/schedules/{staticElementLocator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
staticElementLocatorpathulidYes
Request:ulid[]
Response:void
Security Group:transactions
Permissions:
write,schedule-delete

Delete individual items from a schedule by specifying their locator within the string array of the request.

Update a schedule item

Update a schedule itemupdateTransactionSchedule
PATCH/policy/{tenantLocator}/transactions/{locator}/schedules/{staticElementLocator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
staticElementLocatorpathulidYes
Security Group:transactions
Permissions:
write,schedule-update
PatchScheduleItemRequest

Required properties

PropertyTypeDescription
locatorulid
removeDatamap<string, object>
setDatamap<string, object>

See Also

On this page