authoring
Operations of the Biome Host API. Paths are relative to your deployment's API host.
POST /api/biome-host-api/authoring/biome-bundle
Generate a complete, schema-valid biome bundle (path → content) from a declaration. Writes nothing server-side.
Authentication: bearer token (Authorization: Bearer <token>)
Request body: application/json AuthorBiomeBundleDto
| Status | Description | Body |
|---|---|---|
| 200 | application/json AuthorBiomeBundleResponseDtoDataEnvelope | |
| 400 | application/problem+json ProblemDetailsDto | |
| 401 | application/problem+json ProblemDetailsDto | |
| 403 | application/problem+json ProblemDetailsDto | |
| 404 | application/problem+json ProblemDetailsDto | |
| 409 | application/problem+json ProblemDetailsDto | |
| 422 | application/problem+json ProblemDetailsDto | |
| 500 | application/problem+json ProblemDetailsDto |
POST /api/biome-host-api/authoring/capability-descriptor/validation
Validate a candidate capability contribution manifest against the kernel schema and return the normalized manifest or field-path-level issues.
Authentication: bearer token (Authorization: Bearer <token>)
Request body: application/json ValidateCapabilityDescriptorDto
| Status | Description | Body |
|---|---|---|
| 200 | application/json CapabilityDescriptorValidationDtoDataEnvelope | |
| 400 | application/problem+json ProblemDetailsDto | |
| 401 | application/problem+json ProblemDetailsDto | |
| 403 | application/problem+json ProblemDetailsDto | |
| 404 | application/problem+json ProblemDetailsDto | |
| 409 | application/problem+json ProblemDetailsDto | |
| 422 | application/problem+json ProblemDetailsDto | |
| 500 | application/problem+json ProblemDetailsDto |
POST /api/biome-host-api/authoring/connector-adapter/validation
Validate a candidate connector-adapter contribution manifest and return the normalized manifest, the capability refs its operations project, or field-path-level issues.
Authentication: bearer token (Authorization: Bearer <token>)
Request body: application/json ValidateConnectorAdapterDto
| Status | Description | Body |
|---|---|---|
| 200 | application/json ConnectorAdapterValidationDtoDataEnvelope | |
| 400 | application/problem+json ProblemDetailsDto | |
| 401 | application/problem+json ProblemDetailsDto | |
| 403 | application/problem+json ProblemDetailsDto | |
| 404 | application/problem+json ProblemDetailsDto | |
| 409 | application/problem+json ProblemDetailsDto | |
| 422 | application/problem+json ProblemDetailsDto | |
| 500 | application/problem+json ProblemDetailsDto |
POST /api/biome-host-api/authoring/surface-kind/validation
Validate a candidate surface-kind contribution manifest (enforcing the reserved first-party SurfaceKind set) and return the normalized manifest plus how a biome ships it.
Authentication: bearer token (Authorization: Bearer <token>)
Request body: application/json ValidateSurfaceKindDto
| Status | Description | Body |
|---|---|---|
| 200 | application/json SurfaceKindValidationDtoDataEnvelope | |
| 400 | application/problem+json ProblemDetailsDto | |
| 401 | application/problem+json ProblemDetailsDto | |
| 403 | application/problem+json ProblemDetailsDto | |
| 404 | application/problem+json ProblemDetailsDto | |
| 409 | application/problem+json ProblemDetailsDto | |
| 422 | application/problem+json ProblemDetailsDto | |
| 500 | application/problem+json ProblemDetailsDto |