---
title: "Get persistent tool state"
method: GET
path: "/tools/{toolId}/state"
tags: ["Tools"]
---

# Get persistent tool state

`GET /tools/{toolId}/state`

## Request

- Base URL: `https://api.superglue.cloud/v1`
- URL: `https://api.superglue.cloud/v1/tools/{toolId}/state`
- Auth: HTTP bearer

Returns the tool's persistent key-value state, exposed to runs as sourceData.persistedState. It is read at the start of each saved-tool run and written back after successful runs. State is unencrypted; never store credentials in it. Values matching known credentials of the tool's systems are masked in the response.

## Path parameters

- `toolId` string, required

## Response `200`

Current persistent state of the tool

- object
  - `toolId` string, required
  - `state` object, required: Values must be JSON-serializable and may contain up to 64 KB each. Writes are limited to 100 keys.

## Other responses

- `403`: Not authorized to read this tool
- `404`: Tool not found

---

[API](https://skmtc.dev/superglue/apis/superglue-api.md) - [All operations](https://skmtc.dev/superglue/apis/superglue-api/llms.txt) - [OpenAPI document](https://skmtc.dev/superglue/apis/superglue-api/revisions/2d412a94bf09?raw)