{"openapi":"3.1.0","info":{"title":"vgpu Examples Discovery API","version":"1.0.0","description":"Tokenless, read-only discovery for immutable vgpu example indexes, manifests, and hypermedia-linked source artifacts. Prefer `npx vgpu examples` for compatibility and integrity checks.","license":{"name":"MIT","url":"https://github.com/vercel-labs/vgpu/blob/main/LICENSE"}},"servers":[{"url":"https://vgpu.sh","description":"Canonical production origin"}],"security":[],"paths":{"/.well-known/vgpu-examples.json":{"get":{"operationId":"discoverExamplesApi","summary":"Discover supported examples API contracts and the current index pointer","description":"Discover supported examples API contracts and the current index pointer. HEAD returns identical status and headers without a body; OPTIONS returns the CORS policy. POST, PUT, PATCH, and DELETE return the frozen JSON error envelope with 405 and recovery guidance is documented at https://vgpu.sh/docs/examples-api#errors.","security":[],"parameters":[{"name":"If-None-Match","in":"header","required":false,"description":"Previously returned ETag for a conditional request.","schema":{"type":"string"}}],"responses":{"200":{"description":"The requested JSON artifact.","headers":{"Access-Control-Allow-Origin":{"description":"Public, credential-free CORS access.","schema":{"type":"string"}},"Access-Control-Expose-Headers":{"description":"Headers exposed to browser clients.","schema":{"type":"string"}},"Cache-Control":{"description":"Mutable revalidation or immutable revision caching policy.","schema":{"type":"string"}},"Content-Length":{"description":"Response body size in bytes; omitted on 304 responses.","schema":{"type":"integer","minimum":0}},"ETag":{"description":"Quoted SHA-256 digest of the response body.","schema":{"type":"string"}},"X-Content-Type-Options":{"description":"Always `nosniff`.","schema":{"type":"string","const":"nosniff"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExamplesDiscovery"}}}},"304":{"$ref":"#/components/responses/NotModified"},"404":{"$ref":"#/components/responses/NotFound"},"405":{"$ref":"#/components/responses/MethodNotAllowed"},"500":{"$ref":"#/components/responses/StorageFailure"}}},"head":{"operationId":"headExamplesDiscovery","summary":"Check discovery availability and validators without downloading its JSON body","description":"Check discovery availability and validators without downloading its JSON body.","security":[],"parameters":[{"name":"If-None-Match","in":"header","required":false,"description":"Previously returned ETag for a conditional request.","schema":{"type":"string"}}],"responses":{"200":{"description":"The artifact exists; no response body is returned.","headers":{"Access-Control-Allow-Origin":{"description":"Public, credential-free CORS access.","schema":{"type":"string"}},"Access-Control-Expose-Headers":{"description":"Headers exposed to browser clients.","schema":{"type":"string"}},"Cache-Control":{"description":"Mutable revalidation or immutable revision caching policy.","schema":{"type":"string"}},"Content-Length":{"description":"Response body size in bytes; omitted on 304 responses.","schema":{"type":"integer","minimum":0}},"ETag":{"description":"Quoted SHA-256 digest of the response body.","schema":{"type":"string"}},"X-Content-Type-Options":{"description":"Always `nosniff`.","schema":{"type":"string","const":"nosniff"}}}},"304":{"$ref":"#/components/responses/NotModified"},"404":{"$ref":"#/components/responses/NotFound"},"405":{"$ref":"#/components/responses/MethodNotAllowed"},"500":{"$ref":"#/components/responses/StorageFailure"}}},"options":{"operationId":"optionsExamplesDiscovery","summary":"Read the CORS policy","description":"Returns the public methods and request headers permitted for discovery.","security":[],"parameters":[],"responses":{"204":{"$ref":"#/components/responses/CorsPreflight"},"405":{"$ref":"#/components/responses/MethodNotAllowed"},"500":{"$ref":"#/components/responses/StorageFailure"}}}},"/api/examples/v1/latest.json":{"get":{"operationId":"getLatestExamplesRevision","summary":"Resolve the mutable pointer to the latest immutable examples revision and its index digest","description":"Resolve the mutable pointer to the latest immutable examples revision and its index digest. HEAD returns identical status and headers without a body; OPTIONS returns the CORS policy. POST, PUT, PATCH, and DELETE return the frozen JSON error envelope with 405 and recovery guidance is documented at https://vgpu.sh/docs/examples-api#errors.","security":[],"parameters":[{"name":"If-None-Match","in":"header","required":false,"description":"Previously returned ETag for a conditional request.","schema":{"type":"string"}}],"responses":{"200":{"description":"The requested JSON artifact.","headers":{"Access-Control-Allow-Origin":{"description":"Public, credential-free CORS access.","schema":{"type":"string"}},"Access-Control-Expose-Headers":{"description":"Headers exposed to browser clients.","schema":{"type":"string"}},"Cache-Control":{"description":"Mutable revalidation or immutable revision caching policy.","schema":{"type":"string"}},"Content-Length":{"description":"Response body size in bytes; omitted on 304 responses.","schema":{"type":"integer","minimum":0}},"ETag":{"description":"Quoted SHA-256 digest of the response body.","schema":{"type":"string"}},"X-Content-Type-Options":{"description":"Always `nosniff`.","schema":{"type":"string","const":"nosniff"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LatestPointer"}}}},"304":{"$ref":"#/components/responses/NotModified"},"404":{"$ref":"#/components/responses/NotFound"},"405":{"$ref":"#/components/responses/MethodNotAllowed"},"500":{"$ref":"#/components/responses/StorageFailure"}}},"head":{"operationId":"headLatestExamplesRevision","summary":"Check the latest pointer and validators without downloading its JSON body","description":"Check the latest pointer and validators without downloading its JSON body.","security":[],"parameters":[{"name":"If-None-Match","in":"header","required":false,"description":"Previously returned ETag for a conditional request.","schema":{"type":"string"}}],"responses":{"200":{"description":"The artifact exists; no response body is returned.","headers":{"Access-Control-Allow-Origin":{"description":"Public, credential-free CORS access.","schema":{"type":"string"}},"Access-Control-Expose-Headers":{"description":"Headers exposed to browser clients.","schema":{"type":"string"}},"Cache-Control":{"description":"Mutable revalidation or immutable revision caching policy.","schema":{"type":"string"}},"Content-Length":{"description":"Response body size in bytes; omitted on 304 responses.","schema":{"type":"integer","minimum":0}},"ETag":{"description":"Quoted SHA-256 digest of the response body.","schema":{"type":"string"}},"X-Content-Type-Options":{"description":"Always `nosniff`.","schema":{"type":"string","const":"nosniff"}}}},"304":{"$ref":"#/components/responses/NotModified"},"404":{"$ref":"#/components/responses/NotFound"},"405":{"$ref":"#/components/responses/MethodNotAllowed"},"500":{"$ref":"#/components/responses/StorageFailure"}}},"options":{"operationId":"optionsLatestExamplesRevision","summary":"Read the CORS policy","description":"Returns the public methods and request headers permitted for the latest pointer.","security":[],"parameters":[],"responses":{"204":{"$ref":"#/components/responses/CorsPreflight"},"405":{"$ref":"#/components/responses/MethodNotAllowed"},"500":{"$ref":"#/components/responses/StorageFailure"}}}},"/api/examples/v1/revisions/{revision}/index.json":{"get":{"operationId":"getExamplesRevisionIndex","summary":"Fetch the immutable index for one verified revision; follow each returned manifestUrl","description":"Fetch the immutable index for one verified revision; follow each returned manifestUrl. HEAD returns identical status and headers without a body; OPTIONS returns the CORS policy. POST, PUT, PATCH, and DELETE return the frozen JSON error envelope with 405 and recovery guidance is documented at https://vgpu.sh/docs/examples-api#errors.","security":[],"parameters":[{"name":"revision","in":"path","required":true,"description":"Immutable examples revision, encoded as a lowercase SHA-256 digest.","schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}},{"name":"If-None-Match","in":"header","required":false,"description":"Previously returned ETag for a conditional request.","schema":{"type":"string"}}],"responses":{"200":{"description":"The requested JSON artifact.","headers":{"Access-Control-Allow-Origin":{"description":"Public, credential-free CORS access.","schema":{"type":"string"}},"Access-Control-Expose-Headers":{"description":"Headers exposed to browser clients.","schema":{"type":"string"}},"Cache-Control":{"description":"Mutable revalidation or immutable revision caching policy.","schema":{"type":"string"}},"Content-Length":{"description":"Response body size in bytes; omitted on 304 responses.","schema":{"type":"integer","minimum":0}},"ETag":{"description":"Quoted SHA-256 digest of the response body.","schema":{"type":"string"}},"X-Content-Type-Options":{"description":"Always `nosniff`.","schema":{"type":"string","const":"nosniff"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImmutableIndex"}}}},"304":{"$ref":"#/components/responses/NotModified"},"404":{"$ref":"#/components/responses/NotFound"},"405":{"$ref":"#/components/responses/MethodNotAllowed"},"500":{"$ref":"#/components/responses/StorageFailure"}}},"head":{"operationId":"headExamplesRevisionIndex","summary":"Check an immutable revision index and validators without downloading its JSON body","description":"Check an immutable revision index and validators without downloading its JSON body.","security":[],"parameters":[{"name":"revision","in":"path","required":true,"description":"Immutable examples revision, encoded as a lowercase SHA-256 digest.","schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}},{"name":"If-None-Match","in":"header","required":false,"description":"Previously returned ETag for a conditional request.","schema":{"type":"string"}}],"responses":{"200":{"description":"The artifact exists; no response body is returned.","headers":{"Access-Control-Allow-Origin":{"description":"Public, credential-free CORS access.","schema":{"type":"string"}},"Access-Control-Expose-Headers":{"description":"Headers exposed to browser clients.","schema":{"type":"string"}},"Cache-Control":{"description":"Mutable revalidation or immutable revision caching policy.","schema":{"type":"string"}},"Content-Length":{"description":"Response body size in bytes; omitted on 304 responses.","schema":{"type":"integer","minimum":0}},"ETag":{"description":"Quoted SHA-256 digest of the response body.","schema":{"type":"string"}},"X-Content-Type-Options":{"description":"Always `nosniff`.","schema":{"type":"string","const":"nosniff"}}}},"304":{"$ref":"#/components/responses/NotModified"},"404":{"$ref":"#/components/responses/NotFound"},"405":{"$ref":"#/components/responses/MethodNotAllowed"},"500":{"$ref":"#/components/responses/StorageFailure"}}},"options":{"operationId":"optionsExamplesRevisionIndex","summary":"Read the CORS policy","description":"Returns the public methods and request headers permitted for a revision index.","security":[],"parameters":[{"name":"revision","in":"path","required":true,"description":"Immutable examples revision, encoded as a lowercase SHA-256 digest.","schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}],"responses":{"204":{"$ref":"#/components/responses/CorsPreflight"},"405":{"$ref":"#/components/responses/MethodNotAllowed"},"500":{"$ref":"#/components/responses/StorageFailure"}}}},"/api/examples/v1/revisions/{revision}/examples/{exampleId}/manifest.json":{"get":{"operationId":"getExampleManifest","summary":"Fetch an immutable example manifest whose files contain raw artifact URLs as hypermedia links","description":"Fetch an immutable example manifest whose files contain raw artifact URLs as hypermedia links. HEAD returns identical status and headers without a body; OPTIONS returns the CORS policy. POST, PUT, PATCH, and DELETE return the frozen JSON error envelope with 405 and recovery guidance is documented at https://vgpu.sh/docs/examples-api#errors.","security":[],"parameters":[{"name":"revision","in":"path","required":true,"description":"Immutable examples revision, encoded as a lowercase SHA-256 digest.","schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}},{"name":"exampleId","in":"path","required":true,"description":"Stable kebab-case example identifier returned by the immutable index.","schema":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"}},{"name":"If-None-Match","in":"header","required":false,"description":"Previously returned ETag for a conditional request.","schema":{"type":"string"}}],"responses":{"200":{"description":"The requested JSON artifact.","headers":{"Access-Control-Allow-Origin":{"description":"Public, credential-free CORS access.","schema":{"type":"string"}},"Access-Control-Expose-Headers":{"description":"Headers exposed to browser clients.","schema":{"type":"string"}},"Cache-Control":{"description":"Mutable revalidation or immutable revision caching policy.","schema":{"type":"string"}},"Content-Length":{"description":"Response body size in bytes; omitted on 304 responses.","schema":{"type":"integer","minimum":0}},"ETag":{"description":"Quoted SHA-256 digest of the response body.","schema":{"type":"string"}},"X-Content-Type-Options":{"description":"Always `nosniff`.","schema":{"type":"string","const":"nosniff"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExampleManifest"}}}},"304":{"$ref":"#/components/responses/NotModified"},"404":{"$ref":"#/components/responses/NotFound"},"405":{"$ref":"#/components/responses/MethodNotAllowed"},"500":{"$ref":"#/components/responses/StorageFailure"}}},"head":{"operationId":"headExampleManifest","summary":"Check an immutable example manifest and validators without downloading its JSON body","description":"Check an immutable example manifest and validators without downloading its JSON body.","security":[],"parameters":[{"name":"revision","in":"path","required":true,"description":"Immutable examples revision, encoded as a lowercase SHA-256 digest.","schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}},{"name":"exampleId","in":"path","required":true,"description":"Stable kebab-case example identifier returned by the immutable index.","schema":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"}},{"name":"If-None-Match","in":"header","required":false,"description":"Previously returned ETag for a conditional request.","schema":{"type":"string"}}],"responses":{"200":{"description":"The artifact exists; no response body is returned.","headers":{"Access-Control-Allow-Origin":{"description":"Public, credential-free CORS access.","schema":{"type":"string"}},"Access-Control-Expose-Headers":{"description":"Headers exposed to browser clients.","schema":{"type":"string"}},"Cache-Control":{"description":"Mutable revalidation or immutable revision caching policy.","schema":{"type":"string"}},"Content-Length":{"description":"Response body size in bytes; omitted on 304 responses.","schema":{"type":"integer","minimum":0}},"ETag":{"description":"Quoted SHA-256 digest of the response body.","schema":{"type":"string"}},"X-Content-Type-Options":{"description":"Always `nosniff`.","schema":{"type":"string","const":"nosniff"}}}},"304":{"$ref":"#/components/responses/NotModified"},"404":{"$ref":"#/components/responses/NotFound"},"405":{"$ref":"#/components/responses/MethodNotAllowed"},"500":{"$ref":"#/components/responses/StorageFailure"}}},"options":{"operationId":"optionsExampleManifest","summary":"Read the CORS policy","description":"Returns the public methods and request headers permitted for an example manifest.","security":[],"parameters":[{"name":"revision","in":"path","required":true,"description":"Immutable examples revision, encoded as a lowercase SHA-256 digest.","schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}},{"name":"exampleId","in":"path","required":true,"description":"Stable kebab-case example identifier returned by the immutable index.","schema":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"}}],"responses":{"204":{"$ref":"#/components/responses/CorsPreflight"},"405":{"$ref":"#/components/responses/MethodNotAllowed"},"500":{"$ref":"#/components/responses/StorageFailure"}}}}},"components":{"schemas":{"ExamplesDiscovery":{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://vgpu.labs.vercel.dev/schemas/examples/v1/discovery.schema.json","title":"VGPU Examples Discovery","type":"object","additionalProperties":false,"required":["protocol","discoveryVersion","contracts"],"properties":{"protocol":{"const":"vgpu-examples"},"discoveryVersion":{"const":1},"contracts":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":false,"required":["id","schemaSha256","status","minimumCliVersion","indexUrl"],"properties":{"id":{"type":"string","pattern":"^vgpu-examples/v[1-9][0-9]*$"},"schemaSha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"status":{"enum":["active","deprecated","revoked"]},"minimumCliVersion":{"type":"string","pattern":"^[0-9]+\\.[0-9]+\\.[0-9]+(?:-[0-9A-Za-z.-]+)?$"},"indexUrl":{"type":"string","format":"uri"}}}}}},"ExamplesIndex":{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://vgpu.labs.vercel.dev/schemas/examples/v1/index.schema.json","title":"VGPU Examples Index or Latest Pointer","oneOf":[{"type":"object","additionalProperties":false,"required":["schemaVersion","contractId","revision","indexUrl","indexSha256"],"properties":{"schemaVersion":{"const":1},"contractId":{"const":"vgpu-examples/v1"},"revision":{"$ref":"#/components/schemas/ExamplesIndex/$defs/sha256"},"indexUrl":{"type":"string","format":"uri"},"indexSha256":{"$ref":"#/components/schemas/ExamplesIndex/$defs/sha256"}}},{"type":"object","additionalProperties":false,"required":["schemaVersion","contractId","revision","source","examples"],"properties":{"schemaVersion":{"const":1},"contractId":{"const":"vgpu-examples/v1"},"revision":{"$ref":"#/components/schemas/ExamplesIndex/$defs/sha256"},"source":{"type":"object","additionalProperties":false,"required":["repository","gitCommit"],"properties":{"repository":{"type":"string","minLength":1},"gitCommit":{"type":"string","minLength":1}}},"examples":{"type":"array","items":{"$ref":"#/components/schemas/ExamplesIndex/$defs/example"}}}}],"$defs":{"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"example":{"type":"object","additionalProperties":false,"required":["id","title","description","tags","capabilities","fileCount","aggregateSha256","manifestUrl","manifestSha256"],"properties":{"id":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"title":{"type":"string","minLength":1},"description":{"type":"string","minLength":1},"tags":{"type":"array","items":{"type":"string"},"uniqueItems":true},"capabilities":{"type":"array","items":{"type":"string"},"uniqueItems":true},"fileCount":{"type":"integer","minimum":1,"maximum":128},"aggregateSha256":{"$ref":"#/components/schemas/ExamplesIndex/$defs/sha256"},"manifestUrl":{"type":"string","format":"uri"},"manifestSha256":{"$ref":"#/components/schemas/ExamplesIndex/$defs/sha256"}}}}},"LatestPointer":{"type":"object","additionalProperties":false,"required":["schemaVersion","contractId","revision","indexUrl","indexSha256"],"properties":{"schemaVersion":{"const":1},"contractId":{"const":"vgpu-examples/v1"},"revision":{"$ref":"#/components/schemas/LatestPointer/$defs/sha256"},"indexUrl":{"type":"string","format":"uri"},"indexSha256":{"$ref":"#/components/schemas/LatestPointer/$defs/sha256"}},"$defs":{"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"example":{"type":"object","additionalProperties":false,"required":["id","title","description","tags","capabilities","fileCount","aggregateSha256","manifestUrl","manifestSha256"],"properties":{"id":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"title":{"type":"string","minLength":1},"description":{"type":"string","minLength":1},"tags":{"type":"array","items":{"type":"string"},"uniqueItems":true},"capabilities":{"type":"array","items":{"type":"string"},"uniqueItems":true},"fileCount":{"type":"integer","minimum":1,"maximum":128},"aggregateSha256":{"$ref":"#/components/schemas/LatestPointer/$defs/sha256"},"manifestUrl":{"type":"string","format":"uri"},"manifestSha256":{"$ref":"#/components/schemas/LatestPointer/$defs/sha256"}}}}},"ImmutableIndex":{"type":"object","additionalProperties":false,"required":["schemaVersion","contractId","revision","source","examples"],"properties":{"schemaVersion":{"const":1},"contractId":{"const":"vgpu-examples/v1"},"revision":{"$ref":"#/components/schemas/ImmutableIndex/$defs/sha256"},"source":{"type":"object","additionalProperties":false,"required":["repository","gitCommit"],"properties":{"repository":{"type":"string","minLength":1},"gitCommit":{"type":"string","minLength":1}}},"examples":{"type":"array","items":{"$ref":"#/components/schemas/ImmutableIndex/$defs/example"}}},"$defs":{"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"example":{"type":"object","additionalProperties":false,"required":["id","title","description","tags","capabilities","fileCount","aggregateSha256","manifestUrl","manifestSha256"],"properties":{"id":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"title":{"type":"string","minLength":1},"description":{"type":"string","minLength":1},"tags":{"type":"array","items":{"type":"string"},"uniqueItems":true},"capabilities":{"type":"array","items":{"type":"string"},"uniqueItems":true},"fileCount":{"type":"integer","minimum":1,"maximum":128},"aggregateSha256":{"$ref":"#/components/schemas/ImmutableIndex/$defs/sha256"},"manifestUrl":{"type":"string","format":"uri"},"manifestSha256":{"$ref":"#/components/schemas/ImmutableIndex/$defs/sha256"}}}}},"ExampleManifest":{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://vgpu.labs.vercel.dev/schemas/examples/v1/manifest.schema.json","title":"VGPU Example Manifest","type":"object","additionalProperties":false,"required":["schemaVersion","contractId","revision","id","title","description","tags","capabilities","aggregateSha256","files"],"properties":{"schemaVersion":{"const":1},"contractId":{"const":"vgpu-examples/v1"},"revision":{"$ref":"#/components/schemas/ExampleManifest/$defs/sha256"},"id":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"title":{"type":"string","minLength":1},"description":{"type":"string","minLength":1},"tags":{"type":"array","items":{"type":"string"},"uniqueItems":true},"capabilities":{"type":"array","items":{"type":"string"},"uniqueItems":true},"aggregateSha256":{"$ref":"#/components/schemas/ExampleManifest/$defs/sha256"},"files":{"type":"array","minItems":1,"maxItems":128,"items":{"$ref":"#/components/schemas/ExampleManifest/$defs/file"}}},"$defs":{"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"file":{"type":"object","additionalProperties":false,"required":["path","contentType","size","sha256","url"],"properties":{"path":{"type":"string","minLength":1},"contentType":{"enum":["text/typescript","text/wgsl","text/plain"]},"size":{"type":"integer","minimum":0,"maximum":2097152},"sha256":{"$ref":"#/components/schemas/ExampleManifest/$defs/sha256"},"url":{"type":"string","format":"uri"}}}}},"ExamplesError":{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://vgpu.labs.vercel.dev/schemas/examples/v1/error.schema.json","title":"VGPU Examples Error","type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","pattern":"^VGPU-EXAMPLES-[A-Z0-9-]+$"},"message":{"type":"string","minLength":1}}}}}},"responses":{"NotModified":{"description":"The supplied ETag still identifies the current representation.","headers":{"Access-Control-Allow-Origin":{"description":"Public, credential-free CORS access.","schema":{"type":"string"}},"Access-Control-Expose-Headers":{"description":"Headers exposed to browser clients.","schema":{"type":"string"}},"Cache-Control":{"description":"Mutable revalidation or immutable revision caching policy.","schema":{"type":"string"}},"Content-Length":{"description":"Response body size in bytes; omitted on 304 responses.","schema":{"type":"integer","minimum":0}},"ETag":{"description":"Quoted SHA-256 digest of the response body.","schema":{"type":"string"}},"X-Content-Type-Options":{"description":"Always `nosniff`.","schema":{"type":"string","const":"nosniff"}}}},"NotFound":{"description":"The requested revision or artifact was not found. Rediscover from the well-known endpoint and follow its current links.","headers":{"Access-Control-Allow-Origin":{"description":"Public, credential-free CORS access.","schema":{"type":"string"}},"Access-Control-Expose-Headers":{"description":"Headers exposed to browser clients.","schema":{"type":"string"}},"Cache-Control":{"description":"Mutable revalidation or immutable revision caching policy.","schema":{"type":"string"}},"Content-Length":{"description":"Response body size in bytes; omitted on 304 responses.","schema":{"type":"integer","minimum":0}},"ETag":{"description":"Quoted SHA-256 digest of the response body.","schema":{"type":"string"}},"X-Content-Type-Options":{"description":"Always `nosniff`.","schema":{"type":"string","const":"nosniff"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExamplesError"}}}},"MethodNotAllowed":{"description":"Only GET, HEAD, and OPTIONS are supported. Retry with one of the methods in the Allow header.","headers":{"Access-Control-Allow-Origin":{"description":"Public, credential-free CORS access.","schema":{"type":"string"}},"Access-Control-Expose-Headers":{"description":"Headers exposed to browser clients.","schema":{"type":"string"}},"Cache-Control":{"description":"Mutable revalidation or immutable revision caching policy.","schema":{"type":"string"}},"Content-Length":{"description":"Response body size in bytes; omitted on 304 responses.","schema":{"type":"integer","minimum":0}},"ETag":{"description":"Quoted SHA-256 digest of the response body.","schema":{"type":"string"}},"X-Content-Type-Options":{"description":"Always `nosniff`.","schema":{"type":"string","const":"nosniff"}},"Allow":{"description":"Always `GET, HEAD, OPTIONS`.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExamplesError"}}}},"StorageFailure":{"description":"Artifact verification or storage failed. Retry later; do not treat this opaque error as a missing example.","headers":{"Access-Control-Allow-Origin":{"description":"Public, credential-free CORS access.","schema":{"type":"string"}},"Access-Control-Expose-Headers":{"description":"Headers exposed to browser clients.","schema":{"type":"string"}},"Cache-Control":{"description":"Mutable revalidation or immutable revision caching policy.","schema":{"type":"string"}},"Content-Length":{"description":"Response body size in bytes; omitted on 304 responses.","schema":{"type":"integer","minimum":0}},"ETag":{"description":"Quoted SHA-256 digest of the response body.","schema":{"type":"string"}},"X-Content-Type-Options":{"description":"Always `nosniff`.","schema":{"type":"string","const":"nosniff"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExamplesError"}}}},"CorsPreflight":{"description":"Public CORS policy; no response body.","headers":{"Access-Control-Allow-Origin":{"description":"Always `*`.","schema":{"type":"string","const":"*"}},"Access-Control-Allow-Methods":{"description":"Always `GET, HEAD, OPTIONS`.","schema":{"type":"string"}},"Access-Control-Allow-Headers":{"description":"Allows conditional `If-None-Match` requests.","schema":{"type":"string"}}}}}}}