Skip to content

Latest commit

 

History

History
314 lines (213 loc) · 23.1 KB

README.md

File metadata and controls

314 lines (213 loc) · 23.1 KB

Templates

(templates)

Overview

Available Operations

find

Find templates based on a search criteria

Example Usage

from documenso_sdk import Documenso
import os

with Documenso(
    api_key=os.getenv("DOCUMENSO_API_KEY", ""),
) as documenso:

    res = documenso.templates.find()

    # Handle response
    print(res)

Parameters

Parameter Type Required Description
query Optional[str] ➖ The search query.
page Optional[float] ➖ The pagination page number, starts at 1.
per_page Optional[float] ➖ The number of items per page.
type Optional[models.QueryParamType] ➖ Filter templates by type.
retries Optional[utils.RetryConfig] ➖ Configuration to override the default retry behavior of the client.

Response

models.TemplateFindTemplatesResponseBody

Errors

Error Type Status Code Content Type
models.TemplateFindTemplatesTemplatesResponseBody 400 application/json
models.TemplateFindTemplatesTemplatesResponseResponseBody 404 application/json
models.TemplateFindTemplatesTemplatesResponse500ResponseBody 500 application/json
models.APIError 4XX, 5XX */*

get

Get template

Example Usage

from documenso_sdk import Documenso
import os

with Documenso(
    api_key=os.getenv("DOCUMENSO_API_KEY", ""),
) as documenso:

    res = documenso.templates.get(template_id=7003.47)

    # Handle response
    print(res)

Parameters

Parameter Type Required Description
template_id float ✔️ N/A
retries Optional[utils.RetryConfig] ➖ Configuration to override the default retry behavior of the client.

Response

models.TemplateGetTemplateByIDResponseBody

Errors

Error Type Status Code Content Type
models.TemplateGetTemplateByIDTemplatesResponseBody 400 application/json
models.TemplateGetTemplateByIDTemplatesResponseResponseBody 404 application/json
models.TemplateGetTemplateByIDTemplatesResponse500ResponseBody 500 application/json
models.APIError 4XX, 5XX */*

update

Update template

Example Usage

from documenso_sdk import Documenso
import os

with Documenso(
    api_key=os.getenv("DOCUMENSO_API_KEY", ""),
) as documenso:

    res = documenso.templates.update(template_id=8574.78)

    # Handle response
    print(res)

Parameters

Parameter Type Required Description
template_id float ✔️ N/A
data Optional[models.TemplateUpdateTemplateData] ➖ N/A
meta Optional[models.TemplateUpdateTemplateMeta] ➖ N/A
retries Optional[utils.RetryConfig] ➖ Configuration to override the default retry behavior of the client.

Response

models.TemplateUpdateTemplateResponseBody

Errors

Error Type Status Code Content Type
models.TemplateUpdateTemplateTemplatesResponseBody 400 application/json
models.TemplateUpdateTemplateTemplatesResponseResponseBody 500 application/json
models.APIError 4XX, 5XX */*

duplicate

Duplicate template

Example Usage

from documenso_sdk import Documenso
import os

with Documenso(
    api_key=os.getenv("DOCUMENSO_API_KEY", ""),
) as documenso:

    res = documenso.templates.duplicate(template_id=3523.11)

    # Handle response
    print(res)

Parameters

Parameter Type Required Description
template_id float ✔️ N/A
retries Optional[utils.RetryConfig] ➖ Configuration to override the default retry behavior of the client.

Response

models.TemplateDuplicateTemplateResponseBody

Errors

Error Type Status Code Content Type
models.TemplateDuplicateTemplateTemplatesResponseBody 400 application/json
models.TemplateDuplicateTemplateTemplatesResponseResponseBody 500 application/json
models.APIError 4XX, 5XX */*

delete

Delete template

Example Usage

from documenso_sdk import Documenso
import os

with Documenso(
    api_key=os.getenv("DOCUMENSO_API_KEY", ""),
) as documenso:

    res = documenso.templates.delete(template_id=5459.07)

    # Handle response
    print(res)

Parameters

Parameter Type Required Description
template_id float ✔️ N/A
retries Optional[utils.RetryConfig] ➖ Configuration to override the default retry behavior of the client.

Response

models.TemplateDeleteTemplateResponseBody

Errors

Error Type Status Code Content Type
models.TemplateDeleteTemplateTemplatesResponseBody 400 application/json
models.TemplateDeleteTemplateTemplatesResponseResponseBody 500 application/json
models.APIError 4XX, 5XX */*

use

Use the template to create a document

Example Usage

from documenso_sdk import Documenso
import os

with Documenso(
    api_key=os.getenv("DOCUMENSO_API_KEY", ""),
) as documenso:

    res = documenso.templates.use(template_id=6626.9, recipients=[
        {
            "id": 6473.53,
            "email": "[email protected]",
        },
        {
            "id": 3772.31,
            "email": "[email protected]",
        },
    ])

    # Handle response
    print(res)

Parameters

Parameter Type Required Description
template_id float ✔️ N/A
recipients List[models.TemplateCreateDocumentFromTemplateRecipients] ✔️ The information of the recipients to create the document with.
distribute_document Optional[bool] ➖ Whether to create the document as pending and distribute it to recipients.
custom_document_data_id Optional[str] ➖ The data ID of an alternative PDF to use when creating the document. If not provided, the PDF attached to the template will be used.
retries Optional[utils.RetryConfig] ➖ Configuration to override the default retry behavior of the client.

Response

models.TemplateCreateDocumentFromTemplateResponseBody

Errors

Error Type Status Code Content Type
models.TemplateCreateDocumentFromTemplateTemplatesResponseBody 400 application/json
models.TemplateCreateDocumentFromTemplateTemplatesResponseResponseBody 500 application/json
models.APIError 4XX, 5XX */*

move_to_team

Move a template to a team

Example Usage

from documenso_sdk import Documenso
import os

with Documenso(
    api_key=os.getenv("DOCUMENSO_API_KEY", ""),
) as documenso:

    res = documenso.templates.move_to_team(template_id=8301.72, team_id=6724.78)

    # Handle response
    print(res)

Parameters

Parameter Type Required Description
template_id float ✔️ The ID of the template to move to.
team_id float ✔️ The ID of the team to move the template to.
retries Optional[utils.RetryConfig] ➖ Configuration to override the default retry behavior of the client.

Response

models.TemplateMoveTemplateToTeamResponseBody

Errors

Error Type Status Code Content Type
models.TemplateMoveTemplateToTeamTemplatesResponseBody 400 application/json
models.TemplateMoveTemplateToTeamTemplatesResponseResponseBody 500 application/json
models.APIError 4XX, 5XX */*