Socotra
API ReferenceResources API

Resource Service API

ActionEndpoint
Fetch a Resource GroupGET/resource/{tenantLocator}/groups/{locator}
Fetch all Resource GroupsGET/resource/{tenantLocator}/groups/list
Create a Resource GroupPOST/resource/{tenantLocator}/groups
Update a Resource GroupPATCH/resource/{tenantLocator}/groups/{locator}
Retire a ResourceGroupPATCH/resource/{tenantLocator}/groups/{locator}/retire
Fetch a ResourceGET/resource/{tenantLocator}/resources/{name}
Fetch Multiple ResourcesGET/resource/{tenantLocator}/resources/list
Fetch Multiple Resources by TypeGET/resource/{tenantLocator}/resources/type/{type}/list

Resource Groups

Fetch a Resource Group

Fetch a Resource GroupfetchResourceGroup
GET/resource/{tenantLocator}/groups/{locator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Security Group:resource-groups
Permission:
read
ResourceGroupResponse

Required properties

PropertyTypeDescription
locatorulid
namestring
selectionStartTimedatetime
createdAtdatetime
createdByuuid
retiredboolean
resourceNamesstring[]

Fetch all Resource Groups

Fetch all Resource GroupsfetchResourceGroups
GET/resource/{tenantLocator}/groups/list

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
offsetqueryinteger?No
countqueryinteger?No
extendedqueryboolean?NoWhen false, returns a bare array.
excludeRetiredqueryboolean?NoDefault value true.
excludeActivequeryboolean?NoDefault value false.
Security Group:resource-groups
Permission:
list
ResourceGroupListResponse

Required properties

PropertyTypeDescription
listCompletedboolean
itemsResourceGroupResponse[]

Create a Resource Group

Create a Resource GroupcreateResourceGroup
POST/resource/{tenantLocator}/groups

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
Security Group:resource-groups
Permission:
write
ResourceGroupCreateRequest

Required properties

PropertyTypeDescription
namestring
selectionStartTimedatetime
resourceNamesstring[]

Update a Resource Group

Update a Resource GroupupdateResourceGroup
PATCH/resource/{tenantLocator}/groups/{locator}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Security Group:resource-groups
Permission:
write
ResourceGroupUpdateRequest

Required properties

PropertyTypeDescription
namestring
selectionStartTimedatetime
addResourcesstring[]
removeResourcesstring[]

Retire a ResourceGroup

Retire a ResourceGroupretire
PATCH/resource/{tenantLocator}/groups/{locator}/retire

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
locatorpathulidYes
Security Group:resource-groups
Permission:
write

Resources

Fetch a Resource

Fetch a ResourcefetchResource
GET/resource/{tenantLocator}/resources/{name}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
namepathstringYes
byStaticNamequeryboolean?No
datequerydatetime?No
jurisdictionquerystring?No
Security Group:resources
Permission:
read
ResourceResponse

Required properties

PropertyTypeDescription
namestring
resourceTypeEnum constraintTable | customFont | documentTemplate | documentTemplateSnippet | rangeTable | secret | staticDocument | table
createdAtdatetime
createdByuuid
jurisdictionsstring[]

Optional properties

PropertyTypeDescription
lookupTableLocatorulid?
staticDocumentLocatorulid?
staticNamestring?
formatEnum? text | html | pdf | jpg | jpeg | doc | docx | xls | xlsx | csv | txt | zip
renderingEnum? dynamic | prerendered
scopeEnum? transaction | policy | term | segment | invoice
templatestring?
templateFormatEnum? liquid | velocity
triggerEnum? validated | priced | accepted | underwritten | issued | generated
BasicResourceResponse

Required properties

PropertyTypeDescription
namestring
resourceTypeEnum constraintTable | customFont | documentTemplate | documentTemplateSnippet | rangeTable | secret | staticDocument | table
createdAtdatetime
createdByuuid
jurisdictionsstring[]

Optional properties

PropertyTypeDescription
constraintTableLocatorulid?
fontLocatorulid?
lookupTableLocatorulid?
rangeTableLocatorulid?
riskAssessmentCriteriaLocatorulid?
staticDocumentLocatorulid?
uiConfigLocatorulid?
staticNamestring?
templatestring?
templateFormatEnum? liquid | velocity

Fetch Multiple Resources

Fetch Multiple ResourcesfetchMultipleResources
GET/resource/{tenantLocator}/resources/list

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
offsetqueryinteger?No
countqueryinteger?No
extendedqueryboolean?NoWhen false, returns a bare array.
Security Group:resources
Permission:
list

Fetch Multiple Resources by Type

Fetch Multiple Resources by TypefetchMultipleResourcesByType
GET/resource/{tenantLocator}/resources/type/{type}/list

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
typepathstringYes
offsetqueryinteger?No
countqueryinteger?No
extendedqueryboolean?NoWhen false, returns a bare array.
Security Group:resources
Permission:
list
ResourceListResponse

Required properties

PropertyTypeDescription
listCompletedboolean
itemsResourceResponse[]
TemplateResponse

Properties

PropertyTypeDescription
fileobject?
templatestring?

On this page