Skip to content
Docs

Take a hire's GitHub identity away

DELETE
/api/workspaces/{ws}/github/{connection}/hires/{hire}/app

Roster forgets the app; delete it on GitHub too if nothing else uses it.

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).

connection*string

The connection's id (from GET /api/workspaces/:ws/connections).

hire*string

The hire's id.

Response Body

The identity's status afterwards.

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

Give a hire its own GitHub identity POST

Starts GitHub's app-manifest flow. Body: `{ owner: "organization", org: "acme" }` or `{ owner: "personal" }`. Answers with where to send the person: GitHub creates the app, then asks which repositories to install it on.

The install link GET

Where to install (or re-install) the hire's app on more repositories.