Search within an organization
/api/v1/search/org_slug/{org_slug}search:reador user sessionPerforms a paginated search across courses, folders, and users within the given organization. Query length and page size are capped to prevent data dumping. Requires authentication.
Path parameters
org_slugstringrequiredQuery parameters
querystringrequiredSearch query
pageintegerPage number
limitintegerItems per page (max 50)
Returns
SearchResult: Search results grouped by resource type
coursesCourseRead[]requiredShow child attributes
namestringrequireddescriptionstring | nullaboutstring | nulllearningsstring | nulltagsstring | nulltarget_languagestring | nulltarget_levelstring | nulltarget_level_scalestring | nullthumbnail_typeenum | nullimagevideoboththumbnail_imagestring | nullthumbnail_videostring | nullpublicbooleanrequiredpublishedbooleanopen_to_contributorsbooleanrequiredidintegerrequiredorg_idintegerauthorsAuthorWithRole[]requiredShow child attributes
userUserReadAuthorrequiredMinimal author projection for community comments/discussions. SECURITY: comment/discussion authors are returned to *every* reader of a thread (often anonymous). It must therefore expose ONLY the fields needed to render an author chip, never ``email``, ``is_superadmin``, ``signup_method`` or the raw ``details``/``profile``/``extra_metadata`` blobs that ``UserRead`` carries. The frontend reads only id/user_uuid/username/name/avatar.
Show child attributes
idintegerrequireduser_uuidstringrequiredusernamestringrequiredfirst_namestringrequiredlast_namestringrequiredavatar_imagestring | nullauthorshipResourceAuthorshipEnumrequiredCREATORCONTRIBUTORMAINTAINERREPORTERauthorship_statusResourceAuthorshipStatusEnumrequiredACTIVEPENDINGINACTIVEcreation_datestringrequiredupdate_datestringrequiredcourse_uuidstringrequiredcreation_datestringrequiredupdate_datestringrequiredseoSeo | nullextra_metadataExtra Metadata | nullactivitiesSearchActivityRead[]Show child attributes
activity_uuidstringrequirednamestringrequiredactivity_typestringrequiredactivity_sub_typestringrequiredcourse_uuidstringrequiredcourse_namestringrequiredcourse_thumbnail_imagestring | nullchapter_uuidstringchapter_namestringfoldersFolderRead[]requiredShow child attributes
namestringrequiredpublicbooleandescriptionstring | nullthumbnail_imagestring | nullcolorstring | nullidintegerrequiredorg_idintegerrequiredfolder_uuidstringrequiredparent_folder_idinteger | nullorderintegercreation_datestringrequiredupdate_datestringrequiredtotal_itemsintegersubfoldersFolderRead[]Show child attributes
namestringrequiredpublicbooleandescriptionstring | nullthumbnail_imagestring | nullcolorstring | nullidintegerrequiredorg_idintegerrequiredfolder_uuidstringrequiredparent_folder_idinteger | nullorderintegercreation_datestringrequiredupdate_datestringrequiredtotal_itemsintegersubfoldersFolderRead[]Show child attributes
namestringrequiredpublicbooleandescriptionstring | nullthumbnail_imagestring | nullcolorstring | nullidintegerrequiredorg_idintegerrequiredfolder_uuidstringrequiredparent_folder_idinteger | nullorderintegercreation_datestringrequiredupdate_datestringrequiredtotal_itemsintegersubfoldersFolderRead[]itemsFolderContentItem[]breadcrumbsFolderBreadcrumb[]itemsFolderContentItem[]Show child attributes
resource_uuidstringrequiredresource_typestringrequiredpositionintegerresourceResourcerequiredbreadcrumbsFolderBreadcrumb[]Show child attributes
folder_uuidstringrequirednamestringrequireditemsFolderContentItem[]Show child attributes
resource_uuidstringrequiredresource_typestringrequiredpositionintegerresourceResourcerequiredbreadcrumbsFolderBreadcrumb[]Show child attributes
folder_uuidstringrequirednamestringrequiredusersUserReadPublic[]requiredShow child attributes
idintegerrequireduser_uuidstringrequiredusernamestringrequiredfirst_namestringrequiredlast_namestringrequiredemail_verifiedbooleanavatar_imagestring | nullbiostring | nulldetailsDetails | nullprofileProfile | nullcommunitiesCommunityRead[]requiredShow child attributes
namestringrequireddescriptionstring | nullpublicbooleanthumbnail_imagestring | nullidintegerrequiredorg_idintegercourse_idinteger | nullcoursesCommunityLinkedCourse[]Show child attributes
idintegerrequiredcourse_uuidstringrequirednamestringrequiredthumbnail_imagestringcommunity_uuidstringrequiredmoderation_wordsstring[]moderation_settingsModeration Settings | nullextra_metadataExtra Metadata | nullcreation_datestringrequiredupdate_datestringrequireddiscussionsSearchDiscussionRead[]requiredShow child attributes
idintegerrequiredtitlestringrequiredcontentstring | nulllabelstring | nullemojistring | nullcommunity_idintegerorg_idintegerauthor_idintegerdiscussion_uuidstringrequiredupvote_countintegerrequirededit_countintegeris_pinnedbooleanis_lockedbooleancreation_datestringrequiredupdate_datestringrequiredcommunity_uuidstringplaygroundsPlaygroundRead[]requiredShow child attributes
namestringrequireddescriptionstring | nullthumbnail_imagestring | nullaccess_typePlaygroundAccessTypepublicauthenticatedrestrictedpublishedbooleancourse_uuidstring | nullhtml_contentstring | nullidintegerrequiredorg_idintegerrequiredorg_uuidstring | nullorg_slugstring | nullplayground_uuidstringrequiredcourse_idinteger | nullcreated_byinteger | nullauthor_usernamestring | nullauthor_first_namestring | nullauthor_last_namestring | nullauthor_user_uuidstring | nullauthor_avatar_imagestring | nullcreation_datestringrequiredupdate_datestringrequiredpodcastsPodcastRead[]requiredShow child attributes
namestringrequireddescriptionstring | nullaboutstring | nulltagsstring | nullthumbnail_imagestring | nullpublicbooleanrequiredpublishedbooleanidintegerrequiredorg_idintegerauthorsAuthorWithRole[]requiredShow child attributes
userUserReadAuthorrequiredMinimal author projection for community comments/discussions. SECURITY: comment/discussion authors are returned to *every* reader of a thread (often anonymous). It must therefore expose ONLY the fields needed to render an author chip, never ``email``, ``is_superadmin``, ``signup_method`` or the raw ``details``/``profile``/``extra_metadata`` blobs that ``UserRead`` carries. The frontend reads only id/user_uuid/username/name/avatar.
Show child attributes
idintegerrequireduser_uuidstringrequiredusernamestringrequiredfirst_namestringrequiredlast_namestringrequiredavatar_imagestring | nullauthorshipResourceAuthorshipEnumrequiredCREATORCONTRIBUTORMAINTAINERREPORTERauthorship_statusResourceAuthorshipStatusEnumrequiredACTIVEPENDINGINACTIVEcreation_datestringrequiredupdate_datestringrequiredpodcast_uuidstringrequiredcreation_datestringrequiredupdate_datestringrequiredseoSeo | nulltotal_coursesintegertotal_activitiesintegertotal_foldersintegertotal_usersintegertotal_communitiesintegertotal_discussionsintegertotal_playgroundsintegertotal_podcastsintegerError responses
401Authentication required403User is not permitted to search this organization404Organization not found422Validation Error:HTTPValidationError
{
"courses": [
{
"name": "Example name",
"description": "An example description",
"about": "string",
"learnings": "string",
"tags": "string",
"target_language": "string",
"target_level": "string",
"target_level_scale": "string",
"thumbnail_type": "image",
"thumbnail_image": "string",
"thumbnail_video": "string",
"public": false,
"published": false,
"open_to_contributors": false,
"id": 1,
"org_id": 1,
"authors": [
{
"user": {
"id": null,
"user_uuid": null,
"username": null,
"first_name": null,
"last_name": null,
"avatar_image": null
},
"authorship": "CREATOR",
"authorship_status": "ACTIVE",
"creation_date": "string",
"update_date": "string"
}
],
"course_uuid": "string",
"creation_date": "string",
"update_date": "string",
"seo": {},
"extra_metadata": {}
}
],
"activities": [],
"folders": [
{
"name": "Example name",
"public": true,
"description": "An example description",
"thumbnail_image": "string",
"color": "#0a0a0a",
"id": 1,
"org_id": 1,
"folder_uuid": "string",
"parent_folder_id": 1,
"order": 0,
"creation_date": "string",
"update_date": "string",
"total_items": 0,
"subfolders": [],
"items": [],
"breadcrumbs": []
}
],
"users": [
{
"id": 1,
"user_uuid": "string",
"username": "string",
"first_name": "Example name",
"last_name": "Example name",
"email_verified": false,
"avatar_image": "string",
"bio": "string",
"details": {},
"profile": {}
}
],
"communities": [
{
"name": "Example name",
"description": "An example description",
"public": true,
"thumbnail_image": "string",
"id": 1,
"org_id": 1,
"course_id": 1,
"courses": [
{
"id": 1,
"course_uuid": "string",
"name": "Example name",
"thumbnail_image": ""
}
],
"community_uuid": "string",
"moderation_words": [],
"moderation_settings": {},
"extra_metadata": {},
"creation_date": "string",
"update_date": "string"
}
],
"discussions": [
{
"id": 1,
"title": "Example title",
"content": "string",
"label": "string",
"emoji": "string",
"community_id": 1,
"org_id": 1,
"author_id": 1,
"discussion_uuid": "string",
"upvote_count": 0,
"edit_count": 0,
"is_pinned": false,
"is_locked": false,
"creation_date": "string",
"update_date": "string",
"community_uuid": ""
}
],
"playgrounds": [
{
"name": "Example name",
"description": "An example description",
"thumbnail_image": "string",
"access_type": "public",
"published": false,
"course_uuid": "string",
"html_content": "string",
"id": 1,
"org_id": 1,
"org_uuid": "string",
"org_slug": "my-example-slug",
"playground_uuid": "string",
"course_id": 1,
"created_by": 0,
"author_username": "string",
"author_first_name": "Example name",
"author_last_name": "Example name",
"author_user_uuid": "string",
"author_avatar_image": "string",
"creation_date": "string",
"update_date": "string"
}
],
"podcasts": [
{
"name": "Example name",
"description": "An example description",
"about": "string",
"tags": "string",
"thumbnail_image": "string",
"public": false,
"published": false,
"id": 1,
"org_id": 1,
"authors": [
{
"user": {
"id": null,
"user_uuid": null,
"username": null,
"first_name": null,
"last_name": null,
"avatar_image": null
},
"authorship": "CREATOR",
"authorship_status": "ACTIVE",
"creation_date": "string",
"update_date": "string"
}
],
"podcast_uuid": "string",
"creation_date": "string",
"update_date": "string",
"seo": {}
}
],
"total_courses": 0,
"total_activities": 0,
"total_folders": 0,
"total_users": 0,
"total_communities": 0,
"total_discussions": 0,
"total_playgrounds": 0,
"total_podcasts": 0
}