List or Create Publications | AISquare Studio

curl -X POST /api/v1/publications/ \
     -H "Content-Type: application/json" \
     -d '{
  "custom_url": "ai-insights",
  "name": "AI Insights Monthly"
}'

{
  "id": 42,
  "owner": "jatin_saini",
  "owner_name": "Jatin Saini",
  "owner_details": {
    "id": 7,
    "username": "jatin_saini",
    "email": "jatin.saini@example.com",
    "followers_count": 1250,
    "details": [
      {
        "profile_picture": "https://example.com/profiles/jatin_saini.jpg",
        "bio": "Tech enthusiast and AI researcher.",
        "country": "India",
        "phone": "+91-9876543210",
        "linkedin_url": "https://linkedin.com/in/jatinsaini",
        "github_url": "https://github.com/jatinsaini",
        "twitter_url": "https://twitter.com/jatinsaini",
        "website_url": "https://jatinsaini.com",
        "top_domain_elo": 98.7,
        "top_domain_rank": 12
      }
    ],
    "full_name": "Jatin Saini",
    "is_verified": true
  },
  "custom_url": "ai-insights",
  "custom_url_last_updated": "2024-01-15T09:30:00Z",
  "next_custom_url_update": "2024-07-15T09:30:00Z",
  "highlighted_blog": {},
  "creator_cal_username": "jatin_cal",
  "experiences_count": 34,
  "experiences_by_type": {},
  "workspace_id": 3,
  "subscribed": true,
  "logged_in_user_is_cocreator": false,
  "theme": "dark",
  "subscribers_count": 5400,
  "uid": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "created_at": "2023-11-20T14:22:00Z",
  "updated_at": "2024-04-10T11:15:00Z",
  "deleted_at": "2024-01-15T09:30:00Z",
  "name": "AI Insights Monthly",
  "workspace": 3,
  "is_active": true,
  "created_by": "jatin_saini",
  "updated_by": "admin_user",
  "deleted_by": "system",
  "description": "A monthly publication covering the latest trends and research in artificial intelligence.",
  "logo": "https://example.com/logos/ai-insights-logo.png",
  "cover_image": "https://example.com/covers/ai-insights-cover.jpg",
  "allow_bookings": false,
  "visibility": "public",
  "is_default": false,
  "is_premium": true,
  "is_verified": true,
  "tags": [
    101,
    205,
    309
  ]
}

List publications scoped to the current workspace (unless public/global query params supplied) or create a new publication.

Creation now supports optional bulk cocreator assignment via repeated multipart form keys ‘emails’. All provided emails must:

Correspond to existing IAMUser accounts
Be members of the publication’s workspace with effective role EDITOR or higher
Not already be cocreators and not be the owner Validation is all-or-nothing: if any email fails, none are added and a 400 response with per-email errors is returned.

Search:

q - Full-text search across name and description fields

Ordering Options:

ordering=updated_at or ordering=-updated_at - Sort by last update (default: descending)
ordering=created_at or ordering=-created_at - Sort by creation date
ordering=name or ordering=-name - Sort alphabetically by name
ordering=experiences_count or ordering=-experiences_count - Sort by number of experiences
ordering=subscribers_count or ordering=-subscribers_count - Sort by number of subscribers

List publications scoped to the current workspace (unless public/global query params supplied) or create a new publication. Creation now supports optional bulk cocreator assignment via repeated multipart form keys 'emails'. All provided emails must: - Correspond to existing IAMUser accounts - Be members of the publication's workspace with effective role EDITOR or higher - Not already be cocreators and not be the owner Validation is all-or-nothing: if any email fails, none are added and a 400 response with per-email errors is returned. **Search:** - `q` - Full-text search across name and description fields **Ordering Options:** - `ordering=updated_at` or `ordering=-updated_at` - Sort by last update (default: descending) - `ordering=created_at` or `ordering=-created_at` - Sort by creation date - `ordering=name` or `ordering=-name` - Sort alphabetically by name - `ordering=experiences_count` or `ordering=-experiences_count` - Sort by number of experiences - `ordering=subscribers_count` or `ordering=-subscribers_count` - Sort by number of subscribers

Query parameters

emailsstringOptional

Repeatable form key for cocreator emails (multipart/form-data). Provide multiple ‘emails’ keys, each with a single email value.

orderingstringOptional

Order results by specified field. Prefix with ’-’ for descending order. Options: updated_at, created_at, name, experiences_count, subscribers_count. Default: -updated_at

qstringOptional

Full-text search across publication name and description

Request

This endpoint expects an object.

owner_detailsobjectRequired

Minimal user serializer for use in PublicationSerializers owner details field

custom_urlstringRequired<=255 characters

namestringRequired<=255 characters

is_activebooleanOptional

created_bystring or nullOptional<=255 characters

updated_bystring or nullOptional<=255 characters

deleted_bystring or nullOptional<=255 characters

descriptionstringOptional

logostring or nullOptionalformat: "uri"

cover_imagestring or nullOptionalformat: "uri"

allow_bookingsbooleanOptional

visibilityenumOptional

public - Public
private - Private
team - Team
org - Organization

* `public` - Public * `private` - Private * `team` - Team * `org` - Organization

Allowed values:

is_defaultbooleanOptional

Whether this is the user's default publication

is_premiumbooleanOptional

Whether this is a premium publication

is_verifiedbooleanOptional

Whether this publication has been verified

tagslist of integersOptional

Response

List of publications

idintegerRead-only

ownerstringRead-only

Required. 150 characters or fewer. Letters, digits and @/./+/-/_ only.

owner_namestringRead-only

owner_detailsobject

Minimal user serializer for use in PublicationSerializers owner details field

custom_urlstring<=255 characters

custom_url_last_updateddatetimeRead-only

next_custom_url_updatestringRead-only

highlighted_blogmap from strings to any or nullRead-only

creator_cal_usernamestring or nullRead-only

Get the Cal.com username of the publication owner if they have Cal.com integration enabled, otherwise return None. Now prioritizes the cal_username field populated by sync command.

experiences_countintegerRead-only

Get the total count of published experiences for this publication.

Uses centralized ExperienceCountingService for consistency. Only counts experiences with is_draft=False and primary_deployed_resource_id set.

experiences_by_typemap from strings to integersRead-only

Get the count of published experiences by type for this publication.

Uses centralized ExperienceCountingService for consistency. Returns a dictionary with experience type as key and count as value. Only counts experiences with is_draft=False and primary_deployed_resource_id set.

Output Sample: { “AI_EXPERT”: 5, “AI_NOTE”: 10, “QUEST”: 3, “PODCAST”: 2 }

workspace_idintegerRead-only

subscribedbooleanRead-only

logged_in_user_is_cocreatorbooleanRead-only

themestringRead-only

subscribers_countintegerRead-only

uidstringRead-onlyformat: "uuid"

created_atdatetimeRead-only

updated_atdatetimeRead-only

deleted_atdatetime or nullRead-only

namestring<=255 characters

workspaceinteger or nullRead-only

Workspace (DGM Group) this publication belongs to. Null for legacy publications.

is_activeboolean

created_bystring or null<=255 characters

updated_bystring or null<=255 characters

deleted_bystring or null<=255 characters

descriptionstring

logostring or nullformat: "uri"

cover_imagestring or nullformat: "uri"

allow_bookingsboolean

visibilityenum

public - Public
private - Private
team - Team
org - Organization

* `public` - Public * `private` - Private * `team` - Team * `org` - Organization

Allowed values:

is_defaultboolean

Whether this is the user's default publication

is_premiumboolean

Whether this is a premium publication

is_verifiedboolean

Whether this publication has been verified

tagslist of integers

Errors

400

Bad Request Error

401

Unauthorized Error

List publications scoped to the current workspace (unless public/global query params supplied) or create a new publication.

Creation now supports optional bulk cocreator assignment via repeated multipart form keys ‘emails’. All provided emails must:

Correspond to existing IAMUser accounts
Be members of the publication’s workspace with effective role EDITOR or higher
Not already be cocreators and not be the owner Validation is all-or-nothing: if any email fails, none are added and a 400 response with per-email errors is returned.

Search:

q - Full-text search across name and description fields

Ordering Options:

ordering=updated_at or ordering=-updated_at - Sort by last update (default: descending)
ordering=created_at or ordering=-created_at - Sort by creation date
ordering=name or ordering=-name - Sort alphabetically by name
ordering=experiences_count or ordering=-experiences_count - Sort by number of experiences
ordering=subscribers_count or ordering=-subscribers_count - Sort by number of subscribers