Socotra
API ReferencePolicy Management API

Policy Transactions Schedules API

ActionEndpoint
Get Transaction SchedulesGET/policy/{tenantLocator}/transactions/{locator}/schedules
Get a Transaction Schedule and ItemsGET/policy/{tenantLocator}/transactions/{locator}/schedules/{staticElementLocator}
Get a Transaction Schedule ItemGET/policy/{tenantLocator}/transactions/{locator}/schedules/{staticElementLocator}/{scheduleItemLocator}
Download Quote Schedule ItemsGET/policy/{tenantLocator}/quotes/{locator}/schedules/{staticElementLocator}/csv
Download Transaction Schedule ItemsGET/policy/{tenantLocator}/transactions/{locator}/schedules/{staticElementLocator}/csv
Upload Transaction Schedule Items for DeserializationPOST/policy/{tenantLocator}/transactions/{locator}/schedules/{staticElementLocator}/deserialize
Upload a CSV of Transaction Schedule ItemsPOST/policy/{tenantLocator}/transactions/{locator}/schedules/{staticElementLocator}
Add Items to Transaction SchedulePUT/policy/{tenantLocator}/transactions/{locator}/schedules/{staticElementLocator}
Update a Transaction Schedule ItemPATCH/policy/{tenantLocator}/transactions/{locator}/schedules/{staticElementLocator}
Delete an Item from Transaction ScheduleDELETE/policy/{tenantLocator}/transactions/{locator}/schedules/{staticElementLocator}

Fetch

Get Transaction Schedules

Get Transaction SchedulesgetTransactionSchedules
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 Transaction Schedule and Items

Get a Transaction 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

Get a Transaction Schedule Item

Get a Transaction Schedule ItemgetTransactionScheduleItem
GET/policy/{tenantLocator}/transactions/{locator}/schedules/{staticElementLocator}/{scheduleItemLocator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
staticElementLocatorpathulidYes
scheduleItemLocatorpathulidYes
Response:ScheduleItem
Security Group:transactions
Permissions:
read,schedule-read

ScheduleItem

Required properties

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

Download Quote Schedule Items

Download Quote Schedule ItemsdownloadScheduleItemsCsv
GET/policy/{tenantLocator}/quotes/{locator}/schedules/{staticElementLocator}/csv

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
staticElementLocatorpathulidYes
Response:StreamingResponseBody<string>
Security Group:quotes
Permissions:
read,schedule-read

Download Transaction Schedule Items

Download Transaction Schedule ItemsdownloadTransactionScheduleItemsCsv
GET/policy/{tenantLocator}/transactions/{locator}/schedules/{staticElementLocator}/csv

Parameters

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

Update

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

Upload a CSV of Transaction Schedule Items

Upload a CSV of Transaction 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 supports flat item data structures, meaning no nested objects in the schedule definition.

Add Items to Transaction Schedule

Add Items to Transaction 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

Update a Transaction Schedule Item

Update a Transaction 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>

Delete an Item from Transaction Schedule

Delete an Item from Transaction 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.

See Also

On this page