Socotra
API ReferenceResources API

Document Resources API

ActionEndpoint
Fetch a Document Resource by NameGET/resource/{tenantLocator}/documents/{name}
Create a New Document ResourcePOST/resource/{tenantLocator}/documents
Update a Document ResourcePATCH/resource/{tenantLocator}/documents/{name}
Fetch a TemplateGET/resource/{tenantLocator}/templates/{name}
Upload a Velocity TemplatePOST/resource/{tenantLocator}/templates/velocity
Update a Velocity TemplatePATCH/resource/{tenantLocator}/templates/velocity
Upload a Liquid TemplatePOST/resource/{tenantLocator}/templates/liquid
Update a Liquid TemplatePATCH/resource/{tenantLocator}/templates/liquid
Fetch a Template SnippetGET/resource/{tenantLocator}/templateSnippets/{name}
Upload a Velocity Template SnippetPOST/resource/{tenantLocator}/templateSnippets/velocity
Update a Velocity Template SnippetPATCH/resource/{tenantLocator}/templateSnippets/velocity
Upload a Liquid Template SnippetPOST/resource/{tenantLocator}/templateSnippets/liquid
Update a Liquid Template SnippetPATCH/resource/{tenantLocator}/templateSnippets/liquid
Add a custom fontPOST/resource/{tenantLocator}/fonts

Document Resources

Fetch a Document Resource by Name

Fetch a Document Resource by NamefetchDocumentResourceByName
GET/resource/{tenantLocator}/documents/{name}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
namepathstringYes
byStaticNamequeryboolean?No
datequerydatetime?No
jurisdictionquerystring?No
Response:StreamingResponseBody<string>
Security Group:documents
Permission:
read

Create a New Document Resource

Create a New Document ResourcecreateDocumentResource
POST/resource/{tenantLocator}/documents

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
Content-TypeheaderstringYes
namequerystringYes
staticNamequerystringYes
jurisdictionquerystring[]?No
Request:file
Security Group:documents
Permission:
upload

Update a Document Resource

Update a Document ResourceupdateDocument
PATCH/resource/{tenantLocator}/documents/{name}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
Content-TypeheaderstringYes
namepathstringYes
Request:file
Security Group:documents
Permission:
update

Document Templates

Fetch a Template

Fetch a TemplatefetchDocumentTemplate
GET/resource/{tenantLocator}/templates/{name}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
namepathstringYes
byStaticNamequeryboolean?No
datequerydatetime?No
jurisdictionquerystring?No
Response:StreamingResponseBody<string>
Security Group:templates
Permission:
read

Upload a Velocity Template

Upload a Velocity TemplatecreateVelocityDocumentTemplate
POST/resource/{tenantLocator}/templates/velocity

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
namequerystringYes
staticNamequerystringYes
jurisdictionquerystring[]?No
Request with text/plain:TemplateResponse
Request with multipart/form-data:TemplateResponse
Security Group:templates
Permission:
upload

Update a Velocity Template

Update a Velocity TemplateupdateVelocityDocumentTemplate
PATCH/resource/{tenantLocator}/templates/velocity

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
namequerystringYes
Request with text/plain:TemplateResponse
Request with multipart/form-data:TemplateResponse
Security Group:templates
Permission:
upload

Upload a Liquid Template

Upload a Liquid TemplatecreateLiquidDocumentTemplate
POST/resource/{tenantLocator}/templates/liquid

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
namequerystringYes
staticNamequerystringYes
jurisdictionquerystring[]?No
Request with text/plain:TemplateResponse
Request with multipart/form-data:TemplateResponse
Security Group:templates
Permission:
upload

Update a Liquid Template

Update a Liquid TemplateupdateLiquidDocumentTemplate
PATCH/resource/{tenantLocator}/templates/liquid

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
namequerystringYes
Request with text/plain:TemplateResponse
Request with multipart/form-data:TemplateResponse
Security Group:templates
Permission:
upload

Document templates are limited to 5MB in size.

StreamingResponseBody

No properties defined.

Document Snippets

Fetch a Template Snippet

Fetch a Template SnippetfetchTemplate
GET/resource/{tenantLocator}/templateSnippets/{name}

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
namepathstringYes
byStaticNamequeryboolean?No
datequerydatetime?No
jurisdictionquerystring?No
Response:StreamingResponseBody<string>
Security Group:templates
Permission:
read

Upload a Velocity Template Snippet

Upload a Velocity Template SnippetuploadVelocity
POST/resource/{tenantLocator}/templateSnippets/velocity

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
namequerystringYes
staticNamequerystringYes
jurisdictionquerystring[]?No
Request with text/plain:TemplateResponse
Request with multipart/form-data:TemplateResponse
Security Group:templates
Permission:
upload

Update a Velocity Template Snippet

Update a Velocity Template SnippetupdateVelocity
PATCH/resource/{tenantLocator}/templateSnippets/velocity

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
namequerystringYes
Request with text/plain:TemplateResponse
Request with multipart/form-data:TemplateResponse
Security Group:templates
Permission:
upload

Upload a Liquid Template Snippet

Upload a Liquid Template SnippetuploadLiquid
POST/resource/{tenantLocator}/templateSnippets/liquid

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
namequerystringYes
staticNamequerystringYes
jurisdictionquerystring[]?No
Request with text/plain:TemplateResponse
Request with multipart/form-data:TemplateResponse
Security Group:templates
Permission:
upload

Update a Liquid Template Snippet

Update a Liquid Template SnippetupdateLiquid
PATCH/resource/{tenantLocator}/templateSnippets/liquid

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
namequerystringYes
Request with text/plain:TemplateResponse
Request with multipart/form-data:TemplateResponse
Security Group:templates
Permission:
upload

Custom Fonts

Add a custom font

Add a custom fontaddFont
POST/resource/{tenantLocator}/fonts

Parameters

NameInTypeRequiredDescription
tenantLocatorpathuuidYes
namequerystringYes
staticNamequerystringYes
jurisdictionquerystring[]?No
Request:file
Security Group:fonts
Permission:
upload
- Documents API - Documents Configuration Guide

On this page