Socotra
API ReferenceQuotes API

Quotes Schedules API

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

Fetch

Fetch Schedules for a quote

Fetch Schedules for a quotefetchSchedules
GET/policy/{tenantLocator}/quotes/{locator}/schedules

Parameters

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

Required properties

PropertyTypeDescription
staticElementLocatorulid
complexDataboolean
elementTypestring
maxValidationErrorsinteger
scheduleItemTypestring

Fetch a Schedule and items

Fetch a Schedule and itemsfetchScheduleItems
GET/policy/{tenantLocator}/quotes/{locator}/schedules/{staticElementLocator}

Parameters

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

Required properties

PropertyTypeDescription
lastSeenLocatorulid
itemsScheduleItem[]

Upload Quote Schedule Items for Deserialization

Upload Quote Schedule Items for DeserializationuploadDeserializedScheduleItems
POST/policy/{tenantLocator}/quotes/{locator}/schedules/{staticElementLocator}/deserialize

Parameters

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

Required properties

PropertyTypeDescription
jobLocatorulid

Updating

Add items to schedule

Add items to scheduleaddScheduleItems
PUT/policy/{tenantLocator}/quotes/{locator}/schedules/{staticElementLocator}

Parameters

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

Required properties

PropertyTypeDescription
datamap<string, object>
ScheduleItem

Required properties

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

API requests to add items to a schedule are limited to 500 items

Upload a CSV of schedule items

Upload a CSV of schedule itemsuploadScheduleItems
POST/policy/{tenantLocator}/quotes/{locator}/schedules/{staticElementLocator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
staticElementLocatorpathulidYes
Request:file
Security Group:quotes
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 scheduledeleteScheduleItems
DELETE/policy/{tenantLocator}/quotes/{locator}/schedules/{staticElementLocator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
staticElementLocatorpathulidYes
Request:ulid[]
Response:void
Security Group:quotes
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 itemupdateScheduleItems
PATCH/policy/{tenantLocator}/quotes/{locator}/schedules/{staticElementLocator}

Parameters

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

Required properties

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

See Also

On this page