---
title: Connections
---

# Connections

Connections are stored OAuth credentials. The endpoints here let you list, create (which kicks off an OAuth flow), inspect, and revoke connections. Tokens are never returned through the API — connections are referenced by name in action calls.

::: warning Pre-release
:::

## `GET /v1/connections`

## `POST /v1/connections`

## `GET /v1/connections/{id}`

## `POST /v1/connections/{id}/refresh`

## `DELETE /v1/connections/{id}`

## Error codes

<!-- TODO: see FOLLOW_UPS.md -->