--- title: "Saves every file of a feature" method: PUT path: "/lambdas/{privateKey}/features/{feature}/files" tags: ["Features"] --- # Saves every file of a feature `PUT /lambdas/{privateKey}/features/{feature}/files` ## Request - Base URL: `https://genhttp.dev/api/v1` - URL: `https://genhttp.dev/api/v1/lambdas/{privateKey}/features/{feature}/files` - Auth: none declared `files` is the whole feature, `lambda.cs` first, held to the same rules as a version - including what a version may come to, since the feature becomes one. A feature keeps no history of its saves: pass the `revision` it was read at, and a save made in the meantime (by an agent, or in another window) is refused rather than silently replaced. ## Path parameters - `privateKey` string, required - `feature` string, required ## Query parameters - `deploy` boolean ## Request body - FeatureFilesRequest: Every file of a feature, replacing the ones it has. - `Files` LambdaFile[], nullable: Every file, `lambda.cs` first - `Name` string: Its path, with forward slashes: `lambda.cs`, `Store.cs`, `resources/web/index.html`, `docs/product.md`. Case sensitive, and also what the compiler's messages name. - `Code` string: Its content: the text itself, or base64 where `encoding` says so - `Encoding` string, nullable: `base64` for a file that is not text - a picture, a font; left out for text. C# files are always text. - `IsCompiled` boolean - `IsCode` boolean - `IsResource` boolean - `Bytes` string, byte - `Specification` string, nullable: What the user wants from it and why; left out, the one it has is kept - `Change` string, nullable: What it changes, in one line; left out, the one it has is kept - `Revision` integer, nullable: The `revision` of the feature these files were made from. Given, the save is refused with 409 if the feature was saved again since, instead of replacing that save without a trace. ## Response `200` The feature afterwards, and what came of its preview where that was asked for - FeatureSavedResponse: A feature that was just saved. - `Feature` FeatureResponse: A feature: a change being worked on beside the lambda. - `Key` string: What every call about it takes, and what its preview is reached by - `Name` string: What it is, in a few words - `Branch` string: The branch it is in the lambda's git repository - given when it starts, and kept when it is renamed - `Specification` string, nullable: What the user wants from it and why - `Change` string, nullable: What it changes, in one line - `Base` integer: The version it is based on - `Newest` integer, nullable: The newest version of the lambda - `Mergeable` boolean: Whether it can be merged: it is based on the newest version - `Origin` string, nullable: How it was started: `api`, `agent` or `git` - `Created` string, date-time: When it was started - `Modified` string, date-time: When it was last saved or changed - `Online` boolean: Whether its preview is online - `Current` boolean: Whether its preview is online and serves what the feature holds now, rather than an earlier save - `Previewed` string, date-time, nullable: When its preview was last put online, while it is - `PreviewPath` string: Where its preview answers on this site, whether it is online or not: `/features/{key}/` - `Revision` integer: How many times its files were saved, counting the ones it began with. Passed back with a save, it keeps that save from replacing one made elsewhere. - `Preview` FeaturePreviewResponse: What came of putting the preview of a feature online. - `Success` boolean: Whether it compiled and the preview is online with it - `Feature` FeatureResponse: A feature: a change being worked on beside the lambda. - `Key` string: What every call about it takes, and what its preview is reached by - `Name` string: What it is, in a few words - `Branch` string: The branch it is in the lambda's git repository - given when it starts, and kept when it is renamed - `Specification` string, nullable: What the user wants from it and why - `Change` string, nullable: What it changes, in one line - `Base` integer: The version it is based on - `Newest` integer, nullable: The newest version of the lambda - `Mergeable` boolean: Whether it can be merged: it is based on the newest version - `Origin` string, nullable: How it was started: `api`, `agent` or `git` - `Created` string, date-time: When it was started - `Modified` string, date-time: When it was last saved or changed - `Online` boolean: Whether its preview is online - `Current` boolean: Whether its preview is online and serves what the feature holds now, rather than an earlier save - `Previewed` string, date-time, nullable: When its preview was last put online, while it is - `PreviewPath` string: Where its preview answers on this site, whether it is online or not: `/features/{key}/` - `Revision` integer: How many times its files were saved, counting the ones it began with. Passed back with a save, it keeps that save from replacing one made elsewhere. - `Diagnostics` CompilationDiagnostic[]: What the compiler said: the errors that kept it offline, or the warnings of a preview that went online - `Severity` string: `Error`, which keeps the code from going online, or `Warning` - `Id` string: What kind of message it is: the C# compiler's (`CS1002`), `LAMBDA0001` for something lambdas may not do, `LAMBDA0002` for a handler the platform cannot serve, or `LAMBDA` for anything else the platform refused - `Message` string: What is wrong, and often what to do about it - `Line` integer: The line in the file, counting from 1; 0 when it is about no line - `Column` integer: The column in the line, counting from 1; 0 when it is about no line - `File` string, nullable: The name of the file it is in, as the lambda names it; absent when it is about none of them ## Other responses - `204`: A response containing no body - `400`: A file cannot be part of a lambda, or the files are larger than a version may be. Nothing was saved. - `404`: No lambda has this editor key, or the lambda has no feature with this key: it never existed, or it was merged or deleted. - `409`: The feature was saved again since `revision`. Read it again and make the change on top of what it holds now. --- [API](https://skmtc.dev/genhttp/apis/genhttp-lambda-api.md) · [All operations](https://skmtc.dev/genhttp/apis/genhttp-lambda-api/llms.txt) · [OpenAPI document](https://skmtc.dev/genhttp/apis/genhttp-lambda-api/revisions/8b36699e03df?raw)