Users
For instructions on how to authenticate to use this endpoint, see API overview.
Endpoints
GET | |
GET | |
POST | |
DELETE | |
GET | |
PATCH | |
DELETE | |
GET | |
GET | |
PATCH | |
GET | |
DELETE | |
GET | |
POST | |
POST | |
GET |
List all users
Required API key scopes
user:readQuery parameters
- emailstring
- is_staffboolean
- limitinteger
- offsetinteger
Response
Example request
GET /api /usersExample response
Status 200
Retrieve users signal autonomy
Per-user signal autonomy config (singleton keyed by user).
GET /api/users/<id>/signal_autonomy/ → current config (or 404) POST /api/users/<id>/signal_autonomy/ → create or update DELETE /api/users/<id>/signal_autonomy/ → remove (opt out)
Required API key scopes
user:writePath parameters
- user_idstring
Response
Example request
GET /api /users /:user_id /signal_autonomyExample response
Status 200
Retrieve users signal autonomy
Per-user signal autonomy config (singleton keyed by user).
GET /api/users/<id>/signal_autonomy/ → current config (or 404) POST /api/users/<id>/signal_autonomy/ → create or update DELETE /api/users/<id>/signal_autonomy/ → remove (opt out)
Required API key scopes
user:writePath parameters
- user_idstring
Response
Example request
GET /api /users /:user_id /signal_autonomyExample response
Status 200
Create users signal autonomy
Per-user signal autonomy config (singleton keyed by user).
GET /api/users/<id>/signal_autonomy/ → current config (or 404) POST /api/users/<id>/signal_autonomy/ → create or update DELETE /api/users/<id>/signal_autonomy/ → remove (opt out)
Required API key scopes
user:writePath parameters
- user_idstring
Request parameters
- autostart_priority
Response
Example request
POST /api /users /:user_id /signal_autonomyExample response
Status 200
Create users signal autonomy
Per-user signal autonomy config (singleton keyed by user).
GET /api/users/<id>/signal_autonomy/ → current config (or 404) POST /api/users/<id>/signal_autonomy/ → create or update DELETE /api/users/<id>/signal_autonomy/ → remove (opt out)
Required API key scopes
user:writePath parameters
- user_idstring
Request parameters
- autostart_priority
Response
Example request
POST /api /users /:user_id /signal_autonomyExample response
Status 200
Delete users signal autonomy
Per-user signal autonomy config (singleton keyed by user).
GET /api/users/<id>/signal_autonomy/ → current config (or 404) POST /api/users/<id>/signal_autonomy/ → create or update DELETE /api/users/<id>/signal_autonomy/ → remove (opt out)
Required API key scopes
user:writePath parameters
- user_idstring
Example request
DELETE /api /users /:user_id /signal_autonomyExample response
Status 204 No response body
Delete users signal autonomy
Per-user signal autonomy config (singleton keyed by user).
GET /api/users/<id>/signal_autonomy/ → current config (or 404) POST /api/users/<id>/signal_autonomy/ → create or update DELETE /api/users/<id>/signal_autonomy/ → remove (opt out)
Required API key scopes
user:writePath parameters
- user_idstring
Example request
DELETE /api /users /:user_id /signal_autonomyExample response
Status 204 No response body
Retrieve users
Retrieve a user's profile and settings. Pass @me as the UUID to fetch the authenticated user; non-staff callers may only access their own account.
Required API key scopes
user:readPath parameters
- uuidstring
Response
Example request
GET /api /users /:uuidExample response
Status 200
Update users
Update one or more of the authenticated user's profile fields or settings.
Required API key scopes
user:writePath parameters
- uuidstring
Request parameters
- first_namestring
- last_namestring
- emailstring
- notification_settingsobject
- anonymize_databoolean
- allow_impersonationboolean
- toolbar_mode
- is_staffboolean
- set_current_organizationstring
- set_current_teamstring
- passwordstring
- current_passwordstring
- events_column_config
- has_seen_product_intro_for
- theme_mode
- hedgehog_config
- allow_sidebar_suggestionsboolean
- shortcut_position
- role_at_organization
- passkeys_enabled_for_2faboolean
Response
Example request
PATCH /api /users /:uuidExample response
Status 200
Delete users
Path parameters
- uuidstring
Example request
DELETE /api /users /:uuidExample response
Status 204 No response body
Retrieve users github login
Required API key scopes
user:readPath parameters
- uuidstring
Example request
GET /api /users /:uuid /github_loginExample response
Status 200 No response body
Retrieve users hedgehog config
Required API key scopes
user:readPath parameters
- uuidstring
Example request
GET /api /users /:uuid /hedgehog_configExample response
Status 200 No response body
Update users hedgehog config
Required API key scopes
user:writePath parameters
- uuidstring
Request parameters
- first_namestring
- last_namestring
- emailstring
- notification_settingsobject
- anonymize_databoolean
- allow_impersonationboolean
- toolbar_mode
- is_staffboolean
- set_current_organizationstring
- set_current_teamstring
- passwordstring
- current_passwordstring
- events_column_config
- has_seen_product_intro_for
- theme_mode
- hedgehog_config
- allow_sidebar_suggestionsboolean
- shortcut_position
- role_at_organization
- passkeys_enabled_for_2faboolean
Example request
PATCH /api /users /:uuid /hedgehog_configExample response
Status 200 No response body
List all users integrations
/api/users/@me/integrations/ — manage the user's personal GitHub integrations.
Required API key scopes
user:readPath parameters
- uuidstring
Query parameters
- limitinteger
- offsetinteger
Response
Example request
GET /api /users /:uuid /integrationsExample response
Status 200
Delete users integrations github
Remove a specific GitHub installation by its installation_id.
Required API key scopes
user:writePath parameters
- installation_idstring
- uuidstring
Example request
DELETE /api /users /:uuid /integrations /github /:installation_idExample response
Status 204 Integration removed.
Retrieve users integrations github repos
List repositories accessible to a specific GitHub installation (paginated, cached).
Required API key scopes
user:readPath parameters
- installation_idstring
- uuidstring
Query parameters
- limitintegerDefault:
100 - offsetintegerDefault:
0 - searchstringDefault:
Response
Example request
GET /api /users /:uuid /integrations /github /:installation_id /reposExample response
Status 200
Create users integrations github start
Start GitHub linking: either full App install or OAuth-only (user-to-server).
**_kwargs absorbs parent_lookup_uuid from the nested
/api/users/{uuid}/integrations/ router (same pattern as local_evaluation
under projects).
- If the current project has no team-level GitHub
Integration, returnsinstall_urlpointing at/installations/new(configure org + repos). - If the team already has a GitHub installation, returns
install_urlpointing at/login/oauth/authorizeso the user only authorizes as themselves for that installation (no repo scoping UI on GitHub).
In both cases the response key is install_url for compatibility with callers.
Required API key scopes
user:writePath parameters
- uuidstring
Request parameters
- team_idinteger
- connect_fromstring
Response
Example request
POST /api /users /:uuid /integrations /github /startExample response
Status 200
Create users scene personalisation
Path parameters
- uuidstring
Request parameters
- first_namestring
- last_namestring
- emailstring
- notification_settingsobject
- anonymize_databoolean
- allow_impersonationboolean
- toolbar_mode
- is_staffboolean
- set_current_organizationstring
- set_current_teamstring
- passwordstring
- current_passwordstring
- events_column_config
- has_seen_product_intro_for
- theme_mode
- hedgehog_config
- allow_sidebar_suggestionsboolean
- shortcut_position
- role_at_organization
- passkeys_enabled_for_2faboolean
Example request
POST /api /users /:uuid /scene_personalisationExample response
Status 200 No response body
Retrieve users start 2fa setup
Path parameters
- uuidstring
Example request
GET /api /users /:uuid /start_2fa_setup