Skip to content
Docs

A hire's GitHub identity

GET
/api/workspaces/{ws}/github/{connection}/hires/{hire}

{ set: false }, or the app: its login (e.g. builder-acme[bot]), whether it's installed, how many repositories it reaches, and links to manage it on GitHub.

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.

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

Hires' GitHub identities GET

Every hire in the workspace with a GitHub App of its own.

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.