bamboo-server 2026.4.28

HTTP server and API layer for the Bamboo agent framework
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117

//! Settings and configuration handlers.
//!
//! This module is split by domain so each area can evolve independently
//! without growing a single monolithic file.

mod access_control;
mod bamboo_config;
mod env_vars;
mod keyword_masking;
mod provider;
mod redaction;
mod setup;
mod workflows;

pub use access_control::{
    enforce_access_password_middleware, get_access_status, update_access_password,
    verify_access_password,
};
pub use bamboo_config::{
    get_bamboo_config, get_bamboo_tools, get_model_limit_defaults, get_proxy_auth_status,
    reset_bamboo_config, set_bamboo_config, set_proxy_auth, validate_bamboo_config_patch,
    ProxyAuthPayload,
};
pub use env_vars::{delete_env_var, list_env_vars, replace_env_vars, upsert_env_var};
pub use keyword_masking::{
    get_keyword_masking_config, update_keyword_masking_config, validate_keyword_entries,
};
pub use provider::{
    fetch_catalog_models, fetch_provider_models, get_provider_catalog, get_provider_config,
    reload_provider_config, update_provider_config, UpdateProviderRequest,
};
pub use redaction::{redact_config_for_api, redact_providers_for_api};
pub use setup::{get_setup_status, mark_setup_complete, mark_setup_incomplete};
pub use workflows::{
    delete_workflow, get_workflow, list_workflows, save_workflow, SaveWorkflowRequest,
};

use actix_web::web;

/// Configures settings-related routes.
pub fn config(cfg: &mut web::ServiceConfig) {
    cfg.route("/bamboo/workflows", web::get().to(list_workflows))
        .route("/bamboo/workflows/{name}", web::get().to(get_workflow))
        .route("/bamboo/workflows", web::post().to(save_workflow))
        .route(
            "/bamboo/workflows/{name}",
            web::delete().to(delete_workflow),
        )
        .route("/bamboo/setup/status", web::get().to(get_setup_status))
        .route(
            "/bamboo/setup/complete",
            web::post().to(mark_setup_complete),
        )
        .route(
            "/bamboo/setup/incomplete",
            web::post().to(mark_setup_incomplete),
        )
        .route("/bamboo/config", web::get().to(get_bamboo_config))
        .route("/bamboo/config", web::post().to(set_bamboo_config))
        .route("/bamboo/access/status", web::get().to(get_access_status))
        .route(
            "/bamboo/access/verify",
            web::post().to(verify_access_password),
        )
        .route(
            "/bamboo/access/password",
            web::post().to(update_access_password),
        )
        .route(
            "/bamboo/model-limits/defaults",
            web::get().to(get_model_limit_defaults),
        )
        .route(
            "/bamboo/config/validate",
            web::post().to(validate_bamboo_config_patch),
        )
        .route("/bamboo/config/reset", web::post().to(reset_bamboo_config))
        .route("/bamboo/proxy-auth", web::post().to(set_proxy_auth))
        .route(
            "/bamboo/proxy-auth/status",
            web::get().to(get_proxy_auth_status),
        )
        .route(
            "/bamboo/keyword-masking",
            web::get().to(get_keyword_masking_config),
        )
        .route(
            "/bamboo/keyword-masking",
            web::post().to(update_keyword_masking_config),
        )
        .route(
            "/bamboo/keyword-masking/validate",
            web::post().to(validate_keyword_entries),
        )
        .route(
            "/bamboo/settings/provider",
            web::get().to(get_provider_config),
        )
        .route(
            "/bamboo/settings/provider",
            web::post().to(update_provider_config),
        )
        .route(
            "/bamboo/settings/provider/models",
            web::post().to(fetch_provider_models),
        )
        .route(
            "/bamboo/settings/reload",
            web::post().to(reload_provider_config),
        )
        .route("/bamboo/tools", web::get().to(get_bamboo_tools))
        // ── Env vars ──────────────────────────────────────────────
        .route("/bamboo/env-vars", web::get().to(list_env_vars))
        .route("/bamboo/env-vars", web::post().to(upsert_env_var))
        .route("/bamboo/env-vars/replace", web::post().to(replace_env_vars))
        .route("/bamboo/env-vars/{name}", web::delete().to(delete_env_var));
}