Get, Update, or Delete Publication | AISquare Studio

curl -X PATCH /api/v1/publications/1/ \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "id": 1,
  "owner": "johndoe123",
  "owner_name": "John Doe",
  "owner_details": {
    "id": 42,
    "username": "johndoe123",
    "email": "johndoe@example.com",
    "followers_count": 256,
    "details": [
      {
        "profile_picture": "https://example.com/images/johndoe.jpg",
        "bio": "Tech enthusiast and AI researcher.",
        "country": "USA",
        "phone": "+1-555-123-4567",
        "linkedin_url": "https://linkedin.com/in/johndoe",
        "github_url": "https://github.com/johndoe",
        "twitter_url": "https://twitter.com/johndoe",
        "website_url": "https://johndoe.com",
        "top_domain_elo": 98.7,
        "top_domain_rank": 12
      }
    ],
    "full_name": "Johnathan Doe",
    "is_verified": true
  },
  "custom_url": "johns-tech-publication",
  "custom_url_last_updated": "2024-01-15T09:30:00Z",
  "next_custom_url_update": "2024-07-15T09:30:00Z",
  "highlighted_blog": {},
  "creator_cal_username": "johndoe_cal",
  "experiences_count": 15,
  "experiences_by_type": {},
  "workspace_id": 3,
  "subscribed": true,
  "logged_in_user_is_cocreator": false,
  "theme": "dark-mode",
  "subscribers_count": 1200,
  "uid": "550e8400-e29b-41d4-a716-446655440000",
  "created_at": "2023-11-20T14:22:00Z",
  "updated_at": "2024-01-15T09:30:00Z",
  "deleted_at": "2024-01-15T09:30:00Z",
  "name": "John's Tech Insights",
  "workspace": 3,
  "is_active": true,
  "created_by": "admin_user",
  "updated_by": "editor_user",
  "deleted_by": "admin_user",
  "description": "A publication focused on the latest trends in AI and technology.",
  "logo": "https://example.com/assets/logos/johns-tech-logo.png",
  "cover_image": "https://example.com/assets/covers/johns-tech-cover.jpg",
  "allow_bookings": true,
  "visibility": "public",
  "is_default": true,
  "is_premium": false,
  "is_verified": true,
  "tags": [
    101,
    205,
    309
  ]
}

Retrieves, updates, or deletes a specific publication.

Path parameters

idintegerRequired

pkintegerRequired

The ID of the publication

Request

This endpoint expects an object.

owner_detailsobjectOptional

Minimal user serializer for use in PublicationSerializers owner details field

custom_urlstringOptional<=255 characters

is_activebooleanOptional

created_bystring or nullOptional<=255 characters

updated_bystring or nullOptional<=255 characters

deleted_bystring or nullOptional<=255 characters

namestringOptional<=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

Publication details

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

403

Forbidden Error

404

Not Found Error