Admin, Variables, Files & Analytics

me = client.admin.get_me()          # -> ApiKey: id, name, tenant_admin, value, permissions

client.admin.list_workspaces()                       # -> list[Workspace]
ws = client.admin.create_workspace("Marketing", description="…")   # -> Workspace
ws.delete()                                          # on the Workspace object
ws.add_api_key(...)                                  # mint a workspace key

client.admin.list_users(search="ada", status="pending")  # -> list[TenantUser]
user = client.admin.create_user(
    "[email protected]",
    display_name="Ada Lovelace",
    tenant_role="Base",                      # role id or name
    workspaces={workspace_id: "Editor"},     # workspace id -> role id or name
    send_invite=True,
)                                            # -> TenantUserDetail
client.admin.update_user(user.id, display_name="Ada King", metadata={"team": "core"})
client.admin.list_members(workspace_id)     # -> list[TenantUser]
client.admin.set_membership(other_workspace_id, user.id, "Runner")  # add, or change the role
client.admin.remove_membership(other_workspace_id, user.id)
client.admin.set_tenant_role(user.id, "Admin")
client.admin.suspend_user(user.id)           # blocks sign-in and sessions at once
client.admin.reactivate_user(user.id)
client.admin.get_user_access(user.id)        # role, workspaces and the permissions each gives
client.admin.delete_user(user.id, transfer_to=heir_id)

client.admin.list_roles()                            # -> list[dict]
client.admin.create_role("Editor", permissions={"resource:edit": True}, description="…")
client.admin.delete_role(role_id)

client.admin.list_system_keys()                      # -> list[ApiKey]
key = client.admin.create_system_key(
    "ci-bot", permissions=["users:read", "workspace:read"], tenant_admin=False
)
print(key.value)                                     # the secret — shown once
client.admin.delete_system_key(key.id)

client.variables.list()                              # -> list[dict] (secret values stripped)
client.variables.create(
    "API_BASE",
    value="https://api.example.com",
    kind="variable",          # "variable" | "secret"
    value_type="string",      # string | number | boolean | object | datetime | file
    source="inline",          # inline | vault | environment
)
client.variables.update(variable_id, {"value": "…"})
client.variables.delete(variable_id)                 # -> bool
# escape hatch for the full payload shape:
client.variables.create_raw({"name": "X", "value": "…", "kind": "variable"})

with open("report.pdf", "rb") as fd:
    f = client.files.save(fd)         # -> File (has an id/spot-uri)
data = client.files.get(f.id)         # -> bytes

from datetime import datetime, timedelta

end = datetime.utcnow()
start = end - timedelta(days=30)
result = client.analytics.get("runs", start, end, page=1, page_size=50)
# -> AnalyticsResult