Skip to content

Publish and Manage Service

Publish fields

Core fields when publishing a service:

  • slug
  • name
  • provider
  • summary
  • baseUrl
  • agreementRequirements
  • capability tags
  • scenario tags
  • geo coverage
  • public / enabled status

Agreement declaration

Services do not publish agreement definitions here. They reference already-published agreement versions through agreementRequirements.

Example:

[
  {
    "name": "auth",
    "versions": ["v1.0.2"]
  },
  {
    "name": "try",
    "versions": ["v1.0.0"]
  }
]

Management actions

ASAHub currently supports:

  • create service
  • update service
  • enable / disable service
  • delete service

Practical advice

  • keep summary short and concrete
  • declare only agreements the service truly implements
  • make baseUrl stable before public release
  • choose tags for discoverability, not for decoration