DynamicTemplates

Create a new dynamic template

Creates a new dynamic template by uploading HBS and JSON configuration files for multiple languages. The structure (JSON schema) is provided as part of each source metadata, extracted from the template editor. The system validates the structure and persists the template with version 1.0.

POST /orgs/{org_id}/dynamic_templates

Parameters

Name	In	Type	Required	Description
org_id	path	string	true	The string id related with one of Grupo MasOrange tenants
body	body	object	true	Template metadata and sources (HBS and JSON files) for each language. Each source includes the pre-extracted structure with fields, rules, and engine version.

1

{}

None

Request example

1
2
3
4
5
6
7
8



curl -X POST https://documents.masstack.com/v1/orgs/masmovil/dynamic_templates \
  -H "Content-Type: multipart/mixed" \
  -H "Accept: application/json" \
 --data-raw "[
  'string'
]" 

Responses

Code	Meaning	Description	Schema
201	Created	New dynamic template is created. Expected response for a valid request.	CreateDynamicTemplateResponse
400	Bad Request	Request input is not valid	None
401	Unauthorized	Unauthorized. AuthN and AuthZ validations have failed	None
409	Conflict	Conflict. External ID already exists	None
500	Internal Server Error	Not expected error	None
default	Default	Error response	ErrorsResponse

Get all editable dynamic templates

Returns a paginated list of all dynamic templates for an organization. Only the latest version of each major version (the ones that could be edited) is included, ordered by creation_date in descending order.

GET /orgs/{org_id}/dynamic_templates

Parameters

Name	In	Type	Required	Description
org_id	path	string	true	The string id related with one of Grupo MasOrange tenants
external_id	query	string	false	Optional filter to retrieve templates for a specific external_id
page	query	Page1	false	Defines templates page number to be show. If not defined, default value is 0 (first page).
page_size	query	PageSize1	false	Defines the number of templates returned in each page. If not defined, default value is 50.

Request example

1
2
3
4



curl -X GET https://documents.masstack.com/v1/orgs/masmovil/dynamic_templates?external_id='factura_mensual'&page='0'&page_size='20' \
  -H "Accept: application/json"

Responses

Code	Meaning	Description	Schema
200	OK	The templates list is returned. Expected response for a valid request.	GetAllDynamicTemplatesResponse
400	Bad Request	Request input is not valid	None
401	Unauthorized	Unauthorized. AuthN and AuthZ validations have failed	None
500	Internal Server Error	Not expected error	None
default	Default	Error response	ErrorsResponse

Get all minor versions of a major version

Returns all minor versions for a specific major version of a dynamic template, ordered by minor version in descending order (newest to oldest). Includes JSON schema extracted from the template file.

GET /orgs/{org_id}/dynamic_templates/{external_id}/versions/{major_version}

Parameters

Name	In	Type	Required	Description
org_id	path	string	true	The string id related with one of Grupo MasOrange tenants
external_id	path	string	true	The external id of the dynamic template
major_version	path	integer	true	The major version number

Request example

1
2
3
4



curl -X GET https://documents.masstack.com/v1/orgs/masmovil/dynamic_templates/factura_mensual/versions/1 \
  -H "Accept: application/json"

Responses

Code	Meaning	Description	Schema
200	OK	The template versions are returned. Expected response for a valid request.	GetDynamicTemplateVersionsResponse
400	Bad Request	Request input is not valid	None
401	Unauthorized	Unauthorized. AuthN and AuthZ validations have failed	None
404	Not Found	Template or version not found	None
500	Internal Server Error	Not expected error	None
default	Default	Error response	ErrorsResponse

Create a new minor version

Creates a new minor version of an existing dynamic template with non-breaking changes such as adding new languages or updating existing language content. Breaking changes like modifying the JSON schema structure, removing sources or changing default language will result in a 409 error.

PATCH /orgs/{org_id}/dynamic_templates/{external_id}/versions/{major_version}

Parameters

Name	In	Type	Required	Description
org_id	path	string	true	The string id related with one of Grupo MasOrange tenants
external_id	path	string	true	The external id of the dynamic template
major_version	path	integer	true	The major version number
body	body	object	true	Template metadata and sources for creating a minor version

1

{}

None

Request example

1
2
3
4
5
6
7
8



curl -X PATCH https://documents.masstack.com/v1/orgs/masmovil/dynamic_templates/factura_mensual/versions/1 \
  -H "Content-Type: multipart/mixed" \
  -H "Accept: application/json" \
 --data-raw "[
  'string'
]" 

Responses

Code	Meaning	Description	Schema
200	OK	New minor version is created. Expected response for a valid request.	CreateDynamicTemplateResponse
400	Bad Request	Request input is not valid	None
401	Unauthorized	Unauthorized. AuthN and AuthZ validations have failed	None
404	Not Found	Template not found	None
409	Conflict	Breaking changes detected. Use major version endpoint instead.	None
500	Internal Server Error	Not expected error	None
default	Default	Error response	ErrorsResponse

Delete a major version

Deletes a complete major version line including all its minor versions. Only the latest major version can be deleted.

DELETE /orgs/{org_id}/dynamic_templates/{external_id}/versions/{major_version}

Parameters

Name	In	Type	Required	Description
org_id	path	string	true	The string id related with one of Grupo MasOrange tenants
external_id	path	string	true	The external id of the dynamic template
major_version	path	integer	true	The major version number

Request example

1
2
3
4



curl -X DELETE https://documents.masstack.com/v1/orgs/masmovil/dynamic_templates/factura_mensual/versions/1 \
  -H "Accept: application/json"

Responses

Code	Meaning	Description	Schema
204	No Content	Major version deleted successfully	None
400	Bad Request	Request input is not valid	None
401	Unauthorized	Unauthorized. AuthN and AuthZ validations have failed	None
404	Not Found	Template or version not found	None
409	Conflict	Cannot delete. Not the latest major version.	None
500	Internal Server Error	Not expected error	None
default	Default	Error response	ErrorsResponse

Get specific minor version details

Returns complete information for a specific minor version of a dynamic template, including JSON schema and source URLs for rendering or analysis.

GET /orgs/{org_id}/dynamic_templates/{external_id}/versions/{major_version}/minors/{minor_version}

Parameters

Name	In	Type	Required	Description
org_id	path	string	true	The string id related with one of Grupo MasOrange tenants
external_id	path	string	true	The external id of the dynamic template
major_version	path	integer	true	The major version number
minor_version	path	integer	true	The minor version number

Request example

1
2
3
4



curl -X GET https://documents.masstack.com/v1/orgs/masmovil/dynamic_templates/factura_mensual/versions/1/minors/1 \
  -H "Accept: application/json"

Responses

Code	Meaning	Description	Schema
200	OK	The specific template version details are returned. Expected response for a valid request.	DynamicTemplateDetails
400	Bad Request	Request input is not valid	None
401	Unauthorized	Unauthorized. AuthN and AuthZ validations have failed	None
404	Not Found	Template or version not found	None
500	Internal Server Error	Not expected error	None
default	Default	Error response	ErrorsResponse

Create a new major version

Creates a new major version of an existing dynamic template with breaking changes. All languages must be provided with their sources. The new version will be X+1.0 where X is the highest existing major version. All new information in the template must be provided, as the information from the previous version will not be kept.

POST /orgs/{org_id}/dynamic_templates/{external_id}/versions

Parameters

Name	In	Type	Required	Description
org_id	path	string	true	The string id related with one of Grupo MasOrange tenants
external_id	path	string	true	The external id of the dynamic template
body	body	object	true	Template metadata and sources for creating a major version

1

{}

None

Request example

1
2
3
4
5
6
7
8



curl -X POST https://documents.masstack.com/v1/orgs/masmovil/dynamic_templates/factura_mensual/versions \
  -H "Content-Type: multipart/mixed" \
  -H "Accept: application/json" \
 --data-raw "[
  'string'
]" 

Responses

Code	Meaning	Description	Schema
201	Created	New major version is created. Expected response for a valid request.	CreateDynamicTemplateResponse
400	Bad Request	Request input is not valid	None
401	Unauthorized	Unauthorized. AuthN and AuthZ validations have failed	None
404	Not Found	Template not found	None
500	Internal Server Error	Not expected error	None
default	Default	Error response	ErrorsResponse

Delete latest minor version

Deletes the latest minor version of a specific major version line. Cannot delete the base version (X.0) or if it's the only minor version in the major line.

DELETE /orgs/{org_id}/dynamic_templates/{external_id}/versions/{major_version}/minor

Parameters

Name	In	Type	Required	Description
org_id	path	string	true	The string id related with one of Grupo MasOrange tenants
external_id	path	string	true	The external id of the dynamic template
major_version	path	integer	true	The major version number

Request example

1
2
3
4



curl -X DELETE https://documents.masstack.com/v1/orgs/masmovil/dynamic_templates/factura_mensual/versions/1/minor \
  -H "Accept: application/json"

Responses

Code	Meaning	Description	Schema
204	No Content	Minor version deleted successfully	None
400	Bad Request	Request input is not valid	None
401	Unauthorized	Unauthorized. AuthN and AuthZ validations have failed	None
404	Not Found	Template or version not found	None
409	Conflict	Cannot delete base version (X.0) or only minor version in major line	None
500	Internal Server Error	Not expected error	None
default	Default	Error response	ErrorsResponse

Get template changelog history

Returns the complete changelog history for a dynamic template, showing all version transitions ordered by version in descending order (newest to oldest).

GET /orgs/{org_id}/dynamic_templates/{external_id}/changelog

Parameters

Name	In	Type	Required	Description
org_id	path	string	true	The string id related with one of Grupo MasOrange tenants
external_id	path	string	true	The external id of the dynamic template

Request example

1
2
3
4



curl -X GET https://documents.masstack.com/v1/orgs/masmovil/dynamic_templates/factura_mensual/changelog \
  -H "Accept: application/json"

Responses

Code	Meaning	Description	Schema
200	OK	The template changelog history is returned. Expected response for a valid request.	DynamicTemplateChangelogResponse
400	Bad Request	Request input is not valid	None
401	Unauthorized	Unauthorized. AuthN and AuthZ validations have failed	None
404	Not Found	Template not found	None
500	Internal Server Error	Not expected error	None
default	Default	Error response	ErrorsResponse

Submit a fill request for a dynamic template

Submit an asynchronous request to fill a specific version of a dynamic template with provided data. The system validates the field values against the template's JSON schema and registers the request for asynchronous processing. Returns immediately with a fill_process_id that can be used to check status via the GET /fill_process endpoint.

POST /orgs/{org_id}/dynamic_templates/{external_id}/versions/{major_version}/fill

Parameters

Name	In	Type	Required	Description
org_id	path	string	true	The string id related with one of Grupo MasOrange tenants
external_id	path	string	true	The external id of the dynamic template
major_version	path	integer	true	The major version number
body	body	CreateFillProcessRequest	true	‘none’

Request body - instance of CreateFillProcessRequest

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28


{
  "language": "ES",
  "document": {
    "name": "personal_contract_2025_001",
    "tags": [
      "DRAFT",
      "RETAIL"
    ]
  },
  "fields_values": {
    "customer": {
      "name": "Juan Pérez",
      "id": "12345678Z"
    },
    "products": [
      {
        "name": "Fibra 1Gb",
        "price": 20
      },
      {
        "name": "Móvil Ilimitado",
        "price": 15
      }
    ],
    "total_amount": 35
  },
  "fill_priority": "low"
}

Name	Type	Required	Description
language	Language1	true	Language of the template in ISO 639-1 format. Possible values: ES, EN, EU, GL, CA, DE, UNDEFINED Not all values are available to all organizations.
document	object	true	none
» name	string	true	Name for the generated document
» tags	[string]	false	Tags to categorize the document
fields_values	object	true	Field values that will be used to fill the template. Must conform to the template’s JSON schema. The entire payload is validated against the template’s JSON schema definition.
fill_priority	string	false	Processing priority for the fill request. Possible values: low, high

Request example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33



curl -X POST https://documents.masstack.com/v1/orgs/masmovil/dynamic_templates/factura_mensual/versions/1/fill \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
 --data-raw "{
  'language': 'ES',
  'document': {
    'name': 'personal_contract_2025_001',
    'tags': [
      'DRAFT',
      'RETAIL'
    ]
  },
  'fields_values': {
    'customer': {
      'name': 'Juan Pérez',
      'id': '12345678Z'
    },
    'products': [
      {
        'name': 'Fibra 1Gb',
        'price': 20
      },
      {
        'name': 'Móvil Ilimitado',
        'price': 15
      }
    ],
    'total_amount': 35
  },
  'fill_priority': 'low'
}" 

Responses

Code	Meaning	Description	Schema
202	Accepted	Fill request accepted and registered for processing	CreateFillProcessResponse
400	Bad Request	Invalid input or field values don’t match template schema	ErrorsResponse
401	Unauthorized	Unauthorized - Missing or invalid authentication	None
404	Not Found	Template or version not found	ErrorsResponse
500	Internal Server Error	Internal server error	ErrorsResponse

Get fill process status

Check the status of an asynchronous document fill process. Returns the current state (CREATED, PROCESSING, COMPLETED, FAILED) and relevant metadata based on the state.

GET /orgs/{org_id}/fill_process/{fill_process_id}

Parameters

Name	In	Type	Required	Description
org_id	path	string	true	The string id related with one of Grupo MasOrange tenants
fill_process_id	path	string	true	Unique identifier of the fill process

Request example

1
2
3
4



curl -X GET https://documents.masstack.com/v1/orgs/masmovil/fill_process/11223344-aabb-ccdd-eeff-009988776655 \
  -H "Accept: application/json"

Responses

Code	Meaning	Description	Schema
200	OK	Fill process status retrieved successfully	FillProcessResponse
400	Bad Request	Invalid input	None
401	Unauthorized	Unauthorized	None
404	Not Found	Fill process not found	ErrorsResponse
500	Internal Server Error	Internal server error	None