Kissflow
App · 25 actions
Run your Kissflow approvals from workflows: start and submit requests, approve, reject or send back tasks, keep board items and dataset rows up to date, and start a workflow when a request is submitted, moves on or finishes, or a board item changes status.
Actions
| Action | What it does |
|---|---|
| Approve or submit task | Finish your step on a process item: approve it at an approval step, or submit it at any other step, a draft included. |
| Create board item | Add an item to a board, with its title, assignee, requester, due date, status and the board's own fields. |
| Create dataset row | Add a row to a dataset, with a key no other row has and its other columns' values. |
| Create process item | Start a new item (a request) in a process with the fields you give, and submit it to the process's first step. |
| Delete board item | Delete an item from a board for good. |
| Delete dataset row | Delete the dataset row with this key for good. |
| Delete process item | Delete an item from a process for good. |
| Get board item | Get a board item's title, status, assignee and fields. |
| Get dataset row | Get the dataset row with this key. |
| Get process item | Get a process item's fields, status and the step it is at. |
| List board fields | List the fields of a board's items, with the IDs steps fill them in by. |
| List board items | List a board's items, a page at a time. |
| List dataset rows | List a dataset's rows, a page at a time, or find rows by words in them. |
| List flows | List the account's processes, boards or datasets, with the IDs other steps take. |
| List my process items | List the items of a process you, the access key's user, started or took part in. |
| List my tasks | List the items of a process waiting for you, the access key's user, to act on, with the step each is at. |
| List process fields | List the fields of a process's form, with the IDs steps fill them in by. |
| List process items | List every item of a process, a page at a time. |
| List users | List the account's users, a page at a time, or find them by name. |
| Move board item | Move a board item to another status, such as Done. |
| Reject task | Reject a process item at your step, with a note saying why. |
| Send back task | Send a process item back from your step to an earlier one, with a note saying what to change. |
| Update board item | Change a board item's title, assignee, due date or fields. |
| Update dataset row | Change the columns of the dataset row with this key. |
| Update process item | Change a process item's fields wherever it is in the process, without moving it on. |
Approve or submit task
Finish your step on a process item: approve it at an approval step, or submit it at any other step, a draft included. Fields you fill in are saved first.
Inputs
- Process
processtextRequired - The process. Pick it, or type its ID from its address in Kissflow, such as Purchase_request.
- Item
itemtextRequired - The item's ID, from another Kissflow step or the trigger, or a link to it opened in Kissflow.
- Step ID
steptext - The ID of the step the item is at, from the trigger or 'List my tasks'. Leave blank to find it among your tasks, or when the item's link has it.
- Fields
fieldsobject - Values for the process's form fields. Fill in only what you need. For a person or a linked record, give its ID as {"_id": "..."}.
Outputs
idtext- The item's ID
messagetext- What Kissflow said
process_idtext- The process's ID
step_idtext- The ID of the step it was at
submittedtrue/false- True once it is submitted
Example output
{
"id": "Pk9ALV9QVo5L",
"message": "Submitted successfully",
"process_id": "Purchase_request",
"step_id": "Pk9ALV9RNK_A",
"submitted": true
}Create board item
Add an item to a board, with its title, assignee, requester, due date, status and the board's own fields.
Inputs
- Board
boardtextRequired - The board. Pick it, or type its ID from its address in Kissflow.
- Title
titletextRequired - What the item is about.
- Assigned to
assigned_totext - Who works on it.
- Requester
requestertext - Who asked for it.
- Due
duedate and time - When it is due.
- Status
statustext - The status it starts in. Leave blank for the board's first.
- Fields
fieldsobject - Values for the board's own fields. Fill in only what you need. For a person or a linked record, give its ID as {"_id": "..."}.
Outputs
assigned_totext- Who it is assigned to
assigned_to_idtext- Their user ID
board_idtext- The board's ID
categorytext- The kind of status, such as InProgress or Completed
created_attext- When it was added (ISO 8601)
created_bytext- Who added it
fieldsobject- The values of the fields its form has, by field ID
idtext- The item's ID
item_numbertext- Its number on the board, such as TKT-12
modified_attext- When it last changed (ISO 8601)
prioritytext- Its priority
requestertext- Who asked for it
requester_idtext- Their user ID
statustext- The status it is in, such as In progress
status_idtext- That status's ID
titletext- Its title
Example output
{
"assigned_to": "Grace Hopper",
"assigned_to_id": "Us7Jbc9XkQ2a",
"board_id": "IT_helpdesk",
"category": "InProgress",
"created_at": "2026-11-05T09:00:00+00:00",
"created_by": "Ada Lovelace",
"fields": {
"Category": "Hardware"
},
"id": "Pk9BcD3eF4gH",
"item_number": "TKT-12",
"modified_at": "2026-11-05T09:30:00+00:00",
"priority": "High",
"requester": "Ada Lovelace",
"requester_id": "Us1aB2cD3eF4",
"status": "In progress",
"status_id": "In_progress_A01",
"title": "Printer on floor 2 is jammed"
}Create dataset row
Add a row to a dataset, with a key no other row has and its other columns' values.
Inputs
- Dataset
datasettextRequired - The dataset. Pick it, or type its ID from its address in Kissflow.
- Key
keytextRequired - The row's value in the dataset's Name column, which no other row has.
- Fields
fieldsobject - Values for the dataset's columns. Fill in only what you need.
Outputs
dataset_idtext- The dataset's ID
fieldsobject- Its other columns' values, by column ID
idtext- The row's ID; empty when Kissflow doesn't say
keytext- Its value in the Name column, which no other row has
Example output
{
"dataset_id": "Cost_centres",
"fields": {
"Budget_owner": "Grace Hopper",
"Department": "Finance"
},
"id": "Pk9DeF5gH6iJ",
"key": "CC-104"
}Create process item
Start a new item (a request) in a process with the fields you give, and submit it to the process's first step. Turn off Submit it to keep it as a draft.
Inputs
- Process
processtextRequired - The process. Pick it, or type its ID from its address in Kissflow, such as Purchase_request.
- Fields
fieldsobject - Values for the process's form fields. Fill in only what you need. For a person or a linked record, give its ID as {"_id": "..."}.
- Submit it
submittrue/false - Submit it at once. Off keeps it as a draft.Default:
true.
Outputs
draft_step_idtext- The ID of the step it was made at. 'Approve or submit task' takes it to submit a draft later
idtext- The new item's ID
process_idtext- The process's ID
submittedtrue/false- True if it was submitted, false if it was kept as a draft
Example output
{
"draft_step_id": "Pk9ALV9RNK_A",
"id": "Pk9ALV9QVo5L",
"process_id": "Purchase_request",
"submitted": true
}Delete board item
Delete an item from a board for good.
Inputs
- Board
boardtextRequired - The board. Pick it, or type its ID from its address in Kissflow.
- Item
itemtextRequired - The item's ID, from another Kissflow step or the trigger.
Outputs
board_idtext- The board's ID
deletedtrue/false- True once it is deleted
idtext- The item's ID
Example output
{
"board_id": "IT_helpdesk",
"deleted": true,
"id": "Pk9BcD3eF4gH"
}Delete dataset row
Delete the dataset row with this key for good.
Inputs
- Dataset
datasettextRequired - The dataset. Pick it, or type its ID from its address in Kissflow.
- Key
keytextRequired - The row's value in the dataset's Name column, which no other row has.
Outputs
dataset_idtext- The dataset's ID
deletedtrue/false- True once it is deleted
keytext- The row's key
Example output
{
"dataset_id": "Cost_centres",
"deleted": true,
"key": "CC-104"
}Delete process item
Delete an item from a process for good. The access key's user must be a Process Admin of the process.
Inputs
- Process
processtextRequired - The process. Pick it, or type its ID from its address in Kissflow, such as Purchase_request.
- Item
itemtextRequired - The item's ID, from another Kissflow step or the trigger, or a link to it opened in Kissflow.
Outputs
deletedtrue/false- True once it is deleted
idtext- The item's ID
process_idtext- The process's ID
Example output
{
"deleted": true,
"id": "Pk9ALV9QVo5L",
"process_id": "Purchase_request"
}Get board item
Get a board item's title, status, assignee and fields.
Inputs
- Board
boardtextRequired - The board. Pick it, or type its ID from its address in Kissflow.
- Item
itemtextRequired - The item's ID, from another Kissflow step or the trigger.
Outputs
assigned_totext- Who it is assigned to
assigned_to_idtext- Their user ID
board_idtext- The board's ID
categorytext- The kind of status, such as InProgress or Completed
created_attext- When it was added (ISO 8601)
created_bytext- Who added it
fieldsobject- The values of the fields its form has, by field ID
idtext- The item's ID
item_numbertext- Its number on the board, such as TKT-12
modified_attext- When it last changed (ISO 8601)
prioritytext- Its priority
requestertext- Who asked for it
requester_idtext- Their user ID
statustext- The status it is in, such as In progress
status_idtext- That status's ID
titletext- Its title
Example output
{
"assigned_to": "Grace Hopper",
"assigned_to_id": "Us7Jbc9XkQ2a",
"board_id": "IT_helpdesk",
"category": "InProgress",
"created_at": "2026-11-05T09:00:00+00:00",
"created_by": "Ada Lovelace",
"fields": {
"Category": "Hardware"
},
"id": "Pk9BcD3eF4gH",
"item_number": "TKT-12",
"modified_at": "2026-11-05T09:30:00+00:00",
"priority": "High",
"requester": "Ada Lovelace",
"requester_id": "Us1aB2cD3eF4",
"status": "In progress",
"status_id": "In_progress_A01",
"title": "Printer on floor 2 is jammed"
}Get dataset row
Get the dataset row with this key.
Inputs
- Dataset
datasettextRequired - The dataset. Pick it, or type its ID from its address in Kissflow.
- Key
keytextRequired - The row's value in the dataset's Name column, which no other row has.
Outputs
dataset_idtext- The dataset's ID
fieldsobject- Its other columns' values, by column ID
idtext- The row's ID; empty when Kissflow doesn't say
keytext- Its value in the Name column, which no other row has
Example output
{
"dataset_id": "Cost_centres",
"fields": {
"Budget_owner": "Grace Hopper",
"Department": "Finance"
},
"id": "Pk9DeF5gH6iJ",
"key": "CC-104"
}Get process item
Get a process item's fields, status and the step it is at. Without a step ID or a link that has one, the access key's user must be a Process Admin of the process.
Inputs
- Process
processtextRequired - The process. Pick it, or type its ID from its address in Kissflow, such as Purchase_request.
- Item
itemtextRequired - The item's ID, from another Kissflow step or the trigger, or a link to it opened in Kissflow.
- Step ID
steptext - The ID of the step the item is at, from the trigger or 'List my tasks'. Leave blank to find it among your tasks, or when the item's link has it.
Outputs
assigned_tolist- Who it is waiting for at that step
assigned_to_idslist- Their user IDs
created_attext- When it was started (ISO 8601)
created_bytext- Who started it
current_steptext- The step it is at
fieldsobject- The values of the fields its form has, by field ID
idtext- The item's ID
modified_attext- When it last changed (ISO 8601)
nametext- Its title
process_idtext- The process's ID
progressnumber- How far through the process it is, in percent
statustext- Draft, InProgress, Completed, Rejected or Withdrawn
step_idtext- The ID of the step it is at, when Kissflow gives it
Example output
{
"assigned_to": [
"Grace Hopper"
],
"assigned_to_ids": [
"Us7Jbc9XkQ2a"
],
"created_at": "2026-11-05T09:00:00+00:00",
"created_by": "Ada Lovelace",
"current_step": "Manager approval",
"fields": {
"Amount": 1200,
"Reason": "New starter"
},
"id": "Pk9ALV9QVo5L",
"modified_at": "2026-11-05T09:30:00+00:00",
"name": "Laptop for Ada",
"process_id": "Purchase_request",
"progress": 50,
"status": "InProgress",
"step_id": "Pk9ALV9RNK_A"
}List board fields
List the fields of a board's items, with the IDs steps fill them in by.
Inputs
- Board
boardtextRequired - The board. Pick it, or type its ID from its address in Kissflow.
Outputs
board_idtext- The board's ID
countnumber- How many
fieldslist- The items' fields
Example output
{
"board_id": "IT_helpdesk",
"count": 1,
"fields": [
{
"id": "Category",
"name": "Category",
"required": true,
"system": false,
"type": "Text"
}
]
}List board items
List a board's items, a page at a time.
Inputs
- Board
boardtextRequired - The board. Pick it, or type its ID from its address in Kissflow.
- How many
limitnumber - The most to list. Defaults to 25.From 1 to 100.
- Page
pagenumber - Which page to list, from 1. Defaults to the first.At least 1.
Outputs
board_idtext- The board's ID
countnumber- How many are on this page
has_moretrue/false- True when the page was full, so the next page may have more
itemslist- The items on this page
pagenumber- The page number
Example output
{
"board_id": "IT_helpdesk",
"count": 1,
"has_more": false,
"items": [
{
"assigned_to": "Grace Hopper",
"assigned_to_id": "Us7Jbc9XkQ2a",
"board_id": "IT_helpdesk",
"category": "InProgress",
"created_at": "2026-11-05T09:00:00+00:00",
"created_by": "Ada Lovelace",
"fields": {
"Category": "Hardware"
},
"id": "Pk9BcD3eF4gH",
"item_number": "TKT-12",
"modified_at": "2026-11-05T09:30:00+00:00",
"priority": "High",
"requester": "Ada Lovelace",
"requester_id": "Us1aB2cD3eF4",
"status": "In progress",
"status_id": "In_progress_A01",
"title": "Printer on floor 2 is jammed"
}
],
"page": 1
}List dataset rows
List a dataset's rows, a page at a time, or find rows by words in them. Also lists the dataset's columns.
Inputs
- Dataset
datasettextRequired - The dataset. Pick it, or type its ID from its address in Kissflow.
- Search
searchtext - Only rows with these words in them.
- How many
limitnumber - The most to list. Defaults to 25.From 1 to 50.
- Page
pagenumber - Which page to list, from 1. Defaults to the first.At least 1.
Outputs
columnslist- The dataset's columns
countnumber- How many are on this page
dataset_idtext- The dataset's ID
has_moretrue/false- True when the page was full, so the next page may have more
pagenumber- The page number
rowslist- The rows on this page
Example output
{
"columns": [
{
"id": "Department",
"name": "Department",
"required": false,
"system": false,
"type": "Text"
}
],
"count": 1,
"dataset_id": "Cost_centres",
"has_more": false,
"page": 1,
"rows": [
{
"dataset_id": "Cost_centres",
"fields": {
"Budget_owner": "Grace Hopper",
"Department": "Finance"
},
"id": "Pk9DeF5gH6iJ",
"key": "CC-104"
}
]
}List flows
List the account's processes, boards or datasets, with the IDs other steps take.
Inputs
- Flows
flow_typetextRequired - Which flows to list: processes, boards or datasets.One of:
process(Processes),board(Boards),dataset(Datasets).
Outputs
countnumber- How many
flow_typetext- process, board or dataset
flowslist- The flows found, by name
Example output
{
"count": 1,
"flow_type": "process",
"flows": [
{
"description": "Ask for something to be bought.",
"id": "Purchase_request",
"name": "Purchase request",
"status": "Live",
"type": "Process"
}
]
}List my process items
List the items of a process you, the access key's user, started or took part in.
Inputs
- Process
processtextRequired - The process. Pick it, or type its ID from its address in Kissflow, such as Purchase_request.
- How many
limitnumber - The most to list. Defaults to 25.From 1 to 100.
- Page
pagenumber - Which page to list, from 1. Defaults to the first.At least 1.
Outputs
countnumber- How many are on this page
has_moretrue/false- True when the page was full, so the next page may have more
itemslist- The items on this page
pagenumber- The page number
process_idtext- The process's ID
Example output
{
"count": 1,
"has_more": false,
"items": [
{
"assigned_to": [
"Grace Hopper"
],
"assigned_to_ids": [
"Us7Jbc9XkQ2a"
],
"created_at": "2026-11-05T09:00:00+00:00",
"created_by": "Ada Lovelace",
"current_step": "Manager approval",
"fields": {
"Amount": 1200,
"Reason": "New starter"
},
"id": "Pk9ALV9QVo5L",
"modified_at": "2026-11-05T09:30:00+00:00",
"name": "Laptop for Ada",
"process_id": "Purchase_request",
"progress": 50,
"status": "InProgress",
"step_id": "Pk9ALV9RNK_A"
}
],
"page": 1,
"process_id": "Purchase_request"
}List my tasks
List the items of a process waiting for you, the access key's user, to act on, with the step each is at.
Inputs
- Process
processtextRequired - The process. Pick it, or type its ID from its address in Kissflow, such as Purchase_request.
- How many
limitnumber - The most to list. Defaults to 25.From 1 to 100.
- Page
pagenumber - Which page to list, from 1. Defaults to the first.At least 1.
Outputs
countnumber- How many are on this page
has_moretrue/false- True when the page was full, so the next page may have more
itemslist- The items on this page
pagenumber- The page number
process_idtext- The process's ID
Example output
{
"count": 1,
"has_more": false,
"items": [
{
"assigned_to": [
"Grace Hopper"
],
"assigned_to_ids": [
"Us7Jbc9XkQ2a"
],
"created_at": "2026-11-05T09:00:00+00:00",
"created_by": "Ada Lovelace",
"current_step": "Manager approval",
"fields": {
"Amount": 1200,
"Reason": "New starter"
},
"id": "Pk9ALV9QVo5L",
"modified_at": "2026-11-05T09:30:00+00:00",
"name": "Laptop for Ada",
"process_id": "Purchase_request",
"progress": 50,
"status": "InProgress",
"step_id": "Pk9ALV9RNK_A"
}
],
"page": 1,
"process_id": "Purchase_request"
}List process fields
List the fields of a process's form, with the IDs steps fill them in by.
Inputs
- Process
processtextRequired - The process. Pick it, or type its ID from its address in Kissflow, such as Purchase_request.
Outputs
countnumber- How many
fieldslist- The form's fields
process_idtext- The process's ID
Example output
{
"count": 1,
"fields": [
{
"id": "Amount",
"name": "Amount",
"required": true,
"system": false,
"type": "Currency"
}
],
"process_id": "Purchase_request"
}List process items
List every item of a process, a page at a time. The access key's user must be a Process Admin of the process.
Inputs
- Process
processtextRequired - The process. Pick it, or type its ID from its address in Kissflow, such as Purchase_request.
- How many
limitnumber - The most to list. Defaults to 25.From 1 to 100.
- Page
pagenumber - Which page to list, from 1. Defaults to the first.At least 1.
Outputs
countnumber- How many are on this page
has_moretrue/false- True when the page was full, so the next page may have more
itemslist- The items on this page
pagenumber- The page number
process_idtext- The process's ID
Example output
{
"count": 1,
"has_more": false,
"items": [
{
"assigned_to": [
"Grace Hopper"
],
"assigned_to_ids": [
"Us7Jbc9XkQ2a"
],
"created_at": "2026-11-05T09:00:00+00:00",
"created_by": "Ada Lovelace",
"current_step": "Manager approval",
"fields": {
"Amount": 1200,
"Reason": "New starter"
},
"id": "Pk9ALV9QVo5L",
"modified_at": "2026-11-05T09:30:00+00:00",
"name": "Laptop for Ada",
"process_id": "Purchase_request",
"progress": 50,
"status": "InProgress",
"step_id": "Pk9ALV9RNK_A"
}
],
"page": 1,
"process_id": "Purchase_request"
}List users
List the account's users, a page at a time, or find them by name.
Inputs
- Search
searchtext - Only users whose name has these words.
- How many
limitnumber - The most to list. Defaults to 25.From 1 to 100.
- Page
pagenumber - Which page to list, from 1. Defaults to the first.At least 1.
Outputs
countnumber- How many are on this page
has_moretrue/false- True when the page was full, so the next page may have more
pagenumber- The page number
userslist- The users on this page
Example output
{
"count": 1,
"has_more": false,
"page": 1,
"users": [
{
"first_name": "Grace",
"id": "Us7Jbc9XkQ2a",
"last_name": "Hopper",
"name": "Grace Hopper",
"phone": "+1 415 555 0134",
"status": "Active",
"user_type": "User"
}
]
}Move board item
Move a board item to another status, such as Done.
Inputs
- Board
boardtextRequired - The board. Pick it, or type its ID from its address in Kissflow.
- Item
itemtextRequired - The item's ID, from another Kissflow step or the trigger.
- Status
statustextRequired - The status to move it to.
Outputs
assigned_totext- Who it is assigned to
assigned_to_idtext- Their user ID
board_idtext- The board's ID
categorytext- The kind of status, such as InProgress or Completed
created_attext- When it was added (ISO 8601)
created_bytext- Who added it
fieldsobject- The values of the fields its form has, by field ID
idtext- The item's ID
item_numbertext- Its number on the board, such as TKT-12
modified_attext- When it last changed (ISO 8601)
prioritytext- Its priority
requestertext- Who asked for it
requester_idtext- Their user ID
statustext- The status it is in, such as In progress
status_idtext- That status's ID
titletext- Its title
Example output
{
"assigned_to": "Grace Hopper",
"assigned_to_id": "Us7Jbc9XkQ2a",
"board_id": "IT_helpdesk",
"category": "InProgress",
"created_at": "2026-11-05T09:00:00+00:00",
"created_by": "Ada Lovelace",
"fields": {
"Category": "Hardware"
},
"id": "Pk9BcD3eF4gH",
"item_number": "TKT-12",
"modified_at": "2026-11-05T09:30:00+00:00",
"priority": "High",
"requester": "Ada Lovelace",
"requester_id": "Us1aB2cD3eF4",
"status": "In progress",
"status_id": "In_progress_A01",
"title": "Printer on floor 2 is jammed"
}Reject task
Reject a process item at your step, with a note saying why. It ends the item's way through the process.
Inputs
- Process
processtextRequired - The process. Pick it, or type its ID from its address in Kissflow, such as Purchase_request.
- Item
itemtextRequired - The item's ID, from another Kissflow step or the trigger, or a link to it opened in Kissflow.
- Step ID
steptext - The ID of the step the item is at, from the trigger or 'List my tasks'. Leave blank to find it among your tasks, or when the item's link has it.
- Note
notetextRequired - Why it is rejected.
Outputs
idtext- The item's ID
messagetext- What Kissflow said
process_idtext- The process's ID
rejectedtrue/false- True once it is rejected
step_idtext- The ID of the step it was at
Example output
{
"id": "Pk9ALV9QVo5L",
"message": "Rejected successfully",
"process_id": "Purchase_request",
"rejected": true,
"step_id": "Pk9ALV9RNK_A"
}Send back task
Send a process item back from your step to an earlier one, with a note saying what to change.
Inputs
- Process
processtextRequired - The process. Pick it, or type its ID from its address in Kissflow, such as Purchase_request.
- Item
itemtextRequired - The item's ID, from another Kissflow step or the trigger, or a link to it opened in Kissflow.
- Step ID
steptext - The ID of the step the item is at, from the trigger or 'List my tasks'. Leave blank to find it among your tasks, or when the item's link has it.
- Note
notetextRequired - What needs changing.
- Send back to
to_steptext - The name of the earlier step, such as Initiator. Leave blank when there is only one it can go back to.
Outputs
idtext- The item's ID
messagetext- What Kissflow said
process_idtext- The process's ID
sent_back_totext- The step it went back to
step_idtext- The ID of the step it was at
Example output
{
"id": "Pk9ALV9QVo5L",
"message": "Sent back successfully",
"process_id": "Purchase_request",
"sent_back_to": "Initiator",
"step_id": "Pk9ALV9RNK_A"
}Update board item
Change a board item's title, assignee, due date or fields. Fields left blank keep what they have.
Inputs
- Board
boardtextRequired - The board. Pick it, or type its ID from its address in Kissflow.
- Item
itemtextRequired - The item's ID, from another Kissflow step or the trigger.
- Title
titletext - A new title. Leave blank to keep it.
- Assigned to
assigned_totext - Who works on it now.
- Due
duedate and time - When it is due.
- Fields
fieldsobject - Values for the board's own fields. Fill in only what you need. For a person or a linked record, give its ID as {"_id": "..."}.
Outputs
assigned_totext- Who it is assigned to
assigned_to_idtext- Their user ID
board_idtext- The board's ID
categorytext- The kind of status, such as InProgress or Completed
created_attext- When it was added (ISO 8601)
created_bytext- Who added it
fieldsobject- The values of the fields its form has, by field ID
idtext- The item's ID
item_numbertext- Its number on the board, such as TKT-12
modified_attext- When it last changed (ISO 8601)
prioritytext- Its priority
requestertext- Who asked for it
requester_idtext- Their user ID
statustext- The status it is in, such as In progress
status_idtext- That status's ID
titletext- Its title
Example output
{
"assigned_to": "Grace Hopper",
"assigned_to_id": "Us7Jbc9XkQ2a",
"board_id": "IT_helpdesk",
"category": "InProgress",
"created_at": "2026-11-05T09:00:00+00:00",
"created_by": "Ada Lovelace",
"fields": {
"Category": "Hardware"
},
"id": "Pk9BcD3eF4gH",
"item_number": "TKT-12",
"modified_at": "2026-11-05T09:30:00+00:00",
"priority": "High",
"requester": "Ada Lovelace",
"requester_id": "Us1aB2cD3eF4",
"status": "In progress",
"status_id": "In_progress_A01",
"title": "Printer on floor 2 is jammed"
}Update dataset row
Change the columns of the dataset row with this key. Columns left blank keep what they have.
Inputs
- Dataset
datasettextRequired - The dataset. Pick it, or type its ID from its address in Kissflow.
- Key
keytextRequired - The row's value in the dataset's Name column, which no other row has.
- Fields
fieldsobject - Values for the dataset's columns. Fill in only what you need.
Outputs
dataset_idtext- The dataset's ID
fieldsobject- Its other columns' values, by column ID
idtext- The row's ID; empty when Kissflow doesn't say
keytext- Its value in the Name column, which no other row has
Example output
{
"dataset_id": "Cost_centres",
"fields": {
"Budget_owner": "Grace Hopper",
"Department": "Finance"
},
"id": "Pk9DeF5gH6iJ",
"key": "CC-104"
}Update process item
Change a process item's fields wherever it is in the process, without moving it on. The access key's user must be a Process Admin of the process.
Inputs
- Process
processtextRequired - The process. Pick it, or type its ID from its address in Kissflow, such as Purchase_request.
- Item
itemtextRequired - The item's ID, from another Kissflow step or the trigger, or a link to it opened in Kissflow.
- Fields
fieldsobject - Values for the process's form fields. Fill in only what you need. For a person or a linked record, give its ID as {"_id": "..."}.
Outputs
assigned_tolist- Who it is waiting for at that step
assigned_to_idslist- Their user IDs
created_attext- When it was started (ISO 8601)
created_bytext- Who started it
current_steptext- The step it is at
fieldsobject- The values of the fields its form has, by field ID
idtext- The item's ID
modified_attext- When it last changed (ISO 8601)
nametext- Its title
process_idtext- The process's ID
progressnumber- How far through the process it is, in percent
statustext- Draft, InProgress, Completed, Rejected or Withdrawn
step_idtext- The ID of the step it is at, when Kissflow gives it
Example output
{
"assigned_to": [
"Grace Hopper"
],
"assigned_to_ids": [
"Us7Jbc9XkQ2a"
],
"created_at": "2026-11-05T09:00:00+00:00",
"created_by": "Ada Lovelace",
"current_step": "Manager approval",
"fields": {
"Amount": 1200,
"Reason": "New starter"
},
"id": "Pk9ALV9QVo5L",
"modified_at": "2026-11-05T09:30:00+00:00",
"name": "Laptop for Ada",
"process_id": "Purchase_request",
"progress": 50,
"status": "InProgress",
"step_id": "Pk9ALV9RNK_A"
}