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

StatusDescriptionBody
200application/json AuthorBiomeBundleResponseDtoDataEnvelope
400application/problem+json ProblemDetailsDto
401application/problem+json ProblemDetailsDto
403application/problem+json ProblemDetailsDto
404application/problem+json ProblemDetailsDto
409application/problem+json ProblemDetailsDto
422application/problem+json ProblemDetailsDto
500application/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

StatusDescriptionBody
200application/json CapabilityDescriptorValidationDtoDataEnvelope
400application/problem+json ProblemDetailsDto
401application/problem+json ProblemDetailsDto
403application/problem+json ProblemDetailsDto
404application/problem+json ProblemDetailsDto
409application/problem+json ProblemDetailsDto
422application/problem+json ProblemDetailsDto
500application/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

StatusDescriptionBody
200application/json ConnectorAdapterValidationDtoDataEnvelope
400application/problem+json ProblemDetailsDto
401application/problem+json ProblemDetailsDto
403application/problem+json ProblemDetailsDto
404application/problem+json ProblemDetailsDto
409application/problem+json ProblemDetailsDto
422application/problem+json ProblemDetailsDto
500application/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

StatusDescriptionBody
200application/json SurfaceKindValidationDtoDataEnvelope
400application/problem+json ProblemDetailsDto
401application/problem+json ProblemDetailsDto
403application/problem+json ProblemDetailsDto
404application/problem+json ProblemDetailsDto
409application/problem+json ProblemDetailsDto
422application/problem+json ProblemDetailsDto
500application/problem+json ProblemDetailsDto