List, Add, or Remove Publication Collaborators | AISquare Studio

Manage collaborators (co-creators) for a publication by numeric ID.

GET: Returns an ordered list (newest first) of all collaborators. POST: Adds a collaborator by email. Requirements:

Email must correspond to an existing IAMUser account
User must be a member of the publication’s workspace with role EDITOR or higher
User must not already be a collaborator and must not be the owner DELETE: Removes a collaborator by email (owner/admin/editor may remove; a user can remove themselves). Permissions: Uses publication/workspace ACL via PublicationPermissionMixin. Error semantics: 404 when publication or user not found / insufficient authority, 400 for validation issues.

Manage collaborators (co-creators) for a publication by numeric ID. GET: Returns an ordered list (newest first) of all collaborators. POST: Adds a collaborator by email. Requirements: - Email must correspond to an existing IAMUser account - User must be a member of the publication's workspace with role EDITOR or higher - User must not already be a collaborator and must not be the owner DELETE: Removes a collaborator by email (owner/admin/editor may remove; a user can remove themselves). Permissions: Uses publication/workspace ACL via PublicationPermissionMixin. Error semantics: 404 when publication or user not found / insufficient authority, 400 for validation issues.

Path parameters

idintegerRequired

pkintegerRequired

Numeric ID of the publication

Request

This endpoint expects an object.

emailstringOptionalformat: "email"

Email of user to add/remove as collaborator (POST/DELETE only).

Response

List collaborators (GET) or successful removal (DELETE returns 204 but some clients show 200).

Errors

400

Bad Request Error

404

Not Found Error