Publish a catalog to its repository
POST/api/publish_catalog/:local_name
Commits whatever the catalog currently holds and pushes it.
Open to any catalog whose repository accepts changes from this grid, not only one created here: a catalog installed on several grids has one repository, and whichever of them the maintainer is sitting at is where the changes are. Write access is confirmed with a test push the first time, so a read-only subscription still cannot reach this.
Validated with the same checks a subscriber runs on pull, before the push rather than after: publishing content that every subscriber would then refuse is a failure that belongs here, where the person who can fix it is standing, rather than in a customer's support ticket.
Request
Responses
- 200
- 400
- 403
- 404
- 409
- 422
- 502
Successful Response
The catalog's content would be rejected by a subscriber, or no key is available
The repository will not accept changes from this grid
Catalog not found
The repository has moved on; update the catalog first
Validation Error
The push failed