Socotra
API ReferenceQuotes API

Quotes Schedules API

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

Fetch

Fetch Quote Schedules

Fetch Quote SchedulesfetchSchedules
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 Quote Schedule and Items

Fetch a Quote 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[]

Fetch a Quote Schedule Item

Fetch a Quote Schedule ItemfetchScheduleItem
GET/policy/{tenantLocator}/quotes/{locator}/schedules/{staticElementLocator}/{scheduleItemLocator}

Parameters

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

ScheduleItem

Required properties

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

Update

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

Upload a CSV of Quote Schedule Items

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

Add Items to Quote Schedule

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

Update a Quote Schedule Item

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

Delete an Item From Quote Schedule

Delete an Item From Quote 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.

See Also

On this page