---
# @generated by sylphx-gen. Do not edit.
title: "Sylphx Broker: Connections"
description: "The `connections` collection of Sylphx Broker: A Connection is a third-party relationship: a provider installation, or Web Push assertion configuration backed by a generated Sylphx Keys key."
type: reference
product: platform
summary: "A Connection is a third-party relationship: a provider installation, or Web Push assertion configuration backed by a generated Sylphx Keys…"
updated: 2026-09-28
order: 900
nav: false
---

A Connection is a third-party relationship: a provider installation, or Web Push assertion configuration backed by a generated Sylphx Keys key. The Connections controller validates its configuration before it is Ready.

**Service** Sylphx Broker · **Resource type** `connections.sylphx.com/Connection` · **Name pattern** `orgs/{org}/connections/{connection}` · **Shape** `spec_status`

## Fields

| Field | Type | What it is |
| --- | --- | --- |
| `name` | `string` | `orgs/{org}/connections/{connection}`. |
| `uid` | `string` | `cnx_<cell><ulid>`. Output only. |
| `meta` | `ResourceMeta` | Resource metadata. |
| `spec` | `ConnectionSpec` | Desired state. Required. |
| `status` | `ConnectionStatus` | Observed state. Output only. |

## Methods

Every method of the collection, in the registry's order, with the scope it
needs. The full request, response and examples are one link away.

| Method | Call | What it does |
| --- | --- | --- |
| `POST` | [`sign_vapid_assertion`](/docs/api/broker/connections#sign-vapid-assertion) | Signs an RFC 8292 assertion using a committed same-org Web Push Connection. The stored contact supplies the subject; an ordinary caller must hold broker:exchange on this exact Connection and satisfy its TrustPolicy. |

## sign_vapid_assertion

Signs an RFC 8292 assertion using a committed same-org Web Push Connection. The stored contact supplies the subject; an ordinary caller must hold broker:exchange on this exact Connection and satisfy its TrustPolicy.

`POST https://api.sylphx.com/v1/orgs/acme/connections/connection:signVapidAssertion` · scope `broker:exchange` · effect `read` · [Request, response and examples](/docs/api/broker/connections/sign_vapid_assertion)