List and Create Experiences

View as Markdown
**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.

Request

This endpoint expects an object.
titlestring or nullOptional<=255 characters
rag_documentslist of integersOptional
content_vault_documentslist of integersOptional
List of content vault document IDs to link to this experience
categorystring or nullOptional
Category name
subcategorystring or nullOptional
Subcategory name
focus_areastring or nullOptional
tagslist of stringsOptional

List of tag names (will be created if they don’t exist)

visibilityenumOptional
* `public` - Public * `private` - Private * `team` - Team * `org` - Organization
Allowed values:
statusenumOptional
* `not_started` - Not Started * `in_progress` - In Progress * `completed` - Completed * `failed` - Failed
Allowed values:
is_draftbooleanOptional
stepinteger or nullOptional-2147483648-2147483647
publicationinteger or nullOptional
Single publication ID to link to the experience
needs_reviewbooleanOptional
Whether this experience requires review before publishing
experience_types_datalist of objectsOptional
selected_experience_typeslist of enumsOptional
List of experience types to include
Allowed values:

Response

List of experiences (mixed format based on draft status)

Errors

400
Bad Request Error
401
Unauthorized Error