put
https://api.productboard.com/v2/plugin-integrations//connections/
Creates or replaces the connection state for a specific entity within a plugin integration. This is an upsert — if no connection exists it is created; if one exists it is replaced.
Connection states:
| State | Effect |
|---|---|
connected | Entity is linked; push button shows connection details |
error | Connection failed; push button shows error state |
progress | Processing asynchronously; push button shows loading indicator |
initial | Equivalent to deleting the connection; push button resets |
Async processing flow:
- User clicks push button → your endpoint receives an action notification
- Respond immediately with
state: progressto show a loading indicator - Process the action asynchronously
- Call this endpoint with the final state (
connectedorerror)