Connections

Returns the static OAuth 2.0 preset catalog shipped in this Perstack version. The catalog is deployment-level only — it carries no organization-specific state. Callers join this against GET /api/v1/organizations/{organizationIdOrSlug}/integrations to derive the registered / verified status per preset for their organization. Keeping the catalog pure means client-side caches of integration state stay coherent with a single invalidation key.

Static-token providers are not modeled as presets — they live as organization-scoped canonical variables, exposed via /api/v1/organizations/{organizationIdOrSlug}/variables.

Returns one deployment-level OAuth 2.0 preset from the static configuration catalog. A preset is configuration guidance, not a credential or organization Connection; no secret, token, provider locator, or organization-specific registration is returned.

List metadata-only Connections owned by the given Project Environment. The response is cursor-paginated; pass pagination.nextCursor unchanged to read the next page. Credential material and provider-specific OAuth identity remain internal.

Returns 404 if the Project does not exist in the caller's organization.

Creates a metadata-only Connection in the resolved Project Environment. An optional provider credential ID and version reference an existing credential version and are never returned; an optional Agent binding records the exact Connection version. Unknown or foreign coordinates return 404 and malformed binding input returns 422.

Fetch a Connection's metadata and current immutable version reference. Credential values are never returned; they are used only to perform the configured integration action.

Updates safe Connection metadata or creates a new immutable Connection version referencing an existing provider credential version. Existing Connection versions remain available to already-pinned internal OAuth state; credential material is never returned. Invalid version or binding combinations return 422.

Deletes the Connection from the resolved Project Environment. Existing retained audit or pinned execution records are not rewritten; a Connection retained by an immutable configuration snapshot returns 409, and a foreign or unknown Connection returns 404.

Reads metadata-only health for the active Deployment's declared Environment connection bindings, including missing configured bindings. Requires connections:list; it is not an execution-readiness guarantee and does not refresh tokens or contact providers.