Lexicon Garden
full diff

at.happyproto.registry.promoteRelease

happyproto.at +4 −0

← Back to CompareLexicon page

From
bafyreihy7ocnnbqyjmnhmdqc5x7ksb6c3i5nzxvctp6l3slutigrrxnteq indexed 2026-10-26 21:34 UTC View this version
To
bafyreifhksh6ytub5peh4atmqx6w37wmcnuj4bifgfwjby32n4psprngoe indexed 2026-11-01 21:46 UTC View this version

Compatibility

backward compatible No changes detected.

Changes

11{
22 "$type": "com.atproto.lexicon.schema",
33 "defs": {
44 "main": {
55 "description": "Publish an existing version's artifact under a new version, such as `1.2.0-rc.1` as `1.2.0`, without uploading it again. The new software.release.version points at the existing manifest. Optionally moves a channel to it and adds a changelog.",
66 "errors": [
77 {
88 "description": "The caller's identity could not be determined, so there is no repo to write to.",
99 "name": "AuthRequired"
1010 },
1111 {
1212 "description": "The registry has no identity configured. An operator problem, not a caller's.",
1313 "name": "NotConfigured"
1414 },
1515 {
1616 "description": "The input breaks a rule the registry applies, so it would refuse the records. The message names the field.",
1717 "name": "InvalidRecord"
1818 },
1919 {
20 "description": "The input breaks the method's lexicon, such as a field of the wrong format or past its length, and HappyView refused it before the registry saw it. The message names the field.",
21 "name": "InvalidRequest"
22 },
23 {
2024 "description": "A record could not be written to the caller's repo. Records written before the failure stay, and the same call can be made again.",
2125 "name": "Upstream"
2226 },
2327 {
2428 "description": "The caller has no project of that name, or the registry has not indexed its at.happyproto.registry.project record. Call putProject first.",
2529 "name": "ProjectMissing"
2630 },
2731 {
2832 "description": "fromVersion is not an indexed version of the caller's project.",
2933 "name": "VersionNotFound"
3034 },
3135 {
3236 "description": "The new version is already published. A version never changes once published.",
3337 "name": "VersionExists"
3438 },
3539 {
3640 "description": "track was given, but the project is unavailable or retired, so a channel cannot point at the new version.",
3741 "name": "NotInstallable"
3842 }
3943 ],
4044 "input": {
4145 "encoding": "application/json",
4246 "schema": {
4347 "properties": {
4448 "changelog": {
4549 "description": "Release notes as CommonMark. The registry writes them to the caller's repo as a site.standard.document and links it from the version.",
4650 "maxGraphemes": 20000,
4751 "maxLength": 200000,
4852 "type": "string"
4953 },
5054 "fromVersion": {
5155 "description": "The published version whose manifest the new version reuses.",
5256 "maxLength": 64,
5357 "minLength": 1,
5458 "type": "string"
5559 },
5660 "name": {
5761 "description": "The project's name, which is the record key of its software.release.project: 1 to 64 lowercase letters, digits and interior hyphens.",
5862 "maxLength": 64,
5963 "minLength": 1,
6064 "type": "string"
6165 },
6266 "track": {
6367 "description": "A channel to move to the new version. No channel moves when absent.",
6468 "knownValues": [
6569 "latest",
6670 "beta",
6771 "alpha"
6872 ],
6973 "type": "string"
7074 },
7175 "version": {
7276 "description": "The new version.",
7377 "maxLength": 64,
7478 "minLength": 1,
7579 "type": "string"
7680 }
7781 },
7882 "required": [
7983 "name",
8084 "fromVersion",
8185 "version"
8286 ],
8387 "type": "object"
8488 }
8589 },
8690 "output": {
8791 "encoding": "application/json",
8892 "schema": {
8993 "properties": {
9094 "changelog": {
9195 "description": "The changelog's site.standard.document, when a changelog was given.",
9296 "ref": "at.happyproto.registry.defs#ref",
9397 "type": "ref"
9498 },
9599 "channel": {
96100 "description": "The software.release.channel, when track was given.",
97101 "ref": "at.happyproto.registry.defs#ref",
98102 "type": "ref"
99103 },
100104 "resumed": {
101105 "description": "True when the new version already existed on the same manifest, so this call only finished what an earlier one started.",
102106 "type": "boolean"
103107 },
104108 "version": {
105109 "description": "The new software.release.version.",
106110 "ref": "at.happyproto.registry.defs#ref",
107111 "type": "ref"
108112 }
109113 },
110114 "required": [
111115 "version"
112116 ],
113117 "type": "object"
114118 }
115119 },
116120 "type": "procedure"
117121 }
118122 },
119123 "id": "at.happyproto.registry.promoteRelease",
120124 "lexicon": 1
121125}

Compare other versions