---
title: "Get Connection State"
method: GET
path: "/api/agent/connection-state"
tags: ["Agent Connections"]
---

# Get Connection State

`GET /api/agent/connection-state`

## Query parameters

- `provider_key` string, required

## Response `200`

Successful Response

- ConnectionStateResponse
  - `provider_key` string, required
  - `state` 'connected' | 'not_connected' | 'needs_reconnect' | 'not_available' | 'unknown', required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-26** `e1ba6d9dba94` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/every/apis/every-api/changes/api/agent/connection-state/get.md)

---

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