Galileo Technologies users API
The users API from Galileo Technologies — 29 operation(s) for users.
The users API from Galileo Technologies — 29 operation(s) for users.
openapi: 3.1.0
info:
title: Galileo API Server annotation users API
version: 1.1085.0
servers:
- url: https://api.galileo.ai
description: Galileo API Server - galileo-v2
tags:
- name: users
paths:
/user_roles:
get:
tags:
- users
summary: Get User Roles
description: Get all user roles.
operationId: get_user_roles_user_roles_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
items:
$ref: '#/components/schemas/UserRoleInfo'
type: array
title: Response Get User Roles User Roles Get
security:
- ClassicAPIKeyHeader: []
- APIKeyHeader: []
- OAuth2PasswordBearer: []
- HTTPBasic: []
/request_access:
post:
tags:
- users
summary: Request Access
description: 'Endpoint for a user to request access to the console.
This is often the first step for a user to sign up for the console. The user record is created with
`email_is_verified=None`, which signifies that the user has requested access but hasn''t been invited yet.'
operationId: request_access_request_access_post
parameters:
- name: user_email
in: query
required: true
schema:
type: string
format: email
title: User Email
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/signup_link:
post:
tags:
- users
summary: Generate Signup Link
description: 'Generate a signup link for a new user and send it via email.
This endpoint is used by admins in the console Command Center.
We create an unverified user entry and send a signup email to the new user.
When the show_invitation_link_and_reset_password feature flag is enabled,
the signup URL is also returned in the API response. Otherwise, it is
sent exclusively via email.
The user is then verified via one of the following endpoints:
- POST /users
- POST /users/social'
operationId: generate_signup_link_signup_link_post
security:
- ClassicAPIKeyHeader: []
- APIKeyHeader: []
- OAuth2PasswordBearer: []
- HTTPBasic: []
parameters:
- name: user_email
in: query
required: true
schema:
type: string
format: email
title: User Email
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/CreateSignupLinkResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/invite_users:
post:
tags:
- users
summary: Invite Users
operationId: invite_users_invite_users_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/InviteUsersRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- ClassicAPIKeyHeader: []
- APIKeyHeader: []
- OAuth2PasswordBearer: []
- HTTPBasic: []
/users:
post:
tags:
- users
summary: Create Or Verify User
description: 'Create a new system user with an email and password.
If no admin exists (first user), the user will be created as an admin.
Otherwise:
- User record was already created when the admin invited the user
- We should verify the user''s email'
operationId: create_or_verify_user_users_post
deprecated: true
parameters:
- name: signup_token
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Signup Token
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/UserCreate'
examples:
- email: user@example.com
first_name: Alice
last_name: Appleseed
auth_method: email
password: Th3secret_
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/SystemUserDB'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
get:
tags:
- users
summary: List Users
operationId: list_users_users_get
deprecated: true
security:
- ClassicAPIKeyHeader: []
- APIKeyHeader: []
- OAuth2PasswordBearer: []
- HTTPBasic: []
parameters:
- name: starting_token
in: query
required: false
schema:
type: integer
default: 0
title: Starting Token
- name: limit
in: query
required: false
schema:
type: integer
default: 100
title: Limit
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/GetUsersResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
delete:
tags:
- users
summary: Delete User Self
operationId: delete_user_self_users_delete
security:
- ClassicAPIKeyHeader: []
- APIKeyHeader: []
- OAuth2PasswordBearer: []
- HTTPBasic: []
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/DeleteUserResponse'
/system_users:
post:
tags:
- users
summary: Create Or Verify User
description: 'Create a new system user with an email and password.
If no admin exists (first user), the user will be created as an admin.
Otherwise:
- User record was already created when the admin invited the user
- We should verify the user''s email'
operationId: create_or_verify_user_system_users_post
parameters:
- name: signup_token
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Signup Token
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/UserCreate'
examples:
- email: user@example.com
first_name: Alice
last_name: Appleseed
auth_method: email
password: Th3secret_
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/SystemUserDB'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/users/social:
post:
tags:
- users
summary: Create Or Verify User Social
description: 'Create a user using a social login provider.
All social users are created with `email_is_verified=True`, don''t need to be invited and are by default read-only
(unless they are the first user, in which case they are set to admin).'
operationId: create_or_verify_user_social_users_social_post
deprecated: true
parameters:
- name: signup_token
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Signup Token
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/SocialLoginRequest'
examples:
- id_token: token1234
provider: google
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/SystemUserDB'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/system_users/social:
post:
tags:
- users
summary: Create Or Verify User Social
description: 'Create a user using a social login provider.
All social users are created with `email_is_verified=True`, don''t need to be invited and are by default read-only
(unless they are the first user, in which case they are set to admin).'
operationId: create_or_verify_user_social_system_users_social_post
parameters:
- name: signup_token
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Signup Token
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/SocialLoginRequest'
examples:
- id_token: token1234
provider: google
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/SystemUserDB'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/users/all:
post:
tags:
- users
summary: List Users Paginated
operationId: list_users_paginated_users_all_post
security:
- ClassicAPIKeyHeader: []
- APIKeyHeader: []
- OAuth2PasswordBearer: []
- HTTPBasic: []
parameters:
- name: starting_token
in: query
required: false
schema:
type: integer
default: 0
title: Starting Token
- name: limit
in: query
required: false
schema:
type: integer
default: 100
title: Limit
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/QueryUserParams'
default:
filters: []
sort:
name: created_at
ascending: false
sort_type: column
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/GetUsersResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
get:
tags:
- users
summary: List All Users
description: 'List all users in the system.
This endpoint is optimized to count project and runs for each user. This endpoint must be placed before
`/users/{user_id}` so that "all" is not interpreted as a UUID4.'
operationId: list_all_users_users_all_get
deprecated: true
security:
- ClassicAPIKeyHeader: []
- APIKeyHeader: []
- OAuth2PasswordBearer: []
- HTTPBasic: []
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/GetUserResponse'
title: Response List All Users Users All Get
/users/{user_id}:
get:
tags:
- users
summary: Get User
operationId: get_user_users__user_id__get
security:
- ClassicAPIKeyHeader: []
- APIKeyHeader: []
- OAuth2PasswordBearer: []
- HTTPBasic: []
parameters:
- name: user_id
in: path
required: true
schema:
type: string
format: uuid4
title: User Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/GetUserResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
put:
tags:
- users
summary: Update User
operationId: update_user_users__user_id__put
security:
- ClassicAPIKeyHeader: []
- APIKeyHeader: []
- OAuth2PasswordBearer: []
- HTTPBasic: []
parameters:
- name: user_id
in: path
required: true
schema:
type: string
format: uuid4
title: User Id
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/UserUpdate'
examples:
- first_name: Tony
last_name: Newname
email: bigtony@rungalileo.io
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateUserResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
delete:
tags:
- users
summary: Delete User
operationId: delete_user_users__user_id__delete
security:
- ClassicAPIKeyHeader: []
- APIKeyHeader: []
- OAuth2PasswordBearer: []
- HTTPBasic: []
parameters:
- name: user_id
in: path
required: true
schema:
type: string
format: uuid4
title: User Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/DeleteUserResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/users/{user_id}/runs/latest:
get:
tags:
- users
summary: Get Latest User Run
description: Gets the most recent run for a User, ordered by last updated.
operationId: get_latest_user_run_users__user_id__runs_latest_get
security:
- ClassicAPIKeyHeader: []
- APIKeyHeader: []
- OAuth2PasswordBearer: []
- HTTPBasic: []
parameters:
- name: user_id
in: path
required: true
schema:
type: string
format: uuid4
title: User Id
- name: project_type
in: query
required: false
schema:
$ref: '#/components/schemas/ProjectType'
default: gen_ai
- name: starting_token
in: query
required: false
schema:
type: integer
default: 0
title: Starting Token
- name: limit
in: query
required: false
schema:
type: integer
default: 100
title: Limit
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/GetUserLatestRunsDB'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/users/{user_id}/runs:
get:
tags:
- users
summary: Get Project Runs For User
description: 'Get all user created runs across all projects they can access.
This returns a filtered list of projects with only runs created by this user.'
operationId: get_project_runs_for_user_users__user_id__runs_get
security:
- ClassicAPIKeyHeader: []
- APIKeyHeader: []
- OAuth2PasswordBearer: []
- HTTPBasic: []
parameters:
- name: user_id
in: path
required: true
schema:
type: string
format: uuid4
title: User Id
- name: project_type
in: query
required: false
schema:
anyOf:
- $ref: '#/components/schemas/ProjectType'
- type: 'null'
title: Project Type
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/ProjectDB'
title: Response Get Project Runs For User Users User Id Runs Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/generate_password_reset:
get:
tags:
- users
summary: Generate Password Reset Link
operationId: generate_password_reset_link_generate_password_reset_get
security:
- ClassicAPIKeyHeader: []
- APIKeyHeader: []
- OAuth2PasswordBearer: []
- HTTPBasic: []
parameters:
- name: user_email
in: query
required: true
schema:
type: string
title: User Email
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/PasswordResetResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/users/{user_id}/transfer:
post:
tags:
- users
summary: Transfer User Data
description: Transfers all projects, runs, and edits created by a user to another user.
operationId: transfer_user_data_users__user_id__transfer_post
security:
- ClassicAPIKeyHeader: []
- APIKeyHeader: []
- OAuth2PasswordBearer: []
- HTTPBasic: []
parameters:
- name: user_id
in: path
required: true
schema:
type: string
format: uuid4
title: User Id
- name: new_user_id
in: query
required: true
schema:
type: string
format: uuid4
title: New User Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/TransferUserResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/current_user:
get:
tags:
- users
summary: Current User
operationId: current_user_current_user_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/CurrentUserDB'
security:
- ClassicAPIKeyHeader: []
- APIKeyHeader: []
- OAuth2PasswordBearer: []
- HTTPBasic: []
/v2/system_users:
post:
tags:
- users
summary: Create Or Verify User
description: 'Create a new system user with an email and password.
If no admin exists (first user), the user will be created as an admin.
Otherwise:
- User record was already created when the admin invited the user
- We should verify the user''s email'
operationId: create_or_verify_user_v2_system_users_post
parameters:
- name: signup_token
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Signup Token
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/UserCreate'
examples:
- email: user@example.com
first_name: Alice
last_name: Appleseed
auth_method: email
password: Th3secret_
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/SystemUserDB'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v2/system_users/social:
post:
tags:
- users
summary: Create Or Verify User Social
description: 'Create a user using a social login provider.
All social users are created with `email_is_verified=True`, don''t need to be invited and are by default read-only
(unless they are the first user, in which case they are set to admin).'
operationId: create_or_verify_user_social_v2_system_users_social_post
parameters:
- name: signup_token
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Signup Token
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/SocialLoginRequest'
examples:
- id_token: token1234
provider: google
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/SystemUserDB'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v2/user_roles:
get:
tags:
- users
summary: Get User Roles
description: Get all user roles.
operationId: get_user_roles_v2_user_roles_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
items:
$ref: '#/components/schemas/UserRoleInfo'
type: array
title: Response Get User Roles V2 User Roles Get
security:
- ClassicAPIKeyHeader: []
- APIKeyHeader: []
- OAuth2PasswordBearer: []
- HTTPBasic: []
/v2/invite_users:
post:
tags:
- users
summary: Invite Users
operationId: invite_users_v2_invite_users_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/InviteUsersRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- ClassicAPIKeyHeader: []
- APIKeyHeader: []
- OAuth2PasswordBearer: []
- HTTPBasic: []
/v2/users/all:
post:
tags:
- users
summary: List Users Paginated
operationId: list_users_paginated_v2_users_all_post
security:
- ClassicAPIKeyHeader: []
- APIKeyHeader: []
- OAuth2PasswordBearer: []
- HTTPBasic: []
parameters:
- name: starting_token
in: query
required: false
schema:
type: integer
default: 0
title: Starting Token
- name: limit
in: query
required: false
schema:
type: integer
default: 100
title: Limit
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/QueryUserParams'
default:
filters: []
sort:
name: created_at
ascending: false
sort_type: column
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/GetUsersResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v2/users/{user_id}:
get:
tags:
- users
summary: Get User
operationId: get_user_v2_users__user_id__get
security:
- ClassicAPIKeyHeader: []
- APIKeyHeader: []
- OAuth2PasswordBearer: []
- HTTPBasic: []
parameters:
- name: user_id
in: path
required: true
schema:
type: string
format: uuid4
title: User Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/GetUserResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
put:
tags:
- users
summary: Update User
operationId: update_user_v2_users__user_id__put
security:
- ClassicAPIKeyHeader: []
- APIKeyHeader: []
- OAuth2PasswordBearer: []
- HTTPBasic: []
parameters:
- name: user_id
in: path
required: true
schema:
type: string
format: uuid4
title: User Id
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/UserUpdate'
examples:
- first_name: Tony
last_name: Newname
email: bigtony@rungalileo.io
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateUserResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
delete:
tags:
- users
summary: Delete User
operationId: delete_user_v2_users__user_id__delete
security:
- ClassicAPIKeyHeader: []
- APIKeyHeader: []
- OAuth2PasswordBearer: []
- HTTPBasic: []
parameters:
- name: user_id
in: path
required: true
schema:
type: string
format: uuid4
title: User Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/DeleteUserResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v2/current_user:
get:
tags:
- users
summary: Current User
operationId: current_user_v2_current_user_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/CurrentUserDB'
security:
- ClassicAPIKeyHeader: []
- APIKeyHeader: []
- OAuth2PasswordBearer: []
- HTTPBasic: []
/public/v2/system_users:
post:
tags:
- users
summary: Create Or Verify User
description: 'Create a new system user with an email and password.
If no admin exists (first user), the user will be created as an admin.
Otherwise:
- User record was already created when the admin invited the user
- We should verify the user''s email'
operationId: create_or_verify_user_public_v2_system_users_post
parameters:
- name: signup_token
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Signup Token
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/UserCreate'
examples:
- email: user@example.com
first_name: Alice
last_name: Appleseed
auth_method: email
password: Th3secret_
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/SystemUserDB'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/public/v2/system_users/social:
post:
tags:
- users
summary: Create Or Verify User Social
description: 'Create a user using a social login provider.
All social users are created with `email_is_verified=True`, don''t need to be invited and are by default read-only
(unless they are the first user, in which case they are set to admin).'
operationId: create_or_verify_user_social_public_v2_system_users_social_post
parameters:
- name: signup_token
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Signup Token
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/SocialLoginRequest'
examples:
- id_token: token1234
provider: google
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/SystemUserDB'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/public/v2/user_roles:
get:
tags:
- users
summary: Get User Roles
description: Get all user roles.
operationId: get_user_roles_public_v2_user_roles_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
items:
# --- truncated at 32 KB (71 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/galileo-technologies/refs/heads/main/openapi/galileo-technologies-users-api-openapi.yml