Skip to content
Docs

Remove a connection

DELETE
/api/workspaces/{ws}/connections/{id}

Hires using it lose access.

Authorization

session
cookiebetter-auth.session_token<token>

Set by POST /api/auth/sign-in/email.

Path Parameters

ws*string

The workspace id (from GET /api/me).

id*string

The id of what the path names: a hire, a connection, a skill, a shared file, a department, a position, a goal or an approval.

Response Body

Done; no body.

Example Request
curl -X DELETE 'https://app.useroster.work/api/workspaces/string/connections/string'
Example Response
Empty

Change a connection PATCH

Rename it, or replace some of its values. Secrets you leave out stay as they are. A new key is checked with the tool before it replaces the old one, as when connecting; a key that works clears `needs_reconnect`.

Check a connection again POST

Asks the tool who the connection's credential belongs to. Keeps `account` when it works; sets `status: "needs_reconnect"` and `statusDetail` when the tool refuses it. Connections also become `needs_reconnect` on their own when a tool refuses them while a hire works.