modifying-http-endpoints

To add a new HTTP endpoint in Golem, define the method using Poem and poem-openapi annotations, integrate the API struct into the worker or registry service, and update request/response types in golem-common for OpenAPI compatibility.

After modifying Golem REST API endpoints, regenerate the OpenAPI specifications and rebuild the client crates to ensure the generated API documentation and client code reflect the new endpoint definitions, request schemas, and response types.

Request and response types for a new Golem API endpoint are defined and mapped in the golem-common crate to ensure OpenAPI compatibility and consistent schema management across worker and registry services.

Use poem-openapi when adding or modifying HTTP REST API endpoints in Golem services to define new endpoint methods and ensure the API routes are properly annotated for OpenAPI specification generation and schema validation.

Golem API modification may require updating either the worker service or registry service depending on where the new endpoint is integrated, along with shared type definitions in golem-common and subsequent OpenAPI specification regeneration.