KORTO V2 (Preview)
Custom connector to a Korto record management system v2.0
This connector is available in the following products and regions:
| Service | Class | Regions |
|---|---|---|
| Logic Apps | Standard | All Logic Apps regions except the following: - Azure Government regions - Azure China regions - US Department of Defense (DoD) |
| Power Automate | Premium | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Power Apps | Premium | All Power Apps regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Contact | |
|---|---|
| Name | Korto |
| URL | https://korto.io/ |
| [email protected] |
| Connector Metadata | |
|---|---|
| Publisher | Korto |
| Website | https://korto.io/ |
| Privacy policy | https://korto.io/ |
| Categories | Content and Files;Data |
Use this connector to communicate with your instance of the Korto Record Management Systems API v2.0.
Prerequisites
Contact us to get your instance of the Korto application environment. After setting up your Korto environment, you'll be able to get the necessary Korto API URL and API Key to create the connector connection.
How to get credentials
For authentication, you need to use an API Key. You can create keys in the Admin section, within your Korto application instance.
Get started with your connector
Before using this connector, you should be farmiliar with the Korto application environment and the concepts of Korto tags, records and record tag values. Supported tag operations are: create a tag definition, get the tag definition and delete a tag definition. Supported record operations are: create a record, get the record definition, download the record file content and delete a record definition. Supported record tag value operations are: add a tag value to a record, update a tag value on a record and delete a tag value on a record.
Known issues and limitations
Currently, there are no reported issues and limitations.
Deployment Instructions
Please use these Microsoft instructions to deploy this connector as a custom connector in Microsoft Power Automate and Power Apps.
Creating a connection
The connector supports the following authentication types:
| Default | Parameters for creating connection. | All regions | Not shareable |
Default
Applicable: All regions
Parameters for creating connection.
This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.
| Name | Type | Description | Required |
|---|---|---|---|
| API Key | securestring | The API Key for this api | True |
| Korto API URL | string | Full URL to your Korto instance API. | True |
Throttling Limits
| Name | Calls | Renewal Period |
|---|---|---|
| API calls per connection | 100 | 60 seconds |
Actions
| Korto Record create |
Create a new Record in Korto |
| Korto Record definition get |
Get a Record definition from Korto |
| Korto Record delete |
Delete a Record from Korto |
| Korto Record download |
Download the Record file content from Korto |
| Korto Record Tag value add |
Add a Tag from a Record in Korto |
| Korto Record Tag value delete |
Delete a Tag from a Record in Korto |
| Korto Record Tag value update |
Update a value of an already existing Tag on a Korto Record |
| Korto Tag definition create |
Create a new Tag definition in Korto |
| Korto Tag definition delete |
Delete a Tag definition in Korto |
| Korto Tag definition get |
Get a definition of a Tag defined in Korto |
Korto Record create
Create a new Record in Korto
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Name of the new Record
|
name | string |
Name of the new Record |
|
|
Name of the external system
|
actor | string |
Name of the external system |
|
|
Unique Record ID in the external system
|
externalid | string |
Unique Record ID in the external system |
|
|
Unique Record URL in the external system
|
externalurl | string |
Unique Record URL in the external system |
|
|
Date and time of the creation
|
createdAt | string |
Date and time of the creation |
|
|
Creator name
|
createdBy | string |
Creator name |
|
|
The file content to upload
|
file | True | file |
The file content to upload |
Returns
Korto Record definition get
Get a Record definition from Korto
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Unique Record ID in Korto
|
recordID | integer |
Unique Record ID in Korto |
|
|
UniqueRecord ID in the external system
|
externalRecordID | string |
UniqueRecord ID in the external system |
Returns
Korto Record delete
Delete a Record from Korto
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Unique Record ID in Korto
|
recordID | integer |
Unique Record ID in Korto |
|
|
Unique Record ID in the external system
|
externalRecordID | string |
Unique Record ID in the external system |
Korto Record download
Download the Record file content from Korto
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Unique Record ID in Korto
|
recordID | integer |
Unique Record ID in Korto |
|
|
Unique Record ID in the external system
|
externalRecordID | string |
Unique Record ID in the external system |
Returns
- Body
- DownloadUrlMessage
Korto Record Tag value add
Add a Tag from a Record in Korto
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Unique Record ID in Korto
|
recordID | integer |
Unique Record ID in Korto |
|
|
Unique Record ID in the external system
|
externalRecordID | string |
Unique Record ID in the external system |
|
|
Unique Tag name in Korto
|
tagName | string |
Unique Tag name in Korto |
|
|
The value of the added Tag
|
tagValue | string |
The value of the added Tag |
Returns
Korto Record Tag value delete
Delete a Tag from a Record in Korto
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Unique Record ID in Korto
|
recordID | integer |
Unique Record ID in Korto |
|
|
Unique Record ID in the external system
|
externalRecordID | string |
Unique Record ID in the external system |
|
|
Unique Tag name in Korto
|
tagName | string |
Unique Tag name in Korto |
Korto Record Tag value update
Update a value of an already existing Tag on a Korto Record
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Unique Record ID in Korto
|
recordID | integer |
Unique Record ID in Korto |
|
|
Unique Record ID in the external system
|
externalRecordID | string |
Unique Record ID in the external system |
|
|
Unique Tag name in Korto
|
tagName | string |
Unique Tag name in Korto |
|
|
New Tag value
|
tagValue | string |
New Tag value |
Returns
Korto Tag definition create
Create a new Tag definition in Korto
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Unique name of the Tag
|
tagName | string |
Unique name of the Tag |
|
|
Type of a Tag
|
tagType | integer |
SystemTag is 0,LabelTag is 1,UntypedLabelTag is 2,AutoTag is 3,ActionTag is 4 |
|
|
Type of data a Tag is storing
|
tagValueType | integer |
None is 0,String is 1,Int is 2,Decimal is 3,DateTime is 4,Bool is 5,MasterData is 6 |
Returns
- Body
- QueryTagResponseItem
Korto Tag definition delete
Delete a Tag definition in Korto
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Unique ID of the Tag in Korto
|
tagID | integer |
Unique ID of the Tag in Korto |
|
|
Unique name of the Tag in Korto
|
tagName | string |
Unique name of the Tag in Korto |
Korto Tag definition get
Get a definition of a Tag defined in Korto
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Unique ID of the Tag in Korto
|
tagID | integer |
Unique ID of the Tag in Korto |
|
|
Unique name of the Tag in Korto
|
tagName | string |
Unique name of the Tag in Korto |
Returns
- Body
- QueryTagsResponse
Definitions
QueryTagResponseItem
| Name | Path | Type | Description |
|---|---|---|---|
|
id
|
id | integer | |
|
name
|
name | string | |
|
|
type | integer | |
|
|
valueType | integer | |
|
synonymsCount
|
synonymsCount | integer | |
|
recordsCount
|
recordsCount | integer | |
|
synonymId
|
synonymId | integer | |
|
createdAt
|
createdAt | date-time | |
|
isPredefined
|
isPredefined | boolean | |
|
isRequired
|
isRequired | boolean | |
|
additionalFormattingType
|
additionalFormattingType | integer | |
|
isRelatedTag
|
isRelatedTag | boolean |
QueryTagsResponse
| Name | Path | Type | Description |
|---|---|---|---|
|
|
totalItems | integer | |
|
data
|
data | array of QueryTagResponseItem |
RecordQueryResponseItem
| Name | Path | Type | Description |
|---|---|---|---|
|
id
|
id | integer | |
|
name
|
name | string | |
|
version
|
version | double | |
|
versions
|
versions | array of RecordVersion | |
|
tags
|
tags | array of TagResponseMessage | |
|
actor
|
actor | string | |
|
externalId
|
externalId | string | |
|
checksum
|
checksum | string | |
|
downloadsCount
|
downloadsCount | integer | |
|
editCount
|
editCount | integer | |
|
createdBy
|
createdBy | string | |
|
createdAt
|
createdAt | date-time |
RecordVersion
| Name | Path | Type | Description |
|---|---|---|---|
|
id
|
id | integer | |
|
name
|
name | string | |
|
version
|
version | double | |
|
actor
|
actor | string | |
|
createdAt
|
createdAt | date-time | |
|
createdBy
|
createdBy | string | |
|
externalId
|
externalId | string |
TagResponseMessage
| Name | Path | Type | Description |
|---|---|---|---|
|
stringValue
|
stringValue | string | |
|
intValue
|
intValue | integer | |
|
decimalValue
|
decimalValue | double | |
|
dateTimeValue
|
dateTimeValue | date-time | |
|
boolValue
|
boolValue | boolean | |
|
valueType
|
valueType | integer | |
|
tagId
|
tagId | integer | |
|
name
|
name | string | |
|
type
|
type | integer | |
|
retentionMonth
|
retentionMonth | integer | |
|
isPredefined
|
isPredefined | boolean | |
|
isRequired
|
isRequired | boolean | |
|
additionalFormattingType
|
additionalFormattingType | integer |
DownloadUrlMessage
| Name | Path | Type | Description |
|---|---|---|---|
|
url
|
url | string |