Skip to content
Rolodex
Menu

Use cases

Use cases

Illustrative examples of everyday lookups. They describe how the features combine, not any real customer, and every name in them is made up.

Who is this account?

A log line shows an account name. One lookup returns the directory user behind it, or tells you it is a directory service account.

Typical lookups

  • GET /api/ldap-sync-cache/user/jdoe
  • Title and manager
  • Service-account flag

Give a group access to its repos

Bind a directory group to a GitHub team, preview the grants, then confirm. New members get access on the next access run.

Typical lookups

  • POST /api/access/bindings
  • Preview, then confirm
  • access.reconciled event

Put the right keys on a host

A provisioning script fetches the SSH keys of everyone in a group and writes them to a host.

Typical lookups

  • GET /keys/platform-admins
  • One key per member
  • Re-run after changes

Show a public team page

An admin publishes a group and its people. A public page searches them without credentials and never sees personal fields.

Typical lookups

  • PATCH /api/directory/groups/{id}/mode
  • GET /public/search?type=groups
  • group.public_changed event

Look up anyone in your directory

Sign in with your Fleetworks account, or start with the public surface, which needs no account.