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	contact@korto.info

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

Operation ID:

CreateRecord

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

Body

RecordQueryResponseItem

Korto Record definition get

Operation ID:

GetRecord

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

Body

RecordQueryResponseItem

Korto Record delete

Operation ID:

DeleteRecord

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

Operation ID:

DownloadRecord

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

Operation ID:

AddTagToRecord

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

Body

RecordQueryResponseItem

Korto Record Tag value delete

Operation ID:

DeleteTagFromRecord

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

Operation ID:

UpdateTagOnRecord

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

Body

RecordQueryResponseItem

Korto Tag definition create

Operation ID:

CreateTag

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

Operation ID:

DeleteTag

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

Operation ID:

GetTag

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