Install & Compatibility
Where this runs
tested against v4.2.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.920 runs
installs and imports cleanly · install 0.0s · import 0.645s · 21.5MB
glibcpy 3.10–3.920 runs
installs and imports cleanly · install 2.2s · import 0.573s · 22MB
20MB installed
● package 20MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
delighted
✓ import delighted
SurveyResponse
✓ delighted.SurveyResponse.create(...)
Used for creating new survey responses.
Metrics
✓ delighted.Metrics.retrieve()
Used for retrieving account metrics.
AutopilotConfiguration
✓ delighted.AutopilotConfiguration.retrieve('email')
Used for retrieving Autopilot configurations.
TooManyRequestsError
✓ from delighted.errors import TooManyRequestsError
Specific exception for handling API rate limits.
This quickstart demonstrates how to configure the Delighted client with an API key, create a new person, add a survey response for that person, and retrieve account metrics. It also includes basic error handling for rate limits and general API errors. Ensure you replace 'YOUR_API_KEY' or set the DELIGHTED_API_KEY environment variable.
import os
import delighted
delighted.api_key = os.environ.get('DELIGHTED_API_KEY', 'YOUR_API_KEY')
try:
# Create a person
person = delighted.Person.create(email='test@example.com', name='Test User')
print(f"Created person: {person.id} - {person.email}")
# Add a survey response for the person
survey_response = delighted.SurveyResponse.create(person=person.id, score=10, comment='Very satisfied!')
print(f"Added survey response: {survey_response.id} with score {survey_response.score}")
# Retrieve metrics
metrics = delighted.Metrics.retrieve()
print(f"Retrieved metrics: {metrics}")
except delighted.errors.TooManyRequestsError as err:
print(f"Rate limit exceeded. Please wait {err.retry_after} seconds before retrying.")
except delighted.errors.APIError as err:
print(f"An API error occurred: {err.message}")
except Exception as e:
print(f"An unexpected error occurred: {e}")
Debug
Known issues
breakingThe Delighted service itself is being sunset on June 30, 2026. After this date, the API and this client library will cease to function.fixMigrate to an alternative customer feedback platform before June 30, 2026.
affects: All versions
deprecatedThis Python client package is officially deprecated and will no longer be maintained or receive updates.fixNo new features or bug fixes will be provided. Consider alternatives or freeze your current working version.
affects: All versions (effective immediately)
gotchaAPI authentication uses HTTP Basic Auth where your API key is the username and the password field must be left blank.fixEnsure your API key is correctly passed as the username, and the password is an empty string if using custom HTTP clients, or rely on the library's `delighted.api_key` configuration.
affects: All versions
gotchaRequests are subject to rate limits. Exceeding them will raise a `delighted.errors.TooManyRequestsError` exception with a `retry_after` attribute.fixImplement an exponential backoff or retry strategy, respecting the `retry_after` header/attribute. The official libraries include support for handling these errors.
affects: All versions
gotchaThe `delighted` module must be configured with your API key, either globally via `delighted.api_key` or by passing a `Client` instance to resource actions.fixSet `delighted.api_key = 'YOUR_API_KEY'` at the beginning of your application or explicitly pass a configured `Client` instance to each API call if managing multiple keys or environments.
affects: All versions
Upgrade
Version history
4.2.0latest on PyPI · released Mar 17, 2026
Audit
Dependencies
No dependency data recorded yet.