Retrieve, Update, or Delete Experience

View as Markdown
Retrieve a specific experience by ID, update it, or delete it. Returns detailed information including all experience type data. Users can only access their own experiences or public ones. **Category, Subcategory and Tags Support:** When updating, 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 names to the corresponding objects.

Path parameters

idintegerRequired

Response

Experience details or updated experience
idintegerRead-only
uidstringRead-onlyformat: "uuid"
titlestringRead-only
experience_titlestringRead-only
experience_descriptionstringRead-only
Get the description of the primary deployed resource. Returns empty string if not published or resource not found.
logo_urlstringRead-only
cover_urlstringRead-only
rag_documentslist of integersRead-only
categorystring or nullRead-only
subcategorystring or nullRead-only
tagslist of stringsRead-only
is_fully_publishedbooleanRead-only
True when all selected experience types have been successfully published
publicationstringRead-only
publication_detailsstringRead-only
experience_types_datalist of objectsRead-only
experience_typeslist of stringsRead-only
Get all experience types associated with this experience
has_published_versionsbooleanRead-only
Check if this experience has any published versions.
publishing_statusstringRead-only
Get the current publishing status of the experience.
generation_ready_for_reviewbooleanRead-only
Check if deployed AI Notes and Podcasts have completed generation.
blog_idstringRead-only
podcast_script_previewstringRead-only
metricsmap from strings to anyRead-only
Get metrics for the primary deployed resource. Returns default metrics if not published.
created_atdatetimeRead-only
updated_atdatetimeRead-only
ownerobject

Owner/uploader user object

focus_areastring or null
visibilityenum
* `public` - Public * `private` - Private * `team` - Team * `org` - Organization
Allowed values:
statusenum
* `not_started` - Not Started * `in_progress` - In Progress * `completed` - Completed * `failed` - Failed
Allowed values:
is_draftboolean
stepinteger or null-2147483648-2147483647
needs_reviewboolean
Whether this experience requires review before publishing
primary_deployed_resource_uidstring or nullformat: "uuid"

UID of the primary deployed resource (domain/blog/quest/podcast)

primary_deployed_resource_idinteger or null-2147483648-2147483647
Database ID of the primary deployed resource
primary_deployed_resource_typestring or null<=20 characters

Type of the primary deployed resource (AI Expert/AI Note/Quest/Podcast)

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error