All Resources

📘

All Smarter Drafter API Resources are listed below.




Folders

Folders are used to organise forms in Smarter Drafter.

ResourceDescription
Gets the folder details by IDRetrieves the full metadata and details of a specific client folder using its unique Smarter Drafter ID.
Gets the library of client foldersRetrieves a collection or list representing the available library of folders associated with the client.

Forms

Forms are built as an automation using fields, and are sent to users to complete

ResourceDescription
GET /Forms/:id/FieldsReturns fields from a specified form
GET /Forms/:idReturns a specified form
GET /FormsSearch for forms with specified query parameters
Retrieves a form by IDRetrieves the full configuration details of a specific Smarter Drafter form using its unique identifier.
Searches for forms based on the provided filter and pagination parametersAllows searching and retrieving a paginated list of available forms based on specified criteria.
Retrieves fields by form IDRetrieves a list of all data fields that are contained within a specified form.

Submissions

Submissions are completed forms, often with generated documents

ResourceDescription
Get a submission by its IDRetrieves the full status and details of a specific document generation submission using its unique identifier.
Get submission mapping by its IDRetrieves the data mapping and context used by the submission to connect to Matter Records and other data sources.
Searches for submissions based on the provided query parametersAllows searching and retrieving a list of document submissions based on filters such as creation date, form, or status.
Download generated documentRetrieves the final, generated document file (e.g., Word or PDF) associated with a completed submission.
Download submission answer fileRetrieves the raw data or answer file that contains all the input values used to populate the document.
Creates a new submission and queue documents for generationProgrammatically initiates a new document drafting process by sending initial data and queuing the final document for generation.
Submit submission and queue documents for generationFinalises a submission that is in progress and immediately triggers the document generation process.
Update answer for a submission and fieldAllows updating the value for a specific field within an existing document submission record.
Deletes a submission by its IdPermanently removes a document submission record and its associated files.


Field Alias

Field Alias store the specific data values within a Record (e.g., full_name, ABN, email_address).

ResourceDescription
Get an alias by IDRetrieves the full definition of a Field Alias using its unique, internal Smarter Drafter ID.
Get an alias by nameRetrieves the full definition of a Field Alias using its technical name string (e.g., client_first_name).
Search for aliases based on the query parametersAllows searching and retrieving a list of Field Alias definitions based on provided filter criteria (e.g., associated Custom Data Source).
Add a new aliasCreates a new Field Alias definition to standardise a specific data property for use in Records.
Update an alias by IDUpdates the details of an existing Field Alias, primarily its display name, using its unique Smarter Drafter ID.
Delete an alias by IDPermanently removes an existing Field Alias definition from the system.

Record Types

Record Types categorise Records as Roles (eg., "Client", "Vendor"), or Matter Details (eg., "Trial Information") helping define how the Record relates to the matter.

ResourceDescription
Get a record type by IDRetrieves the full definition of a Record Type, including its category (Role or Matter Details), using its unique Smarter Drafter ID.
Get a record type by API identifierRetrieves the full definition of a Record Type using the unique technical identifier created for the API integration.
Search for record types based on query parametersAllows searching and retrieving a list of Record Type definitions based on filter criteria, such as category or associated data source.
Add a new record typeCreates a new Record Type definition, categorised as either a Role (for people) or Matter Details (for things/concepts).
Update a record type by IDUpdates the details of an existing Record Type, primarily its display name or category, using its unique Smarter Drafter ID.
Deprecate a record type by IDArchives or sets the status of an existing Record Type to deprecated, preventing it from being used for new Records.
Reactivate a record type by IDRestores a previously deprecated Record Type, making it available again for use when creating new Records.

Matters

Matters are the cases from your source system that acts as the central container for associated data in Smarter Drafter

ResourceDescription
Get a matter by IDRetrieves the full details of a matter using its unique, internal Smarter Drafter ID.
Get a matter by external IDRetrieves the details of a matter by querying its unique identifier from your connected external source system.
Search for matters based on query parametersAllows searching and retrieving a paginated list of matters based on provided filter criteria (e.g., name, creation date, or status).
Add a new mattersCreates a new Matter record in Smarter Drafter, establishing the central data container for a case file from your external system.
Update a matter by IDUpdates the main descriptive details of an existing Matter using its unique Smarter Drafter ID.
Update the users that have access to a matterModifies the list of specific Smarter Drafter users who are explicitly granted access to the Matter's data.
Update the groups that limits access to a matterModifies the Smarter Drafter user groups that are permitted to access the Matter's data.
Deprecate a matterArchives or sets the status of an existing matter to deprecated, removing it from active use without deletion.

Records

Records are the individual data entities that are associated to a matter. These are the payloads of information - such as a specific person (Contact), a business entity (Company), or Matter Information (Matter Data) - that are used to pre-fill the form.

ResourceDescription
Get a record by IDRetrieves the full details, including all stored data values, of a specific Record using its unique, internal Smarter Drafter ID.
Get a record by external IDRetrieves a Record's details by querying its unique identifier from your connected external source system.
Search for records based on query parametersAllows searching and retrieving a list of Records based on provided query parameters (e.g., Record Type ID or Custom Data Source ID).
Add a new recordsCreates a new Record entity, importing the data values from your source system and associating them with a Record Type.
Update a record by IDReplaces the full data set or updates the details of an existing Record using its unique Smarter Drafter ID.
Update the record types associate to a recordAllows changing the Record Type assigned to an existing Record entity.
Update the aliases associate to a recordAllows modifying the specific set of Field Aliases and their values stored within an existing Record.
Deactivate a record by IDSets the status of an existing Record to inactive, making it unavailable for use in new forms without permanent deletion.
Reactivate a record by IDRestores a previously deactivated Record, making it available again for use within the Matter Record system.
Deletes a record by IDPermanently removes a Record entity from the Matter Record data store.

Groups

Groups allow for access to be assigned collectively to multiple users.

ResourceDescription
Get a group by IDRetrieves the full details and list of members for a specific user group using its unique Smarter Drafter ID.
Search for groups based on query parametersAllows searching and retrieving a list of user groups based on filter criteria like name or member status.
Add a new groupCreates a new user group within Smarter Drafter for the purpose of organising users and controlling access.
Updates a groupUpdates the main descriptive details, such as the name, of an existing user group.
Updates the members of a groupModifies the list of users that are included as members of a specific user group.
Delete a group by IDPermanently removes an existing user group from the system.