---
title: "Test Saved Key"
method: POST
path: "/workflows/v1/upgrade-checklist/saved-keys/test"
tags: ["Upgrade Checklist"]
---

# Test Saved Key

`POST /workflows/v1/upgrade-checklist/saved-keys/test`

## Request

- Base URL: `https://api-qa.interactly.ai`
- URL: `https://api-qa.interactly.ai/workflows/v1/upgrade-checklist/saved-keys/test`
- Auth: HTTP bearer

Test one team's saved key for one provider, record the result for the stage, and return it.

One key per request, so each stays within the 60-second limit of a test call and the dashboard can show
progress as it goes.

## Request body

- SavedKeyTestRequest
  - `team_id` string, required
  - `provider` string, required
  - `stage` 'before' | 'after', required
  - `api_version` string, nullable: The API version the dashboard sees right now
  - `checklist_id` string, nullable: The upgrade this write belongs to, as the dashboard last read it; the current one if absent

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-28** `5793b8de56f0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/interactly/apis/interactly-api-3/changes/workflows/v1/upgrade-checklist/saved-keys/test/post.md)

---

[API](https://skmtc.dev/interactly/apis/interactly-api-3.md) - [All operations](https://skmtc.dev/interactly/apis/interactly-api-3/llms.txt) - [OpenAPI document](https://skmtc.dev/interactly/apis/interactly-api-3/revisions/919b415ec222?raw)