---
title: "List Functions"
method: GET
path: "/functions"
tags: ["functions"]
---

# List Functions

`GET /functions`

## Query parameters

- `page` integer — Page number
- `page_size` integer — Number of items per page
- `only_active` boolean — Whether to only return active sessions
- `only_current_token` boolean — Whether to only return sessions for the current token (apikey)
- `include_system` boolean — Whether to include internal system sessions

## Headers

- `x-notte-request-origin` string, nullable
- `x-notte-sdk-version` string, nullable

## Response `200`

Successful Response

- PaginatedResponseFunctionListItemResponse
  - `items` FunctionListItemResponse[], required
    - `function_id` string, required — The ID of the function
    - `variables` ParameterInfo[], nullable — The variables to run the workflow with
      - `name` string, required
      - `type` string, nullable
      - `default` string, nullable
    - `created_at` string, date-time, required — The creation time of the workflow
    - `updated_at` string, date-time, required — The last update time of the workflow
    - `latest_version` string, required — The version of the workflow
    - `versions` string[], required — The versions of the workflow
    - `status` string, required — The status of the workflow
    - `name` string, nullable — The name of the workflow
    - `description` string, nullable — The description of the workflow
    - `shared` boolean — Whether the workflow is public and can beshared with other users
    - `reference_workflow_id` string, nullable — The ID of the reference workflow (i.e wether the workflow was forked from another workflow or not)
    - `published` boolean
    - `required_secrets` string[]
    - `source` string, nullable — Where the function was created from, stamped at creation. Read-only.
    - `self_healing` boolean — Whether the build is finished and the function may be healed automatically. Can only be enabled on a function that has a thread for self-heal to resume.
    - `workflow_id` string, required
  - `page` integer, required
  - `page_size` integer, required
  - `has_next` boolean, required
  - `has_previous` boolean, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-28** `8be811b42f48` — 2 info
  - added the optional property `items/items/self_healing` to the response with the `200` status
  - added the optional property `items/items/source` to the response with the `200` status
- **2026-08-06** `8dda4e3d49cc` — 1 info
  - added the new optional `query` request parameter `include_system`
- **2026-07-31** `b1d81309d362` — 2 info
  - added the optional property `items/items/published` to the response with the `200` status
  - added the optional property `items/items/required_secrets` to the response with the `200` status

[Change history](https://skmtc.dev/notte/apis/notte-api/changes/functions/get.md)

---

[API](https://skmtc.dev/notte/apis/notte-api.md) · [All operations](https://skmtc.dev/notte/apis/notte-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/notte/notte-api/revisions/8be811b42f48/schema)