DeepFellow API ReferenceConfig
Update dynamic server configuration.
Apply a partial update to the dynamic settings backed by config.json.
Only fields defined on DynamicSettings may be changed here — bootstrap fields (Mongo
connection, filestorage paths, plugins path, ...) are immutable at runtime. Validated,
persisted atomically, applied in-memory, and any required side effects (OTEL reconfigure)
are triggered — all without an API process restart. The separate Nightshift worker notices
the new config.json on its own and re-execs itself (see server.workers.nightshift).
curl -X PUT "https://deepfellow-server-host/admin/config" \ -H "Content-Type: application/json" \ -d '{}'{
"server_url": "http://localhost:8000",
"infra": {
"url": "http://127.0.0.1:8086",
"api_key": "",
"admin_api_key": ""
},
"chat_translation_model": "gemma3:1b",
"vector_database": {
"provider": {
"active": false,
"db": "default",
"password": "Milvus",
"type": "milvus",
"url": "http://localhost:19530",
"user": "root"
},
"embedding": {
"active": false,
"model": "mxbai",
"size": 1024,
"sparse": false
},
"reranker": {
"active": false,
"min_fetch_k": 50,
"model": "BAAI/bge-reranker-v2-m3",
"oversampling": 2.5
},
"search": {
"default_num_results": 5,
"max_num_results": 20
},
"vector_threshold": 0.3
},
"plugins_setup": {},
"ti_api_key": "",
"otel_exporter_otlp_endpoint": "http://localhost:4317",
"otel_tracing_enabled": false,
"otel_logging_enabled": false,
"sentry_enabled": false,
"sentry_dsn": "",
"sentry_environment": "",
"log_level": "INFO",
"evaluate_model": "gemma3:1b",
"metrics_username": "",
"metrics_password": "",
"embedding_worker_count": 5,
"embedding_batch_size": 10,
"only_admin_can_create_accounts_by_invitation": true,
"smtp": {
"host": "localhost",
"port": 25,
"auth": false,
"user": "",
"password": "",
"email_from": "no-reply@domain.com",
"use_tls": false
},
"reranker_worker_count": 5,
"doc_chunker_prefix": "doc_chunker",
"doc_chunker_picture_description_model": "gemma4:e4b",
"doc_chunker_stt_model": "Systran/faster-whisper-large-v3",
"doc_chunker_convert_timeout_seconds": 7200,
"doc_chunker_poll_interval_seconds": 5,
"doc_chunker_request_timeout_seconds": 300,
"lemmatizer_endpoint_prefix": "lemmatizer",
"lemmatizer_worker_count": 5,
"fine_tuning_poll_interval_seconds": 60,
"fine_tuning_max_worker_sync_failures": 5,
"metadata_expansion_model": "gemma3:1b",
"metadata_expansion_max_attempts": 3,
"metadata_expansion_concurrency": 4,
"summarization_model": "gemma4:12b",
"summarization_max_attempts": 3,
"summarization_concurrency": 4,
"nightshift_jobs_timeout_seconds": 10800,
"mcp_session_ttl_seconds": 300,
"mcp_session_sweep_interval_seconds": 60,
"graph": {
"enabled": false,
"host": "localhost",
"port": 6379,
"username": "",
"password": "",
"ssl": false,
"llm_model": "gpt-4o-mini",
"embedding_model": "text-embedding-3-small",
"embedding_dim": 1536,
"document_min_chars": 1000,
"document_max_chars": 8000,
"entity_extractor_prefix": "gliner",
"entity_extractor_timeout_seconds": 30,
"entity_extractor_threshold": 0.75,
"entity_extractor_max_retries": 2,
"fuzzy_dedup_enabled": false,
"fuzzy_dedup_threshold": 0.95,
"document_ingestion_concurrency": 4,
"ontology_discovery_llm_model": "gpt-4o-mini",
"ontology_discovery_sample_chunks_per_doc": 3,
"ontology_discovery_concurrency": 4,
"ontology_discovery_max_sample_files": 10,
"ontology_discovery_max_attempts": 3,
"ontology_discovery_llm_call_attempts": 4,
"ontology_discovery_max_new_entities": 0,
"ontology_discovery_max_new_relations": 0,
"ontology_discovery_semantic_fold_mode": "warn",
"ontology_discovery_semantic_fold_threshold": 0.85,
"document_ingestion_max_attempts": 3,
"ingestion_stale_after_seconds": 7200,
"orphan_sweep_interval_seconds": 3600
},
"vector_store_expiry_sweep_interval_seconds": 300,
"upload_expiry_sweep_interval_seconds": 300,
"max_concurrent_requests": 100,
"rabbitmq": {
"host": "localhost",
"port": 5672,
"username": "guest",
"password": "guest",
"vhost": "/",
"ssl": false,
"connect_timeout_seconds": 10
},
"finetune_pipelines": {
"tick_seconds": 60,
"max_active_runs": 1,
"generation_model": "gemma3:1b",
"generation_concurrency": 4,
"promotion_timeout_seconds": 21600,
"max_chunks_per_run": 2000,
"max_failed_chunk_ratio": 0.5,
"min_training_pairs": 20,
"eval_size": 50,
"eval_max_new_tokens": 512,
"judge_model": "gemma3:1b",
"first_version_min_score": 3,
"step_max_attempts": 3,
"vllm_service_id": "vllm"
}
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string",
"input": null,
"ctx": {}
}
]
}We use cookies on our website. We use them to ensure proper functioning of the site and, if you agree, for purposes such as analytics, marketing, and targeting ads.