TemplateList

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/dottedsign-com/json-schema/dottedsign-com-template-list-schema.json",
  "title": "TemplateList",
  "description": "Template list.",
  "x-generated": "2026-11-06",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/dottedsign-com-templates-api-openapi.yml#/components/schemas/TemplateList",
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "total_count": {
          "type": "integer",
          "description": "Total count of items."
        },
        "current_page": {
          "type": "integer",
          "description": "Current page number."
        },
        "total_pages": {
          "type": "integer",
          "description": "Total page count."
        },
        "templates": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/Template"
          }
        }
      }
    }
  },
  "$defs": {
    "DummyStage": {
      "type": "object",
      "properties": {
        "stage_id": {
          "type": "integer",
          "description": "Stage ID."
        },
        "role": {
          "type": "string",
          "description": "Signer's role."
        },
        "email": {
          "type": "string",
          "description": "Actor's email."
        },
        "stage_type": {
          "type": "string",
          "description": "Stage type.",
          "enum": [
            "sign",
            "edit",
            "form_sign"
          ]
        },
        "sequence": {
          "type": "integer",
          "description": "Stage sequence, which starts from `1`."
        },
        "status": {
          "type": "string",
          "description": "Stage status.",
          "enum": [
            "initial",
            "processing",
            "signed",
            "done",
            "modifying",
            "reviewed",
            "declined",
            "canceled"
          ]
        }
      },
      "description": "Dummy stage."
    },
    "SourceSettingCcInfo": {
      "type": "object",
      "description": "Source setting cc info.",
      "properties": {
        "email": {
          "type": "string",
          "description": "CC Email."
        },
        "name": {
          "type": "string",
          "description": "CC Name."
        }
      }
    },
    "SourceSettingReferenceSetting": {
      "type": "object",
      "description": "Source setting reference setting.",
      "properties": {
        "file_name": {
          "type": "string",
          "description": "Reference name."
        },
        "reference_id": {
          "type": "string",
          "description": "Reference ID."
        },
        "reference_type": {
          "type": "string",
          "description": "Reference file type."
        },
        "force": {
          "type": "boolean",
          "description": "Force signers to consent to the file or not."
        },
        "viewable_in_processing": {
          "type": "boolean",
          "description": "Signers can view the file or not before the task is completed."
        }
      }
    },
    "Template": {
      "type": "object",
      "description": "Template.",
      "properties": {
        "template_id": {
          "type": "integer",
          "description": "Template ID."
        },
        "file_name": {
          "type": "string",
          "description": "Template name."
        },
        "has_order": {
          "type": "boolean",
          "description": "Signers should sign sequentially or not."
        },
        "status": {
          "type": "string",
          "description": "Template status.",
          "enum": [
            "active",
            "deleted"
          ]
        },
        "access_info": {
          "$ref": "#/$defs/TemplateAccessInfo"
        },
        "details": {
          "type": "array",
          "description": "Stage details.",
          "items": {
            "$ref": "#/$defs/DummyStage"
          }
        },
        "template_setting": {
          "$ref": "#/$defs/TemplateSetting"
        },
        "metadata": {
          "type": "object",
          "description": "Metadata. **Maximum 10 key-value pairs, where each key length must be less than or equal to 40 characters and each value length must be less than or equal to 100 characters.**"
        },
        "created_at": {
          "type": "integer",
          "description": "Template creation timestamp."
        },
        "last_modified_at": {
          "type": "integer",
          "description": "Template last modification timestamp."
        }
      }
    },
    "TemplateAccessInfo": {
      "type": "object",
      "description": "Template access info.",
      "properties": {
        "view": {
          "type": "boolean",
          "description": "Member can view the template or not."
        },
        "update": {
          "type": "boolean",
          "description": "Member can update the template or not."
        },
        "delete": {
          "type": "boolean",
          "description": "Member can delete the template or not."
        },
        "group_share": {
          "type": "boolean",
          "description": "Member can share the template to the group or not."
        },
        "kiosk_setting": {
          "type": "boolean",
          "description": "Member can update the kiosk setting or not."
        },
        "duplicate": {
          "type": "boolean",
          "description": "Member can duplicate the template or not."
        },
        "transfer": {
          "type": "boolean",
          "description": "Member can transfer the template or not."
        }
      }
    },
    "TemplateSetting": {
      "type": "object",
      "properties": {
        "deadline": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Deadline in timestamp in seconds. *Used for `SignTask` only.*"
        },
        "forget_remind": {
          "type": "boolean",
          "description": "Remind the signer or not when task is waiting for signing."
        },
        "expire_remind": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "Remind the signer or not when task is going to be expired. *Used for `SignTask` only.*"
        },
        "remind_days_before_expire": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Days before expire to remind the signer. *Used for `SignTask` only.*"
        },
        "link_expire_days": {
          "type": "integer",
          "description": "Days before the signing link expires. *Always resolved (request > template > owner preference), never null.*"
        },
        "forget_remind_days": {
          "type": "integer",
          "description": "Days after the signing request to send the first reminder; a second reminder is sent at 3× this value. Only effective when `forget_remind` is `true`. *Always resolved (request > template > owner preference), never null.*"
        },
        "expires_in_days": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Days before expire. *Used for `SignTask` only.*"
        },
        "cc_infos": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/SourceSettingCcInfo"
          }
        },
        "message": {
          "type": [
            "string",
            "null"
          ],
          "description": "Message to the signer when task is processing."
        },
        "completed_message": {
          "type": [
            "string",
            "null"
          ],
          "description": "Message to the signer when task is completed."
        },
        "reference_settings": {
          "type": "array",
          "description": "Reference information viewable to signers when task is processing.",
          "items": {
            "$ref": "#/$defs/SourceSettingReferenceSetting"
          }
        },
        "completed_reference_settings": {
          "type": "array",
          "description": "Reference information viewable to signers when task is completed.",
          "deprecated": true,
          "items": {
            "$ref": "#/$defs/SourceSettingReferenceSetting"
          }
        },
        "receiver_lang": {
          "type": "string",
          "description": "Language displayed for the signer, only effective if signer has not set his preferred language."
        },
        "owner_informable": {
          "type": "boolean",
          "description": "Inform the owner through email or not when task is updated.",
          "default": false
        }
      },
      "description": "Template setting."
    }
  }
}