Socotra
API ReferenceAux Data API

Diary API

ActionEndpoint
Fetch Latest Diary Entry By LocatorGET/auxdata/{tenantLocator}/diary/{locator}/latest
Fetch Latest Diary Entries By ReferenceGET/auxdata/{tenantLocator}/diary/{referenceType}/{referenceLocator}
Fetch All Diary Entries By LocatorGET/auxdata/{tenantLocator}/diary/{locator}
Create DiaryPOST/auxdata/{tenantLocator}/diary/{referenceType}/{referenceLocator}
Create Diary For Segment ElementPOST/auxdata/{tenantLocator}/diary/segments/{segmentLocator}/element/{staticElementLocator}
Create Diary For Quote ElementPOST/auxdata/{tenantLocator}/diary/quotes/{quoteLocator}/element/{staticElementLocator}
Update DiaryPATCH/auxdata/{tenantLocator}/diary/{locator}
Discard DiaryPATCH/auxdata/{tenantLocator}/diary/{locator}/discard

Fetch

Fetch Latest Diary Entry By Locator

Fetch Latest Diary Entry By LocatorfetchLatestDiaryEntryByLocator
GET/auxdata/{tenantLocator}/diary/{locator}/latest

Fetches the latest revision of a single diary entry

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Security Group:diary
Permission:
read

Fetch Latest Diary Entries By Reference

Fetch Latest Diary Entries By ReferencefetchLatestDiaryEntriesByReference
GET/auxdata/{tenantLocator}/diary/{referenceType}/{referenceLocator}

Fetches all of the latest revisions for a given entity

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
referenceTypepathstringYes
referenceLocatorpathulidYes
includeDiscardedqueryboolean?No
Security Group:diary
Permission:
read

Fetch All Diary Entries By Locator

Fetch All Diary Entries By LocatorfetchAllDiaryEntriesByLocator
GET/auxdata/{tenantLocator}/diary/{locator}

Fetches all revisions of a single diary entry

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
offsetqueryinteger?No
countqueryinteger?No
Security Group:diary
Permissions:
read,list
DiaryEntryResponse

Required properties

PropertyTypeDescription
locatorulid
referenceLocatorulid
diaryStateEnum active | discarded
contentsstring
referenceTypeEnum quote | policy | transaction | task | fnol | invoice | account | underwritingFlag | payment | quoteGroup | inquiry | element
updatedAtdatetime
updatedByuuid
createdAtdatetime
createdByuuid

Optional properties

PropertyTypeDescription
categorystring?

Creation

Create Diary

Create DiarycreateDiary
POST/auxdata/{tenantLocator}/diary/{referenceType}/{referenceLocator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
referenceTypepathstringYes
referenceLocatorpathulidYes
Security Group:diary
Permission:
write

Create Diary For Segment Element

Create Diary For Segment ElementcreateDiaryForSegmentElement
POST/auxdata/{tenantLocator}/diary/segments/{segmentLocator}/element/{staticElementLocator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
segmentLocatorpathulidYes
staticElementLocatorpathulidYes
Security Group:diary
Permission:
write

Create Diary For Quote Element

Create Diary For Quote ElementcreateDiaryForQuoteElement
POST/auxdata/{tenantLocator}/diary/quotes/{quoteLocator}/element/{staticElementLocator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
quoteLocatorpathulidYes
staticElementLocatorpathulidYes
Security Group:diary
Permission:
write
DiaryEntryCreateRequest

Required properties

PropertyTypeDescription
contentsstring

Optional properties

PropertyTypeDescription
categorystring?

Revisioning

Update Diary

Update DiaryupdateDiary
PATCH/auxdata/{tenantLocator}/diary/{locator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Security Group:diary
Permission:
write
DiaryEntryUpdateRequest

Required properties

PropertyTypeDescription
contentsstring

Optional properties

PropertyTypeDescription
categorystring?

Discard

Discard Diary

Discard DiarydiscardDiary
PATCH/auxdata/{tenantLocator}/diary/{locator}/discard

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Security Group:diary
Permission:
write

See Also

On this page