qllm

List domains

View as Markdown
Get domains with optional filtering by ID, tag, recommendations, category, subcategory, saved status, search, and sorting options

Query parameters

categorystringOptional
Filter domains by category name
idstringOptional
Domain ID to retrieve specific domain
most_recentstringOptional

Sort domains by creation date (most recent first). Mutually exclusive with other sorting options

nintegerOptional
Number of domains to return
recently_viewedstringOptional

Sort domains by last update date (most recently updated first). Mutually exclusive with other sorting options

recommendedstringOptional
Get recommended domains
savedstringOptional

Filter to show only saved domains (requires authentication)

searchstringOptional
Search across domain name, summary, description, creator usernames, and tag names
subcategorystringOptional
Filter domains by subcategory name
tagstringOptional
Filter domains by tag

Response

idstringformat: "uuid"
domain_idintegerRead-only
tagslist of stringsRead-only
created_byobject

Mixin to handle profile_picture serialization for WebSocket compatibility.

This mixin adds a SerializerMethodField for profile_picture that converts ImageFieldFile objects to URL strings, making them JSON serializable for WebSocket consumers.

The mixin intelligently handles profile pictures from IAMUserDetail by:

  1. Accessing the related details queryset on the IAMUser model
  2. Extracting the ImageFieldFile from the first detail record
  3. Converting it to a URL string for JSON serialization

Usage:

1class MyUserSerializer(ProfilePictureMixin, serializers.ModelSerializer):
2    class Meta:
3        model = User
4        fields = ['id', 'username', 'profile_picture', ...]

Note:

  • This mixin expects the model to have a details related manager
  • The related detail should have a profile_picture ImageField
  • Returns None if no profile picture is found or an error occurs
categorystring or nullRead-only
subcategorystring or nullRead-only
co_creatorslist of objects
savedbooleanRead-only
metricsstringRead-only
workspace_idintegerRead-only
publicationmap from strings to any or nullRead-only
namestring<=255 characters
themestring<=64 characters
summarystring or null<=1024 characters
descriptionstring or null
coverstring or nullformat: "uri"

Cover image for the domain (copied from experience)

focus_areastring or null<=256 characters
visibilityenum
  • public - Public
  • private - Private
  • team - Team
  • org - Organization
Allowed values:
is_draftboolean
creation_statusenum
  • not_started - Not Started
  • in_progress - In Progress
  • completed - Completed
  • failed - Failed
Allowed values:

Errors

400
Bad Request Error