List and Create Experiences | AISquare Studio

import requests
url = "https://api.example.com/api/v1/experiences/"
payload = {}
headers = {"Content-Type": "application/json"}
response = requests.get(url, json=payload, headers=headers)
print(response.json())

{
  "count": 123,
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2",
  "results": [
    {
      "id": 101,
      "uid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "title": "Mastering AI Expert Systems",
      "experience_title": "Mastering AI Expert Systems",
      "experience_description": "An in-depth guide to building and deploying AI expert systems for real-world applications.",
      "logo_url": "https://cdn.aisquare.com/logos/ai_expert_mastering.png",
      "cover_url": "https://cdn.aisquare.com/covers/ai_expert_mastering_cover.jpg",
      "rag_documents": [
        45,
        78
      ],
      "category": "Technology",
      "subcategory": "Artificial Intelligence",
      "tags": [
        "AI expert",
        "machine learning",
        "expert systems"
      ],
      "is_fully_published": true,
      "publication": "Published on AISquare Platform",
      "publication_details": "Deployed as AI Expert system with full functionality and user access.",
      "experience_types_data": [
        {
          "experience_type": "AI_EXPERT",
          "logo_url": "https://cdn.aisquare.com/logos/ai_expert_icon.png",
          "cover_url": "https://cdn.aisquare.com/covers/ai_expert_cover.jpg"
        }
      ],
      "experience_types": [
        "AI_EXPERT"
      ],
      "has_published_versions": true,
      "publishing_status": "completed",
      "generation_ready_for_review": true,
      "blog_id": "b7a9f8d2-4c3e-4f1a-9d2e-8f7a9b6c5d4e",
      "podcast_script_preview": "",
      "metrics": {
        "views": 1520,
        "interactions": 320,
        "ratings": 4.8
      },
      "created_at": "2024-01-15T09:30:00Z",
      "updated_at": "2024-04-10T14:45:00Z",
      "owner": {
        "id": 12,
        "email": "jane.doe@example.com",
        "full_name": "Jane Doe",
        "username": "janedoe",
        "is_verified": true,
        "profile_picture": "https://cdn.aisquare.com/profiles/janedoe.jpg"
      }
    }
  ]
}

GET: List all experiences (drafts and published) for the logged-in user, ordered by last updated date. POST: Create a new experience with AI experience types and custom data.

Publishing Behavior: - When an experience is fully published (all selected types succeed), the original draft is hidden from listings - When partially published (some types fail), the draft remains visible but only contains the failed types - Published experiences appear as separate entries with deployed resource UIDs

UID Format for Listing: - Draft experiences: ‘uid’ contains the experience UID - Published experiences: ‘uid’ contains the deployed resource UID (domain/blog/quest), ‘experience_uid’ contains the original experience UID

Filtering and Search: Supports extensive filtering by category, subcategory, draft status, etc.

Category, Subcategory and Tags Support: You can specify category and subcategory using their names directly. Tags can be provided as a list of strings and will be created if they don’t exist. The system will automatically resolve category/subcategory names to the corresponding objects.

Podcast Preset Selection: For PODCAST experiences, include ‘voice_type’ in the data field with a valid preset code. First call GET /api/v1/podcasts/presets/ to list available presets (interview, panel, educational, narrative, debate), then use the preset code. The system validates that the selected preset has active voices available.

**GET:** List all experiences (drafts and published) for the logged-in user, ordered by last updated date. **POST:** Create a new experience with AI experience types and custom data. **Publishing Behavior:** - When an experience is fully published (all selected types succeed), the original draft is hidden from listings - When partially published (some types fail), the draft remains visible but only contains the failed types - Published experiences appear as separate entries with deployed resource UIDs **UID Format for Listing:** - **Draft experiences:** 'uid' contains the experience UID - **Published experiences:** 'uid' contains the deployed resource UID (domain/blog/quest), 'experience_uid' contains the original experience UID **Filtering and Search:** Supports extensive filtering by category, subcategory, draft status, etc. **Category, Subcategory and Tags Support:** You can specify category and subcategory using their names directly. Tags can be provided as a list of strings and will be created if they don't exist. The system will automatically resolve category/subcategory names to the corresponding objects. **Podcast Preset Selection:** For PODCAST experiences, include 'voice_type' in the data field with a valid preset code. First call GET /api/v1/podcasts/presets/ to list available presets (interview, panel, educational, narrative, debate), then use the preset code. The system validates that the selected preset has active voices available.

Query parameters

experience_typestringOptional

is_draftbooleanOptional

orderingstringOptional

Comma separated list of ordering fields. Prefix with - for descending.

pageintegerOptional

A page number within the paginated result set.

page_sizeintegerOptional

Number of results to return per page.

qstringOptional

Full-text search across key fields

searchstringOptional

sortstringOptional

statusstringOptional

visibilityenumOptional

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

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

Allowed values:

Response

List of experiences (mixed format based on draft status)

Errors

400

Bad Request Error

401

Unauthorized Error

GET: List all experiences (drafts and published) for the logged-in user, ordered by last updated date. POST: Create a new experience with AI experience types and custom data.

Filtering and Search: Supports extensive filtering by category, subcategory, draft status, etc.