# Kissflow

> 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.

App · 25 actions. Web page: https://docs.lodol.com/docs/integrations/kissflow

## Actions

### 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 (`process`, text, required): The process. Pick it, or type its ID from its address in Kissflow, such as Purchase_request.
- Item (`item`, text, required): The item's ID, from another Kissflow step or the trigger, or a link to it opened in Kissflow.
- Step ID (`step`, text): 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 (`fields`, object): 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**

- `id` (text): The item's ID
- `message` (text): What Kissflow said
- `process_id` (text): The process's ID
- `step_id` (text): The ID of the step it was at
- `submitted` (true/false): True once it is submitted

**Example output**

```json
{
  "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 (`board`, text, required): The board. Pick it, or type its ID from its address in Kissflow.
- Title (`title`, text, required): What the item is about.
- Assigned to (`assigned_to`, text): Who works on it.
- Requester (`requester`, text): Who asked for it.
- Due (`due`, date and time): When it is due.
- Status (`status`, text): The status it starts in. Leave blank for the board's first.
- Fields (`fields`, object): 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_to` (text): Who it is assigned to
- `assigned_to_id` (text): Their user ID
- `board_id` (text): The board's ID
- `category` (text): The kind of status, such as InProgress or Completed
- `created_at` (text): When it was added (ISO 8601)
- `created_by` (text): Who added it
- `fields` (object): The values of the fields its form has, by field ID
- `id` (text): The item's ID
- `item_number` (text): Its number on the board, such as TKT-12
- `modified_at` (text): When it last changed (ISO 8601)
- `priority` (text): Its priority
- `requester` (text): Who asked for it
- `requester_id` (text): Their user ID
- `status` (text): The status it is in, such as In progress
- `status_id` (text): That status's ID
- `title` (text): Its title

**Example output**

```json
{
  "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 (`dataset`, text, required): The dataset. Pick it, or type its ID from its address in Kissflow.
- Key (`key`, text, required): The row's value in the dataset's Name column, which no other row has.
- Fields (`fields`, object): Values for the dataset's columns. Fill in only what you need.

**Outputs**

- `dataset_id` (text): The dataset's ID
- `fields` (object): Its other columns' values, by column ID
- `id` (text): The row's ID; empty when Kissflow doesn't say
- `key` (text): Its value in the Name column, which no other row has

**Example output**

```json
{
  "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 (`process`, text, required): The process. Pick it, or type its ID from its address in Kissflow, such as Purchase_request.
- Fields (`fields`, object): 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 (`submit`, true/false): Submit it at once. Off keeps it as a draft. Default: `true`.

**Outputs**

- `draft_step_id` (text): The ID of the step it was made at. 'Approve or submit task' takes it to submit a draft later
- `id` (text): The new item's ID
- `process_id` (text): The process's ID
- `submitted` (true/false): True if it was submitted, false if it was kept as a draft

**Example output**

```json
{
  "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 (`board`, text, required): The board. Pick it, or type its ID from its address in Kissflow.
- Item (`item`, text, required): The item's ID, from another Kissflow step or the trigger.

**Outputs**

- `board_id` (text): The board's ID
- `deleted` (true/false): True once it is deleted
- `id` (text): The item's ID

**Example output**

```json
{
  "board_id": "IT_helpdesk",
  "deleted": true,
  "id": "Pk9BcD3eF4gH"
}
```

### Delete dataset row

Delete the dataset row with this key for good.

**Inputs**

- Dataset (`dataset`, text, required): The dataset. Pick it, or type its ID from its address in Kissflow.
- Key (`key`, text, required): The row's value in the dataset's Name column, which no other row has.

**Outputs**

- `dataset_id` (text): The dataset's ID
- `deleted` (true/false): True once it is deleted
- `key` (text): The row's key

**Example output**

```json
{
  "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 (`process`, text, required): The process. Pick it, or type its ID from its address in Kissflow, such as Purchase_request.
- Item (`item`, text, required): The item's ID, from another Kissflow step or the trigger, or a link to it opened in Kissflow.

**Outputs**

- `deleted` (true/false): True once it is deleted
- `id` (text): The item's ID
- `process_id` (text): The process's ID

**Example output**

```json
{
  "deleted": true,
  "id": "Pk9ALV9QVo5L",
  "process_id": "Purchase_request"
}
```

### Get board item

Get a board item's title, status, assignee and fields.

**Inputs**

- Board (`board`, text, required): The board. Pick it, or type its ID from its address in Kissflow.
- Item (`item`, text, required): The item's ID, from another Kissflow step or the trigger.

**Outputs**

- `assigned_to` (text): Who it is assigned to
- `assigned_to_id` (text): Their user ID
- `board_id` (text): The board's ID
- `category` (text): The kind of status, such as InProgress or Completed
- `created_at` (text): When it was added (ISO 8601)
- `created_by` (text): Who added it
- `fields` (object): The values of the fields its form has, by field ID
- `id` (text): The item's ID
- `item_number` (text): Its number on the board, such as TKT-12
- `modified_at` (text): When it last changed (ISO 8601)
- `priority` (text): Its priority
- `requester` (text): Who asked for it
- `requester_id` (text): Their user ID
- `status` (text): The status it is in, such as In progress
- `status_id` (text): That status's ID
- `title` (text): Its title

**Example output**

```json
{
  "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 (`dataset`, text, required): The dataset. Pick it, or type its ID from its address in Kissflow.
- Key (`key`, text, required): The row's value in the dataset's Name column, which no other row has.

**Outputs**

- `dataset_id` (text): The dataset's ID
- `fields` (object): Its other columns' values, by column ID
- `id` (text): The row's ID; empty when Kissflow doesn't say
- `key` (text): Its value in the Name column, which no other row has

**Example output**

```json
{
  "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 (`process`, text, required): The process. Pick it, or type its ID from its address in Kissflow, such as Purchase_request.
- Item (`item`, text, required): The item's ID, from another Kissflow step or the trigger, or a link to it opened in Kissflow.
- Step ID (`step`, text): 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_to` (list): Who it is waiting for at that step
- `assigned_to_ids` (list): Their user IDs
- `created_at` (text): When it was started (ISO 8601)
- `created_by` (text): Who started it
- `current_step` (text): The step it is at
- `fields` (object): The values of the fields its form has, by field ID
- `id` (text): The item's ID
- `modified_at` (text): When it last changed (ISO 8601)
- `name` (text): Its title
- `process_id` (text): The process's ID
- `progress` (number): How far through the process it is, in percent
- `status` (text): Draft, InProgress, Completed, Rejected or Withdrawn
- `step_id` (text): The ID of the step it is at, when Kissflow gives it

**Example output**

```json
{
  "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 (`board`, text, required): The board. Pick it, or type its ID from its address in Kissflow.

**Outputs**

- `board_id` (text): The board's ID
- `count` (number): How many
- `fields` (list): The items' fields

**Example output**

```json
{
  "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 (`board`, text, required): The board. Pick it, or type its ID from its address in Kissflow.
- How many (`limit`, number): The most to list. Defaults to 25. From 1 to 100.
- Page (`page`, number): Which page to list, from 1. Defaults to the first. At least 1.

**Outputs**

- `board_id` (text): The board's ID
- `count` (number): How many are on this page
- `has_more` (true/false): True when the page was full, so the next page may have more
- `items` (list): The items on this page
- `page` (number): The page number

**Example output**

```json
{
  "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 (`dataset`, text, required): The dataset. Pick it, or type its ID from its address in Kissflow.
- Search (`search`, text): Only rows with these words in them.
- How many (`limit`, number): The most to list. Defaults to 25. From 1 to 50.
- Page (`page`, number): Which page to list, from 1. Defaults to the first. At least 1.

**Outputs**

- `columns` (list): The dataset's columns
- `count` (number): How many are on this page
- `dataset_id` (text): The dataset's ID
- `has_more` (true/false): True when the page was full, so the next page may have more
- `page` (number): The page number
- `rows` (list): The rows on this page

**Example output**

```json
{
  "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_type`, text, required): Which flows to list: processes, boards or datasets. One of: `process` (Processes), `board` (Boards), `dataset` (Datasets).

**Outputs**

- `count` (number): How many
- `flow_type` (text): process, board or dataset
- `flows` (list): The flows found, by name

**Example output**

```json
{
  "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 (`process`, text, required): The process. Pick it, or type its ID from its address in Kissflow, such as Purchase_request.
- How many (`limit`, number): The most to list. Defaults to 25. From 1 to 100.
- Page (`page`, number): Which page to list, from 1. Defaults to the first. At least 1.

**Outputs**

- `count` (number): How many are on this page
- `has_more` (true/false): True when the page was full, so the next page may have more
- `items` (list): The items on this page
- `page` (number): The page number
- `process_id` (text): The process's ID

**Example output**

```json
{
  "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 (`process`, text, required): The process. Pick it, or type its ID from its address in Kissflow, such as Purchase_request.
- How many (`limit`, number): The most to list. Defaults to 25. From 1 to 100.
- Page (`page`, number): Which page to list, from 1. Defaults to the first. At least 1.

**Outputs**

- `count` (number): How many are on this page
- `has_more` (true/false): True when the page was full, so the next page may have more
- `items` (list): The items on this page
- `page` (number): The page number
- `process_id` (text): The process's ID

**Example output**

```json
{
  "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 (`process`, text, required): The process. Pick it, or type its ID from its address in Kissflow, such as Purchase_request.

**Outputs**

- `count` (number): How many
- `fields` (list): The form's fields
- `process_id` (text): The process's ID

**Example output**

```json
{
  "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 (`process`, text, required): The process. Pick it, or type its ID from its address in Kissflow, such as Purchase_request.
- How many (`limit`, number): The most to list. Defaults to 25. From 1 to 100.
- Page (`page`, number): Which page to list, from 1. Defaults to the first. At least 1.

**Outputs**

- `count` (number): How many are on this page
- `has_more` (true/false): True when the page was full, so the next page may have more
- `items` (list): The items on this page
- `page` (number): The page number
- `process_id` (text): The process's ID

**Example output**

```json
{
  "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 (`search`, text): Only users whose name has these words.
- How many (`limit`, number): The most to list. Defaults to 25. From 1 to 100.
- Page (`page`, number): Which page to list, from 1. Defaults to the first. At least 1.

**Outputs**

- `count` (number): How many are on this page
- `has_more` (true/false): True when the page was full, so the next page may have more
- `page` (number): The page number
- `users` (list): The users on this page

**Example output**

```json
{
  "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 (`board`, text, required): The board. Pick it, or type its ID from its address in Kissflow.
- Item (`item`, text, required): The item's ID, from another Kissflow step or the trigger.
- Status (`status`, text, required): The status to move it to.

**Outputs**

- `assigned_to` (text): Who it is assigned to
- `assigned_to_id` (text): Their user ID
- `board_id` (text): The board's ID
- `category` (text): The kind of status, such as InProgress or Completed
- `created_at` (text): When it was added (ISO 8601)
- `created_by` (text): Who added it
- `fields` (object): The values of the fields its form has, by field ID
- `id` (text): The item's ID
- `item_number` (text): Its number on the board, such as TKT-12
- `modified_at` (text): When it last changed (ISO 8601)
- `priority` (text): Its priority
- `requester` (text): Who asked for it
- `requester_id` (text): Their user ID
- `status` (text): The status it is in, such as In progress
- `status_id` (text): That status's ID
- `title` (text): Its title

**Example output**

```json
{
  "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 (`process`, text, required): The process. Pick it, or type its ID from its address in Kissflow, such as Purchase_request.
- Item (`item`, text, required): The item's ID, from another Kissflow step or the trigger, or a link to it opened in Kissflow.
- Step ID (`step`, text): 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 (`note`, text, required): Why it is rejected.

**Outputs**

- `id` (text): The item's ID
- `message` (text): What Kissflow said
- `process_id` (text): The process's ID
- `rejected` (true/false): True once it is rejected
- `step_id` (text): The ID of the step it was at

**Example output**

```json
{
  "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 (`process`, text, required): The process. Pick it, or type its ID from its address in Kissflow, such as Purchase_request.
- Item (`item`, text, required): The item's ID, from another Kissflow step or the trigger, or a link to it opened in Kissflow.
- Step ID (`step`, text): 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 (`note`, text, required): What needs changing.
- Send back to (`to_step`, text): The name of the earlier step, such as Initiator. Leave blank when there is only one it can go back to.

**Outputs**

- `id` (text): The item's ID
- `message` (text): What Kissflow said
- `process_id` (text): The process's ID
- `sent_back_to` (text): The step it went back to
- `step_id` (text): The ID of the step it was at

**Example output**

```json
{
  "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 (`board`, text, required): The board. Pick it, or type its ID from its address in Kissflow.
- Item (`item`, text, required): The item's ID, from another Kissflow step or the trigger.
- Title (`title`, text): A new title. Leave blank to keep it.
- Assigned to (`assigned_to`, text): Who works on it now.
- Due (`due`, date and time): When it is due.
- Fields (`fields`, object): 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_to` (text): Who it is assigned to
- `assigned_to_id` (text): Their user ID
- `board_id` (text): The board's ID
- `category` (text): The kind of status, such as InProgress or Completed
- `created_at` (text): When it was added (ISO 8601)
- `created_by` (text): Who added it
- `fields` (object): The values of the fields its form has, by field ID
- `id` (text): The item's ID
- `item_number` (text): Its number on the board, such as TKT-12
- `modified_at` (text): When it last changed (ISO 8601)
- `priority` (text): Its priority
- `requester` (text): Who asked for it
- `requester_id` (text): Their user ID
- `status` (text): The status it is in, such as In progress
- `status_id` (text): That status's ID
- `title` (text): Its title

**Example output**

```json
{
  "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 (`dataset`, text, required): The dataset. Pick it, or type its ID from its address in Kissflow.
- Key (`key`, text, required): The row's value in the dataset's Name column, which no other row has.
- Fields (`fields`, object): Values for the dataset's columns. Fill in only what you need.

**Outputs**

- `dataset_id` (text): The dataset's ID
- `fields` (object): Its other columns' values, by column ID
- `id` (text): The row's ID; empty when Kissflow doesn't say
- `key` (text): Its value in the Name column, which no other row has

**Example output**

```json
{
  "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 (`process`, text, required): The process. Pick it, or type its ID from its address in Kissflow, such as Purchase_request.
- Item (`item`, text, required): The item's ID, from another Kissflow step or the trigger, or a link to it opened in Kissflow.
- Fields (`fields`, object): 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_to` (list): Who it is waiting for at that step
- `assigned_to_ids` (list): Their user IDs
- `created_at` (text): When it was started (ISO 8601)
- `created_by` (text): Who started it
- `current_step` (text): The step it is at
- `fields` (object): The values of the fields its form has, by field ID
- `id` (text): The item's ID
- `modified_at` (text): When it last changed (ISO 8601)
- `name` (text): Its title
- `process_id` (text): The process's ID
- `progress` (number): How far through the process it is, in percent
- `status` (text): Draft, InProgress, Completed, Rejected or Withdrawn
- `step_id` (text): The ID of the step it is at, when Kissflow gives it

**Example output**

```json
{
  "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"
}
```
