List or Add Publication Collaborators by Custom URL | AISquare Studio

Hybrid POST endpoint operating on publication identified by custom URL (resolved via mixin). Behavior: If request JSON omits ‘email’, returns collaborator list. If ‘email’ is provided, attempts to add collaborator using same validation rules as ID-based endpoint. Permissions: Access controlled by PublicationAccessControlMixin (workspace/public visibility ACL). Errors: 404 for missing publication/user or insufficient authority; 400 for role validation failures.

Hybrid POST endpoint operating on publication identified by custom URL (resolved via mixin). Behavior: If request JSON omits 'email', returns collaborator list. If 'email' is provided, attempts to add collaborator using same validation rules as ID-based endpoint. Permissions: Access controlled by PublicationAccessControlMixin (workspace/public visibility ACL). Errors: 404 for missing publication/user or insufficient authority; 400 for role validation failures.

Request

This endpoint expects an object.

urlstringRequired

Custom publication URL used for lookup (required even when listing).

emailstringOptionalformat: "email"

Optional email to add as collaborator. If omitted, lists collaborators.

Response

List of collaborators or publication collaborator data after no-op listing.

Errors

400

Bad Request Error

404

Not Found Error

1	curl -X POST /api/v1/publications/publication/collaborators/ \
2	-H "Content-Type: application/json" \
3	-d '{
4	"url": "my-publication.aisquare"
5	}'