get_template_properties
Retrieve detailed properties and settings for a specific BoldSign template using its unique template ID to access template configuration and workflow details.
Instructions
Retrieves the detailed properties and settings of a specific BoldSign template using its unique template ID.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| templateId | Yes | Required. The unique identifier (ID) of the template to retrieve. This can be obtained from the list templates tool. |
Implementation Reference
- The primary handler function that implements the tool logic: instantiates TemplateApi, sets configuration, retrieves template properties by ID, and handles the MCP response or errors.async function getTemplatePropertiesHandler(payload: GetTemplatePropertiesSchemaType): Promise<McpResponse> { try { const templateApi = new TemplateApi(); templateApi.basePath = configuration.getBasePath(); templateApi.setApiKey(configuration.getApiKey()); const templateProperties: TemplateProperties = await templateApi.getProperties(payload.templateId); return handleMcpResponse({ data: templateProperties, }); } catch (error: any) { return handleMcpError(error); } }
- Zod schema defining the input parameters for the tool, specifically the required templateId.const GetTemplatePropertiesSchema = z.object({ templateId: commonSchema.InputIdSchema.describe( 'Required. The unique identifier (ID) of the template to retrieve. This can be obtained from the list templates tool.', ), });
- src/tools/templatesTools/getTemplateProperties.ts:17-26 (registration)Tool definition object registering the method name, description, input schema, and handler function.export const getTemplatePropertiesToolDefinition: BoldSignTool = { method: ToolNames.GetTemplateProperties.toString(), name: 'Get template properties', description: 'Retrieves the detailed properties and settings of a specific BoldSign template using its unique template ID.', inputSchema: GetTemplatePropertiesSchema, async handler(args: unknown): Promise<McpResponse> { return await getTemplatePropertiesHandler(args as GetTemplatePropertiesSchemaType); }, };
- src/tools/templatesTools/index.ts:6-10 (registration)Includes the getTemplatePropertiesToolDefinition in the array of templates API tools for overall registration.export const templatesApiToolsDefinitions: BoldSignTool[] = [ sendDocumentFromTemplateDynamicToolDefinition, listTemplatesToolDefinition, getTemplatePropertiesToolDefinition, ];
- src/tools/toolNames.ts:79-79 (helper)Enum defining the tool name string 'get_template_properties' used in registration.GetTemplateProperties = 'get_template_properties',