# mulesoft Roostify Connector - Full Documentation --- product: Roostify Connector version: 1.0 is-latest-version: true --- # Roostify Connector > For the full documentation index, see: https://docs.mulesoft.com/llms.txt Roostify Connector v1.0 Anypoint Connector for Roostify (Roostify Connector) enables customers to convert completed loan applications to an optimized and intuitive digital user experience, tailored to each DBA, branch, or channel. It increases pull-through rates and provides a flexible and scalable framework for growing business requirements. Roostify’s integrated platform enables faster loan closure and allows each loan officer to cultivate and manage more customers at the same time. This improves profitability as well as increases retention and referrals. Roostify Connector offers simplified access to 46 of Roostify’s APIs to support workflows related to: - Access Control - Accounts - Desktop Underwriter Report - Documents - Leads (Draft) - Loan Applications - Messages - Offerings (Draft) - Reference Ids - Service - Settings - State Changes - Status Update - Tasks - User Management - User Settings - Webhook events - Webhooks Release Notes: [Roostify Connector Release Notes](https://docs.mulesoft.com/release-notes/connector/roostify-connector-release-notes-mule-4) Exchange: [Roostify Connector](https://www.mulesoft.com/exchange/com.mulesoft.connectors/mule-roostify-connector/) ## Before You Begin To use this information, you should be familiar with Roostify, Mule concepts, Anypoint connectors, Anypoint Studio, the elements in a Mule flow, and global elements. The APIs use basic authentication, based on username and password. You need a Roostify account and credentials to use the connector. The username works as your account token and password as a service access token. The username and password are stored within the Authorization header in Base64-encoded string following the word Basic which when decoded follows the format of `account-token:service-access-token`. For software requirements and compatibility, see the Connector Release Notes. ## POM File Information ```xml com.mulesoft.connectors mule-roostify-connector x.x.x mule-plugin ``` Replace `x.x.x` with the version that corresponds to the connector you are using. To obtain the most up-to-date `pom.xml` file information, access the connector in [Anypoint Exchange](https://www.mulesoft.com/exchange/) and click **Dependency Snippets**. ## Add the Connector to a Studio Project Anypoint Studio provides two ways to add the connector to your Studio project: from the Exchange button in the Studio taskbar or from the Mule Palette view. ### Add the Connector Using Exchange 1. In Studio, create a Mule project. 2. Click the Exchange icon **(X)** in the upper-left of the Studio task bar. 3. In Exchange, click **Login** and supply your Anypoint Platform username and password. 4. In Exchange, search for "roostify". 5. Select the connector and click **Add to project**. 6. Follow the prompts to install the connector. ### Add the Connector in Studio 1. In Studio, create a Mule project. 2. In the Mule Palette view, click **(X) Search in Exchange**. 3. In **Add Modules to Project**, type "roostify" in the search field. 4. Click this connector’s name in **Available modules**. 5. Click **Add**. 6. Click **Finish**. ## Connector Namespace and Schema When designing your application in the Anypoint Studio, drag the connector from the palette to the canvas. This action automatically populates the XML code with the connector namespace and schema location. - Namespace: `http://www.mulesoft.org/schema/mule/roostify` - Schema Location: `http://www.mulesoft.org/schema/mule/roostify/current/mule-roostify.xsd` ## Configure Roostify Connector in Anypoint Studio 1. In Anypoint Studio, create a new Mule project. Ensure that you have **HTTP Listener** configured. 2. Drag the connector to the Studio Canvas. 3. Configure the connector’s global element. You can either enter your credentials as global configuration properties or reference a configuration file that contains these values. For simpler maintenance and better reuse of your project, MuleSoft recommends that you use a configuration file. - **Address**: URL to access Roostify API - **Username**: The user name to access Roostify API - **Password**: Password to access Roostify API - **Version**: Roostify API version. For example, this property should contain `/v1`, if the API version is `v1`. > [!TIP] An example configuration file for Roostify is available at > `src/main/resources/configuration.yaml`. You can add this file in the Configuration > Properties of the Global Configuration Elements. 4. To ensure that your connection is successful, Click **Test Connection**. 5. Select a connector operation. ## Use Case: Create a Roostify User and a Loan Application The following use case demonstrates how you can use the Roostify connector along with Salesforce connector to: - Create a user in Roostify for a Salesforce account - Create a loan application for the same user in Roostify In this example, a Mule application queries Salesforce accounts and creates a user in Roostify for this account. Next step in the flow is to create a loan application for this new user in Roostify. ![Create user and loan application flow](/mulesoft/current/en-us/roostify-connector/latest/_images/roostify-create-loan-application.png) To test this use case: 1. Create a Mule application and set the connector configuration properties in the configuration file in the `src/main/resources`. For example: ```yaml rsf: address: "" version: "/" user: "" password: "" ``` 2. Add the configuration file for the Roostify connector to the **Configuration Properties** of the **Global Configuration Elements**. To create the new Mule application flow: 1. Drag an HTTP Listener to the canvas and configure it. 2. From the **Palette**, search for the Salesforce connector and drag **Query** operation. To configure Salesforce operation, 1. Add your query in the **Salesforce query**. For the purpose of this demo, use the following query to get the account from Salesforce. ```sql SELECT Id, AccountNumber, Phone, Name FROM Account where Id = ':sfId' ``` 2. In the **Parameters** section, create a parameter with `sfId` as **Name** and `attributes.queryParams.sfcId` as **Value**. 3. Select and drag Transform Message at the flow on the canvas to prepare the input for the Roostify connector. Here’s an example of the output payload in the transform message. ```json %dw 2.0 output application/json --- { user_role: "borrower", home_phone: payload.Phone[0], reference_id: "Test-ref-123", last_name: "Demo", account_id: payload.AccountNumber[0], job_title: "ADMIN", first_name: payload.Name[0], email: payload.Id[0] ++ "@roostify.com" } ``` 4. From Roostify operations, drag the **Create a User** connector operation after the transform message. In the configuration options: 1. Select the connector configuration that you created. 2. Set the **General** section in the connector configuration to `payload`. 3. Set the **Target Value** in the **Advanced** section to `#[payload]`. 5. From the **Mule Palette**, search and drag **Set Variable** operation after the Roostify operation, to capture the user ID returned from Roostify into a variable. In the **Settings** section of the **Set Variable** operation, set the following: 1. **Name**: `userId` 2. **Value**: `#[payload.id]` 6. From Roostify operations, drag **Create a Loan Application** operation. In the configuration options, 1. Use the following example payload in the **Create loan request** of the **General** section: ```json output application/json --- { reference_id: vars.refId, application_type: "purchase", loan_amount: 20000, down_payment: 1000, amortization_term: "30" } ``` 2. Set the **Target Value** in the **Advanced** section to `#[payload]`. 7. Once again, from the **Mule Palette**, search and drag **Set Variable** operation after the Roostify operation, to capture the loan ID returned from Roostify into a variable. In the **Settings** section of the **Set Variable** operation, set the following: 1. **Name**: `userId` 2. **Value**: `#[payload.id]` 8. Use another Transform Message component to display the response in JSON format. The output payload of the transform message can be set to the following: ```json %dw 2.0 output application/json --- { "RSF Account Id" : payload.account_id, "User Id" : vars.userId, "Loan Id" : vars.loanId } ``` 9. Run the application and point your browser to `http://localhost:8081/createLoanApplication`. ## Use Cases XML: Create a Roostify User and a Loan Application ```xml SELECT Id, AccountNumber, Phone, Name FROM Account where Id = ':sfId' ``` ## See Also - [Salesforce Help](https://help.salesforce.com) --- product: Roostify Connector version: 1.0 is-latest-version: true --- # Roostify Connector Reference > For the full documentation index, see: https://docs.mulesoft.com/llms.txt Roostify Connector v1.0 Anypoint Connector for Roostify (Roostify Connector) enables customers to convert completed loan applications to an optimized and intuitive digital user experience, tailored to each DBA, branch, or channel. This is the main class of an extension, and is the entry point from which configurations, connection providers, operations and sources are declared. Release Notes: [Roostify Connector Release Notes](https://docs.mulesoft.com/release-notes/connector/roostify-connector-release-notes-mule-4) ## Configurations --- ### Default Configuration Default configuration #### Parameters
NameTypeDescriptionDefault ValueRequired

Name

String

The name for this configuration. Connectors reference the configuration with this name.

x

Connection

The connection types to provide to this configuration.

x

Address

String

x

Version

String

x

Expiration Policy

Configures the minimum amount of time that a dynamic configuration instance can remain idle before the runtime considers it eligible for expiration. This does not mean that the platform expires the instance at the exact moment that it becomes eligible. The runtime purges the instances when it sees fit.

#### Connection Types ##### Connection ###### Parameters
NameTypeDescriptionDefault ValueRequired

Username

String

x

Password

String

x

Proxy Configuration

Use Persistent Connections

Boolean

true

Max Connections

Number

-1

Connection Idle Timeout

Number

60000

Stream Response

Boolean

false

Response Buffer Size

Number

-1

Connection Timeout

Number

60000

TLS Configuration

Reconnection

When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy

## Supported Operations - [Activate a User](#activateUser) - [Create a Lead](#creatingLead) - [Create a Loan Application](#creatingLoanApplication) - [Create a Message](#creatingMessage) - [Create a Status Update](#creatingStatusUpdate) - [Create a Task from a File Content Task](#creatingFileContentTask) - [Create a Task from a Form Task](#creatingTaskFromForm) - [Create a Task from a Regular Task](#creatingRegularTask) - [Create a Task from a Speed-bump Task](#creatingSpeedBumpTask) - [Create a Task from a View-only Task](#creatingViewOnlyTask) - [Create a Task from an Approval Task](#creatingTaskFromApproval) - [Create a Webhook](#creatingWebhook) - [Create a User](#createUser) - [Create an Access Control Group](#createAccessControl) - [Create or Update a Reference ID](#createUpdateReferenceId) - [Deactivate a User](#cancelOrder) - [Delete a Webhook](#deletingWebhook) - [Download a Document](#downloadingDocument) - [List Accounts](#listingAccounts) - [List Documents](#listingDocuments) - [List Loan Applications](#listingLoanApplications) - [List Messages](#getMessages) - [List Users](#listingUsers) - [List Webhooks](#listingWebhooks) - [Listing Tasks](#listingTasks) - [Listing Webhook Events](#listingWebhookEvents) - [Retrieve a Document Metadata](#retrievingDocument) - [Retrieve a Lead](#getLead) - [Retrieve a Loan Application](#loanApplicationsId) - [Retrieve a Loan Application by Reference ID](#loanApplicationByReferenceId) - [Retrieve a Loan Application in FNM Format](#loanApplicationsFNM) - [Retrieve a Loan Application in MISMO Format](#loanApplicationsMISMO) - [Retrieve a Message](#retrievingMessage) - [Retrieve a Service](#retrieveYourService) - [Retrieve a Task](#retrievingATask) - [Retrieve a User](#retrievingUser) - [Retrieve a User Settings](#userSettings) - [Retrieve a Webhook](#retrievingWebhook) - [Retrieve an Account](#retrievingAccount) - [Retrieve an Integration Service](#retrievingSettings) - [Update a Document Metadata](#updateDocument) - [Update a Loan Application](#updatingLoanApplication) - [Update a Task](#updateTask) - [Update a User](#updateUser) - [Update an Access Control Group](#updateAccessControl) - [Upload or Create a Document](#creatingDocument) ## Operations ### Activate a User `` #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Id

String

User ID (Required).

x

Output Mime Type

String

The mime type of the payload that this operation outputs.

Output Encoding

String

The encoding of the payload that this operation outputs.

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Binary

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Deactivate a User `` #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Id

String

User ID (Required).

x

Output Mime Type

String

The mime type of the payload that this operation outputs.

Output Encoding

String

The encoding of the payload that this operation outputs.

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Binary

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Create an Access Control Group `` #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Access Control

Object

Create access control request body

#[payload]

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Create or Update a Reference ID `` Reference IDs allow users to work with an external service or integration. Using this route either creates or updates a reference ID. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Loan_id

String

ID of the loan application to update.

x

Reference Body

Object

The request body for updating the loan.

#[payload]

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Create a User `` Create a user. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

User Body

Object

Roostify create user request body.

#[payload]

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Upload or Create a Document `` To upload a document, POST the document as JSON to /documents. The file\_content in your payload body should be the base64 encoded bytes of the document. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Document

Object

Request body for create a document

#[payload]

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Create a Task from a File Content Task `` Create a task from a file content task. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

File Content Task

Object

Request body for creating a task from a file content task.

#[payload]

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Create a Lead `` The leads endpoint accepts parameters to create a Lead in Roostify. Each parameter must be allowlisted or it is not allowed within the system. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Create Lead

Object

The request body for creating a lead.

#[payload]

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Create a Loan Application `` Creating a loan application must be granted on a service by service basis. Access is denied by default. A Loan Application may be created with any of the attributes listed above as parameters to the API. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Create Loan Request

Object

Create loan request body.

#[payload]

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Create a Message `` When the accounts email and name are filled in, the from address for messages created from this endpoint uses the account name and email address. Otherwise, emails are sent from an email address similar to [no-reply@deliver.roostify.com](mailto:no-reply@deliver.roostify.com). #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Message

Object

Message request body for creating message.

#[payload]

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Create a Task from a Regular Task `` Create a task from a regular task. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Regular Task

Object

Request body for creating a task from a regular task.

#[payload]

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Create a Task from a Speed-bump Task `` Create a task from a speed-bump task. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Speed Bump Task

Object

Request body for creating a task from a speed-bump task.

#[payload]

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Create a Status Update `` A status update appears in the Stream that collaborators use to monitor updates to a loan application. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Status

Object

Request body for create status update

#[payload]

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Create a Task from an Approval Task `` Create a new task from an approval task. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Approval Task

Object

Request body for creating a task from an approval task.

#[payload]

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Create a Task from a Form Task `` Create a new task from a form task. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Form Task

Object

Request body for creating a task from a form task.

#[payload]

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Create a Task from a View-only Task `` Create a talk from a view-only task. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

View Only Task

Object

Request body for creating a task from a view-only task.

#[payload]

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Create a Webhook `` #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Webhook Body

Object

Request body for create webhook

#[payload]

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Delete a Webhook `` #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Webhook Id

String

ID of the webhook to destroy.

x

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Download a Document `` #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Id

String

Required. ID of the document to retrieve.

x

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Retrieve a Lead `` The leads endpoint accepts parameters to create a Lead in Roostify. Each parameter must be allowlisted or it is not allowed within the system. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Lead Id

String

ID of the lead.

x

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### List Messages `` #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### List Accounts `` Retrieve a list of all accounts. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Page

String

Indicates the page of the index which should be returned. When this parameter is not present and count is, it defaults to 1. When both parameters are not present, the pagination is disabled.

Count

String

Indicates the number of records per page returned. When this parameter is not present and page is, it defaults to 100. When both parameters are not present, the pagination is disabled.

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### List Documents `` Retrieve metadata for documents. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Page

String

Indicates the page of the index which should be returned. When this parameter is not present and count is, it defaults to 1. When both parameters are not present pagination is disabled.

Count

String

Indicates the number of records per page returned. When this parameter is not present and page is, it defaults to 100. When both parameters are not present pagination is disabled.

Filter

String

Term for filtering document metadata based presence of reference_id.

Search

String

Terms for searching document metadata. Current searchable terms are: document_name, loan_application_reference_id, and loan_application_id.

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### List Loan Applications `` This retrieves all loan applications belonging to your account or its descendants. For clients with many loan applications, this may time out if you do not use pagination. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Search

String

Only lists loan applications which match the given attributes. Param structure is search[attribute]=…​

Page

String

Indicates the page of the index which should be returned. When this parameter is not present and count is, it defaults to 1. When both parameters are not present pagination is disabled.

Count

String

Indicates the number of records per page returned. When this parameter is not present and page is, it defaults to 100. When both parameters are not present pagination is disabled.

Created

String

Filters loan applications based on when loan applications are created. The string must be formatted as two ISO-8601 datestamps separated by '…​'. If the time zone designator is omitted it defaults to UTC.

Submitted

String

Filters loan applications based on when loan applications are submitted. The string must be formatted as two ISO-8601 datestamps separated by '…​'. If the time zone designator is omitted it defaults to UTC.

Updated

String

Filters loan applications based on when loan applications are updated. The string must be formatted as two ISO-8601 datestamps separated by '…​'. If the time zone designator is omitted it defaults to UTC.

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Listing Tasks `` Return a list of all tasks and their details. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Loan_application_id

String

Loan application ID to search for associated tasks.

Page

String

Indicates the page number which should be returned. When this parameter is not present and count is, it defaults to 1. When both parameters are not present pagination is disabled.

Count

String

Indicates the number of records per page returned. When this parameter is not present and page is, it defaults to 100. When both parameters are not present pagination is disabled.

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### List Users `` List all users with their details. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Page

String

Indicates the page of the index which should be returned. When this parameter is not present and count is, it defaults to 1. When both parameters are not present pagination is disabled.

Count

String

Indicates the number of records per page returned. When this parameter is not present and page is, it defaults to 100. When both parameters are not present pagination is disabled.

Search

String

Only lists users that match the given attributes. Param structure is search[attribute]=…​ Takes a url encoded hash of search parameters.

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Listing Webhook Events `` Webhook events record every instance in which a webhook was fired for a particular event, and can act as an audit log for all events that occur that are trackable via webhooks. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Page

String

Indicates the page of the index which should be returned. When this parameter is not present and count is, it defaults to 1. When both parameters are not present pagination is disabled.

Count

String

Indicates the number of records per page returned. When this parameter is not present and page is, it defaults to 100. When both parameters are not present pagination is disabled.

Created

String

ISO 8601 DateTime range. Scope the returned results to only webhook events that were created this range of dates.

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### List Webhooks `` #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Page

String

Indicates the page of the index which should be returned. When this parameter is not present and count is, it defaults to 1. When both parameters are not present pagination is disabled.

Count

String

Indicates the number of records per page returned. When this parameter is not present and page is, it defaults to 100. When both parameters are not present pagination is disabled.

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Retrieve a Loan Application by Reference ID `` #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Reference Id

String

ID of the loan application to retrieve.

x

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Retrieve a Loan Application in FNM Format `` Unlike most of the API, the loan applications FNM endpoint returns plaintext instead of JSON. The string returned is a Base64-encoded Fannie Mae file. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Id

String

ID of the loan application to retrieve.

x

Output Mime Type

String

The mime type of the payload that this operation outputs.

Output Encoding

String

The encoding of the payload that this operation outputs.

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Binary

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Retrieve a Loan Application `` #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Find_id

String

ID of the loan application to retrieve.

x

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Retrieve a Loan Application in MISMO Format `` The ability to download a loan application in MISMO format must be requested from your Partner or Client Success Manager. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Id

String

ID of the loan application to retrieve.

x

Output Mime Type

String

The mime type of the payload that this operation outputs.

Output Encoding

String

The encoding of the payload that this operation outputs.

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Binary

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Retrieve a Service `` Applications built on Roostify often need to have configuration or other kinds of data tied to a particular user or account. For instance, if building a product to synchronize loan applications from Roostify to a loan origination system, you may want to have lenders provide their username for the loan origination system so you can properly assign them. These are considered User Settings. Account Settings are for data that is shared across a collection of users on an account. Lenders and account admins may set the values for these settings through the Roostify UI. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Retrieve a Task `` Retrieve a single task details. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Task Id

String

ID of task.

x

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Retrieve an Account `` Roostify users are members of an account. Accounts manages billing, permissions, service integrations, application and workflow customizations, co-branding styles, etc. You may access the basic information of any account that has an integration with your service. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Id

String

ID of the account.

x

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Retrieve a Document Metadata `` Retrieve the metadata for a document. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Find_id

String

ID of the document to retrieve.

x

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Retrieve a Message `` #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Message Id

String

ID of the message to retrieve.

x

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Retrieve an Integration Service `` Roostify Services are customizable on an account level. The /settings endpoint provides access to the service settings and configurations. These are returned as key/value pairs. For instance, if Roostify leverages an Integration that requires configurations, these fields, values, and the associated Lender on the Account are returned via this GET request. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Retrieve a User `` Get details of a single user. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

User Id

String

ID of the user

x

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Retrieve a Webhook `` #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Webhook Id

String

ID of the webhook to retrieve.

x

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Update an Access Control Group `` #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Access Control Group

Object

Update access control request body

#[payload]

Id

String

ID or system name of the task. If searching for an id matching the string given yields no results, then a lookup against system name is attempted.

x

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Update a Document Metadata `` Update a documents metadata and returns the documents metadata. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Document Body

Object

Request body for update a document

#[payload]

Id

String

ID of the document to update.

x

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Update a Task `` Update details of a single task. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Task Body

Object

Request body for updating task.

#[payload]

Task Id

String

ID of the task.

x

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Update a User `` #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

User

Object

Request body for update user

#[payload]

Id

String

User ID.

x

Output Mime Type

String

The mime type of the payload that this operation outputs.

Output Encoding

String

The encoding of the payload that this operation outputs.

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Binary

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Update a Loan Application `` Updating a loan application must be granted on a service by service basis. Access is denied by default. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Update_id

String

ID of the loan application to update.

x

Update Loan Request

Object

Request body for updating loan application.

#[payload]

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ### Retrieve a User Settings `` Retrieving settings for a particular user also returns the account settings for the account they are on. This reduces complexity by allowing you to make a single request for all a particular users settings. #### Parameters
NameTypeDescriptionDefault ValueRequired

Configuration

String

The name of the configuration to use.

x

Id

String

Id of the user whose settings you would like to retrieve

x

Streaming Strategy

Configure to use repeatable streams.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

#### Output

Type

Any

Attributes Type

#### For Configurations - [Default Configuration](#config) #### Throws - ROOSTIFY:BAD\_GATEWAY - ROOSTIFY:INTERNAL\_SERVER\_ERROR - ROOSTIFY:METHOD\_NOT\_ALLOWED - ROOSTIFY:UN\_PROCESSABLE\_ENTITY - ROOSTIFY:NOT\_IMPLEMENTED - ROOSTIFY:CONNECTIVITY - ROOSTIFY:GENERIC\_EXCEPTION - ROOSTIFY:NOT\_ACCEPTABLE - ROOSTIFY:NOT\_FOUND - ROOSTIFY:SERVICE\_UNAVAILABLE - ROOSTIFY:RETRY\_EXHAUSTED - ROOSTIFY:UNAUTHORIZED - ROOSTIFY:FORBIDDEN - ROOSTIFY:EMPTY\_HEAD\_COUNT - ROOSTIFY:CONFLICT - ROOSTIFY:BAD\_REQUEST - ROOSTIFY:DEAD\_TOKEN - ROOSTIFY:REQUEST\_TIMEOUT ## Types ### Default
FieldTypeDescriptionDefault ValueRequired

Host

String

Host where the proxy requests is sent.

x

Port

Number

Port where the proxy requests is sent.

x

Username

String

The username to authenticate against the proxy.

Password

String

The password to authenticate against the proxy.

Non Proxy Hosts

String

A list of comma-separated hosts against which the proxy should not be used

### TLS
FieldTypeDescriptionDefault ValueRequired

Enabled Protocols

String

A comma-separated list of protocols enabled for this context.

Enabled Cipher Suites

String

A comma-separated list of cipher suites enabled for this context.

Trust Store

Key Store

Revocation Check

### Trust Store
FieldTypeDescriptionDefault ValueRequired

Path

String

The location (which will be resolved relative to the current classpath and file system, if possible) of the trust store.

Password

String

The password used to protect the trust store.

Type

String

The type of store used.

Algorithm

String

The algorithm used by the trust store.

Insecure

Boolean

If true, no certificate validations will be performed, rendering connections vulnerable to attacks. Use at your own risk.

### Key Store
FieldTypeDescriptionDefault ValueRequired

Path

String

The location (which will be resolved relative to the current classpath and file system, if possible) of the key store.

Type

String

The type of store used.

Alias

String

When the key store contains many private keys, this attribute indicates the alias of the key that should be used. If not defined, the first key in the file will be used by default.

Key Password

String

The password used to protect the private key.

Password

String

The password used to protect the key store.

Algorithm

String

The algorithm used by the key store.

### Standard Revocation Check
FieldTypeDescriptionDefault ValueRequired

Only End Entities

Boolean

Only verify the last element of the certificate chain.

Prefer CRLs

Boolean

Try CRL instead of OCSP first.

No Fallback

Boolean

Do not use the secondary checking method (the one not selected before).

Soft Fail

Boolean

Avoid verification failure when the revocation server can not be reached or is busy.

### Custom OCSP Responder
FieldTypeDescriptionDefault ValueRequired

Url

String

The URL of the OCSP responder.

Cert Alias

String

Alias of the signing certificate for the OCSP response (must be in the trust store), if present.

### CRL File
FieldTypeDescriptionDefault ValueRequired

Path

String

The path to the CRL file.

### Reconnection
FieldTypeDescriptionDefault ValueRequired

Fails Deployment

Boolean

When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.

Reconnection Strategy

The reconnection strategy to use.

### Reconnect
FieldTypeDescriptionDefault ValueRequired

Frequency

Number

How often in milliseconds to reconnect.

Count

Number

How many reconnection attempts to make.

blocking

Boolean

If false, the reconnection strategy runs in a separate, non-blocking thread.

true

### Reconnect Forever
FieldTypeDescriptionDefault ValueRequired

Frequency

Number

How often in milliseconds to reconnect.

blocking

Boolean

If false, the reconnection strategy runs in a separate, non-blocking thread.

true

### Expiration Policy
FieldTypeDescriptionDefault ValueRequired

Max Idle Time

Number

A scalar time value for the maximum amount of time a dynamic configuration instance should be allowed to be idle before it’s considered eligible for expiration

Time Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

A time unit that qualifies the maxIdleTime attribute

### Response Status
FieldTypeDescriptionDefault ValueRequired

Headers

Object

Status Code

Number

### Repeatable In Memory Stream
FieldTypeDescriptionDefault ValueRequired

Initial Buffer Size

Number

The amount of memory to allocate to consume the stream and provide random access to it. If the stream contains more data than can fit into this buffer, then the buffer expands according to the bufferSizeIncrement attribute, with an upper limit of maxInMemorySize.

Buffer Size Increment

Number

This is by how much the buffer size expands if it exceeds its initial size. Setting a value of zero or lower means that the buffer should not expand, meaning that a STREAM_MAXIMUM_SIZE_EXCEEDED error is raised when the buffer gets full.

Max Buffer Size

Number

The maximum amount of memory to use. If more than that is used then a STREAM_MAXIMUM_SIZE_EXCEEDED error is raised. A value lower than or equal to zero means no limit.

Buffer Unit

Enumeration, one of:

  • BYTE

  • KB

  • MB

  • GB

The unit in which all these attributes are expressed

### Repeatable File Store Stream
FieldTypeDescriptionDefault ValueRequired

Max In Memory Size

Number

Defines the maximum memory that the stream should use to keep data in memory. If more than that is consumed then it will start to buffer the content on disk.

Buffer Unit

Enumeration, one of:

  • BYTE

  • KB

  • MB

  • GB

The unit in which maxInMemorySize is expressed

## See Also [Salesforce Help](https://help.salesforce.com)