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

ActionWhat it does
Approve or submit taskFinish your step on a process item: approve it at an approval step, or submit it at any other step, a draft included.
Create board itemAdd an item to a board, with its title, assignee, requester, due date, status and the board's own fields.
Create dataset rowAdd a row to a dataset, with a key no other row has and its other columns' values.
Create process itemStart a new item (a request) in a process with the fields you give, and submit it to the process's first step.
Delete board itemDelete an item from a board for good.
Delete dataset rowDelete the dataset row with this key for good.
Delete process itemDelete an item from a process for good.
Get board itemGet a board item's title, status, assignee and fields.
Get dataset rowGet the dataset row with this key.
Get process itemGet a process item's fields, status and the step it is at.
List board fieldsList the fields of a board's items, with the IDs steps fill them in by.
List board itemsList a board's items, a page at a time.
List dataset rowsList a dataset's rows, a page at a time, or find rows by words in them.
List flowsList the account's processes, boards or datasets, with the IDs other steps take.
List my process itemsList the items of a process you, the access key's user, started or took part in.
List my tasksList the items of a process waiting for you, the access key's user, to act on, with the step each is at.
List process fieldsList the fields of a process's form, with the IDs steps fill them in by.
List process itemsList every item of a process, a page at a time.
List usersList the account's users, a page at a time, or find them by name.
Move board itemMove a board item to another status, such as Done.
Reject taskReject a process item at your step, with a note saying why.
Send back taskSend a process item back from your step to an earlier one, with a note saying what to change.
Update board itemChange a board item's title, assignee, due date or fields.
Update dataset rowChange the columns of the dataset row with this key.
Update process itemChange 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

ProcessprocesstextRequired
The process. Pick it, or type its ID from its address in Kissflow, such as Purchase_request.
ItemitemtextRequired
The item's ID, from another Kissflow step or the trigger, or a link to it opened in Kissflow.
Step IDsteptext
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.
Fieldsfieldsobject
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

BoardboardtextRequired
The board. Pick it, or type its ID from its address in Kissflow.
TitletitletextRequired
What the item is about.
Assigned toassigned_totext
Who works on it.
Requesterrequestertext
Who asked for it.
Dueduedate and time
When it is due.
Statusstatustext
The status it starts in. Leave blank for the board's first.
Fieldsfieldsobject
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

DatasetdatasettextRequired
The dataset. Pick it, or type its ID from its address in Kissflow.
KeykeytextRequired
The row's value in the dataset's Name column, which no other row has.
Fieldsfieldsobject
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

ProcessprocesstextRequired
The process. Pick it, or type its ID from its address in Kissflow, such as Purchase_request.
Fieldsfieldsobject
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 itsubmittrue/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

BoardboardtextRequired
The board. Pick it, or type its ID from its address in Kissflow.
ItemitemtextRequired
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

DatasetdatasettextRequired
The dataset. Pick it, or type its ID from its address in Kissflow.
KeykeytextRequired
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

ProcessprocesstextRequired
The process. Pick it, or type its ID from its address in Kissflow, such as Purchase_request.
ItemitemtextRequired
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

BoardboardtextRequired
The board. Pick it, or type its ID from its address in Kissflow.
ItemitemtextRequired
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

DatasetdatasettextRequired
The dataset. Pick it, or type its ID from its address in Kissflow.
KeykeytextRequired
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

ProcessprocesstextRequired
The process. Pick it, or type its ID from its address in Kissflow, such as Purchase_request.
ItemitemtextRequired
The item's ID, from another Kissflow step or the trigger, or a link to it opened in Kissflow.
Step IDsteptext
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

BoardboardtextRequired
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

BoardboardtextRequired
The board. Pick it, or type its ID from its address in Kissflow.
How manylimitnumber
The most to list. Defaults to 25.From 1 to 100.
Pagepagenumber
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

DatasetdatasettextRequired
The dataset. Pick it, or type its ID from its address in Kissflow.
Searchsearchtext
Only rows with these words in them.
How manylimitnumber
The most to list. Defaults to 25.From 1 to 50.
Pagepagenumber
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

Flowsflow_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

ProcessprocesstextRequired
The process. Pick it, or type its ID from its address in Kissflow, such as Purchase_request.
How manylimitnumber
The most to list. Defaults to 25.From 1 to 100.
Pagepagenumber
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

ProcessprocesstextRequired
The process. Pick it, or type its ID from its address in Kissflow, such as Purchase_request.
How manylimitnumber
The most to list. Defaults to 25.From 1 to 100.
Pagepagenumber
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

ProcessprocesstextRequired
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

ProcessprocesstextRequired
The process. Pick it, or type its ID from its address in Kissflow, such as Purchase_request.
How manylimitnumber
The most to list. Defaults to 25.From 1 to 100.
Pagepagenumber
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

Searchsearchtext
Only users whose name has these words.
How manylimitnumber
The most to list. Defaults to 25.From 1 to 100.
Pagepagenumber
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

BoardboardtextRequired
The board. Pick it, or type its ID from its address in Kissflow.
ItemitemtextRequired
The item's ID, from another Kissflow step or the trigger.
StatusstatustextRequired
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

ProcessprocesstextRequired
The process. Pick it, or type its ID from its address in Kissflow, such as Purchase_request.
ItemitemtextRequired
The item's ID, from another Kissflow step or the trigger, or a link to it opened in Kissflow.
Step IDsteptext
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.
NotenotetextRequired
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

ProcessprocesstextRequired
The process. Pick it, or type its ID from its address in Kissflow, such as Purchase_request.
ItemitemtextRequired
The item's ID, from another Kissflow step or the trigger, or a link to it opened in Kissflow.
Step IDsteptext
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.
NotenotetextRequired
What needs changing.
Send back toto_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

BoardboardtextRequired
The board. Pick it, or type its ID from its address in Kissflow.
ItemitemtextRequired
The item's ID, from another Kissflow step or the trigger.
Titletitletext
A new title. Leave blank to keep it.
Assigned toassigned_totext
Who works on it now.
Dueduedate and time
When it is due.
Fieldsfieldsobject
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

DatasetdatasettextRequired
The dataset. Pick it, or type its ID from its address in Kissflow.
KeykeytextRequired
The row's value in the dataset's Name column, which no other row has.
Fieldsfieldsobject
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

ProcessprocesstextRequired
The process. Pick it, or type its ID from its address in Kissflow, such as Purchase_request.
ItemitemtextRequired
The item's ID, from another Kissflow step or the trigger, or a link to it opened in Kissflow.
Fieldsfieldsobject
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"
}

On this page