{"id":23082,"library":"edx-organizations","title":"edx-organizations","description":"Organization management module for Open edX. Handles creation, membership, and API endpoints for organizations. Current version 8.0.0, updated irregularly with monthly bot-driven dependency upgrades.","status":"active","version":"8.0.0","language":"python","source_language":"en","source_url":"https://github.com/openedx/edx-organizations","tags":["open-edx","organizations","django","api"],"install":[{"cmd":"pip install edx-organizations","lang":"bash","label":"Standard install"}],"dependencies":[],"imports":[{"note":"Correct import for the main model.","symbol":"Organization","correct":"from organizations.models import Organization"},{"note":"v0 module is versioned; older paths removed.","wrong":"from organizations.api import views","symbol":"Organization API views","correct":"from organizations.api.v0 import views"}],"quickstart":{"code":"from organizations.models import Organization\nfrom django.db import connection\n\norg = Organization.objects.create(\n    name='Test University',\n    short_name='test_uni',\n)\nprint(f'Created organization: {org.name}')","lang":"python","description":"Create a simple organization record."},"warnings":[{"fix":"Upgrade Python to 3.9+ or pin edx-organizations<7.0.0","message":"Dropped Python 3.8 in v7.0.0. Python 3.8 users must pin to v6.13.0 or older.","severity":"breaking","affected_versions":">=7.0.0"},{"fix":"Upgrade to Django 4.2+ or pin edx-organizations<6.13.0","message":"Removed Django 3.2 support in v6.13.0. Django 3.2 users must stay on v6.12.x.","severity":"breaking","affected_versions":">=6.13.0"},{"fix":"Prefer REST API (v0) endpoints for CRUD operations.","message":"Direct use of Organization model outside of Open edX app is discouraged. Use API endpoints instead.","severity":"deprecated","affected_versions":"all"},{"fix":"Upgrade to >=6.11.1 or avoid periods in short_name.","message":"Short names with periods (e.g., 'test.org') cause 404 errors in older versions.","severity":"gotcha","affected_versions":"<6.11.1"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Use 'from organizations.api.v0 import views' instead.","cause":"Import path changed: old 'api' module was renamed to 'api.v0' in v6.x.","error":"ModuleNotFoundError: No module named 'organizations.api'"},{"fix":"Ensure you are using a recent version (>=4.0) and check the model fields.","cause":"Using outdated constructor signature. short_name was added in v4.x.","error":"TypeError: __init__() got an unexpected keyword argument 'short_name'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}