Integrated accounts can be categorised into two types, Test and Production.

Test account

• Test account as the name suggests is not billed and generally used for development/testing purpose.
• All integrated accounts are marked as Test by default but can be changed to Production using any of the options mentioned below in this article .
• A Test account is deactivated after 30 calendar days and can't be reinstated.
• A Knit account can have up to 3 Test integrated accounts.

Production account

• Production accounts are used for billing purposes.
• There are no limits to the number to Production integrated accounts an account can have.
• Production accounts are not deactivated unless manually done through the dashboard.
• Account marked as Production can be converted to a Test account using any of the options mentioned below in this article .

Converting account types

One can convert any integrated account marked as Test to Production account type or vice versa in the following ways:

During new Integrated Account creation

Auth Session Creation API

Passing a boolean value for the optional body param testAccount can be used to mark the integrated account as Test or Production.

If the testAccount param is not passed, the organisation level default setting is used to mark the integrated account as Test or Production.

For example, the following cURL would mark the integration as Test

curl --request POST \
     --url https://api.getknit.dev/v1.0/auth.createSession \
     --header 'Authorization: Bearer <YOUR_API_KEY>' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "testAccount": true,
  "originOrgId": "client1",
  "originOrgName": "Client 1",
  "originUserEmail": "[email protected]",
  "originUserName": "User 1"
}
'

Magic Link Creation

While creating a magic link, one can choose to make the integrated account generated via the magic link as Test or Production via the Mark as Test account switch in Magic link form.

Switch an existing Integrated Account from Test to Production or vice versa

Integrated Accounts Page

For existing integrated accounts, one can switch between Test and Production account type via ⋮ icon in the table listing details for each integrated account.

Mark future Integrated Accounts as Test or Production by default

Integrated Accounts Settings switch

All integrated accounts created in future can be marked from as Test or Production by default through Integrated Accounts Settings.