Retrieve, Update, or Delete Blog | AISquare Studio

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

{
  "id": 1,
  "uid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "created_at": "2024-01-15T09:30:00Z",
  "updated_at": "2024-02-20T14:45:00Z",
  "publication": 12,
  "publication_custom_url": "tech-insights",
  "publication_name": "Tech Insights Weekly",
  "owner": {
    "id": 42,
    "username": "janedoe",
    "email": "jane.doe@example.com",
    "full_name": "Jane Doe",
    "is_verified": true,
    "details": [
      {
        "profile_picture": "https://example.com/images/janedoe.jpg",
        "bio": "Tech enthusiast and software developer.",
        "country": "USA",
        "phone": "+1-555-123-4567",
        "linkedin_url": "https://linkedin.com/in/janedoe",
        "github_url": "https://github.com/janedoe",
        "twitter_url": "https://twitter.com/janedoe",
        "website_url": "https://janedoe.dev",
        "top_domain_elo": 87.5,
        "top_domain_rank": 15
      }
    ],
    "followers_count": 3500
  },
  "source_experience": 5,
  "category_name": "Technology",
  "subcategory_name": "Artificial Intelligence",
  "status": "published",
  "user_bookmarked": true,
  "reading_time": "8 min read",
  "metrics": "{\"views\": 1200, \"likes\": 150, \"shares\": 30}",
  "generation_status": "completed",
  "has_generation_in_progress": "no",
  "is_ready_for_review": "yes",
  "deleted_at": "2024-03-01T10:00:00Z",
  "is_active": true,
  "created_by": "jatin.saini",
  "updated_by": "editor.jane",
  "deleted_by": "admin.mark",
  "title": "Understanding AI in Modern Applications",
  "cover_image": "https://example.com/images/ai-blog-cover.jpg",
  "content": "Artificial Intelligence (AI) is transforming industries by enabling new capabilities and efficiencies...",
  "focus_area": "Machine Learning",
  "tags": [
    null
  ],
  "visibility": "public",
  "is_draft": false,
  "disable_comments": false,
  "type": "free",
  "schedule_date": "2024-02-25T08:00:00Z",
  "published_date": "2024-02-26T09:00:00Z",
  "llm_prompt": "Generate a detailed summary of AI applications in modern software.",
  "format_type": "Summary"
}

Retrieves, updates, or deletes a blog by its ID with owner permission checks.

Path parameters

blog_idintegerRequired

The ID of the blog

Request

This endpoint expects an object.

ownerobjectRequired

deleted_atdatetime or nullOptional

is_activebooleanOptional

created_bystring or nullOptional<=255 characters

updated_bystring or nullOptional<=255 characters

deleted_bystring or nullOptional<=255 characters

publication_idintegerOptional

owner_idintegerOptional

titlestringOptional

cover_imagestring or nullOptionalformat: "uri"

contentstring or nullOptional

source_experience_idintegerOptional

categorystring or nullOptional

Category name

subcategorystring or nullOptional

Subcategory name

focus_areastring or nullOptional

tagslist of anyOptional

visibilityenumOptional

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

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

Allowed values:

is_draftbooleanOptional

Whether this blog is a draft

disable_commentsbooleanOptional

typeenumOptional

free - Free
paid - Paid

Allowed values:

schedule_datedatetime or nullOptional

published_datedatetime or nullOptional

llm_promptstringOptional

format_typeenumOptional

Format type for content generation

Summary - Summary
Detailed Notes - Detailed Notes
Bullet Points - Bullet Points
Q&A - Q&A
Insight-Driven - Insight-Driven

Format type for content generation * `Summary` - Summary * `Detailed Notes` - Detailed Notes * `Bullet Points` - Bullet Points * `Q&A` - Q&A * `Insight-Driven` - Insight-Driven

Allowed values:

Response

Blog details

idintegerRead-only

uidstringRead-onlyformat: "uuid"

created_atdatetimeRead-only

updated_atdatetimeRead-only

publicationinteger or nullRead-only

Publication this blog belongs to. Can be null for standalone blogs.

publication_custom_urlstringRead-only

publication_namestringRead-only

ownerobject

source_experienceinteger or nullRead-only

The experience this blog was created from

category_namestringRead-only

subcategory_namestringRead-only

statusstringRead-only

user_bookmarkedbooleanRead-only

reading_timestringRead-only

metricsstringRead-only

generation_statusstringRead-only

has_generation_in_progressstringRead-only

is_ready_for_reviewstringRead-only

deleted_atdatetime or null

is_activeboolean

created_bystring or null<=255 characters

updated_bystring or null<=255 characters

deleted_bystring or null<=255 characters

titlestring

cover_imagestring or nullformat: "uri"

contentstring or null

focus_areastring or null

tagslist of any

visibilityenum

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

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

Allowed values:

is_draftboolean

Whether this blog is a draft

disable_commentsboolean

typeenum

free - Free
paid - Paid

Allowed values:

schedule_datedatetime or null

published_datedatetime or null

llm_promptstring

format_typeenum

Format type for content generation

Summary - Summary
Detailed Notes - Detailed Notes
Bullet Points - Bullet Points
Q&A - Q&A
Insight-Driven - Insight-Driven

Format type for content generation * `Summary` - Summary * `Detailed Notes` - Detailed Notes * `Bullet Points` - Bullet Points * `Q&A` - Q&A * `Insight-Driven` - Insight-Driven

Allowed values:

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error