Terse reference for the per-project model ids used by generation paths. For implementation details see the deep dive; for the web flow see the experience guide.
| Method & path | Body | Returns | Notes |
|---|---|---|---|
PUT /api/projects/{id}/provider-settings |
UpdateProjectProviderSettingsRequest |
204 No Content |
Updates default provider/model fields and the three generation model fields. Owner-only. |
Source: apps/Agentweaver.Api/Endpoints/ProjectEndpoints.cs:258.
UpdateProjectProviderSettingsRequest is defined in apps/Agentweaver.Api/Contracts/Dtos.cs:582; the web type mirrors it at apps/web/src/api/types.ts:241.
| Field | Type | Meaning |
|---|---|---|
default_provider |
string | null | Existing default provider field. |
default_model_github_copilot |
string | null | Existing default GitHub Copilot run model. |
default_model_microsoft_foundry |
string | null | Existing default BYOK run model; the legacy field name remains supported. |
blueprint_generation_model |
string | null | Model id for blueprint JSON generation. Null inherits the configured blueprint generation default. |
workflow_generation_model |
string | null | Model id for generated workflow fallback. Null inherits the configured workflow generation default. |
outcome_spec_generation_model |
string | null | Model id for coordinator outcome-spec drafting. Null inherits the configured outcome-spec generation default. |
ProjectResponse includes the same three generation model fields (apps/Agentweaver.Api/Contracts/Dtos.cs:605), and apps/web/src/api/types.ts:183 exposes them on Project.
| Field | Database column | Source |
|---|---|---|
ProjectRecord.BlueprintGenerationModel |
blueprint_generation_model |
ProjectRecord.cs:26; MemoryDbContext.cs:227 |
ProjectRecord.WorkflowGenerationModel |
workflow_generation_model |
ProjectRecord.cs:27; MemoryDbContext.cs:228 |
ProjectRecord.OutcomeSpecGenerationModel |
outcome_spec_generation_model |
ProjectRecord.cs:28; MemoryDbContext.cs:229 |
Postgres migration: apps/Agentweaver.Api.Migrations.Postgres/Migrations/20260708040300_AddProjectGenerationModelSettings.cs.
| Code | When |
|---|---|
204 No Content |
Settings were saved. |
400 Bad Request |
Project id is invalid, a model id fails IsAllowedModelId (the check uses a permissive ^(gpt|claude|o) prefix regex — no hardcoded allowlist), or service validation throws ArgumentException. |
403 Forbidden |
Caller does not own the project. |
404 Not Found |
Project does not exist or update found no row. |
Source: apps/Agentweaver.Api/Endpoints/ProjectEndpoints.cs:263, :270, :274, :293.
| Setting | Consumer | Source |
|---|---|---|
blueprint_generation_model |
POST /api/blueprints/generate resolves it with GenerationModelOptions.ResolveBlueprintModel before BlueprintService.GenerateAsync. |
BlueprintEndpoints.cs:58 |
workflow_generation_model |
BlueprintService.GenerateAsync places it in WorkflowGenerationRequest.GenerationModel for IWorkflowGenerator fallback. |
BlueprintService.cs:554 |
outcome_spec_generation_model |
CoordinatorRunService.ActivateAsync resolves it and passes it to CoordinatorDraftInput. |
CoordinatorRunService.cs:247 |
Blueprint generation returns classified provider errors when the configured model or provider cannot be used. AgentProviderException maps Copilot auth, rate-limit, model-list, unavailable-model, runtime, and transient failures to machine-readable codes (packages/Agentweaver.AgentRuntime/Providers/AgentProviderException.cs:41). BlueprintService.ProviderFailureResult stores those as ErrorCode and FailureMessage, and BlueprintEndpoints returns JSON with error, message, details, and options (BlueprintService.cs:625; BlueprintEndpoints.cs:63).