Skip to content

Get a choice source's options

GET
/content/management/v1/choice-sources/{pluginKey}/choices
curl --request GET \
--url https://api.ebitex.io/content/management/v1/choice-sources/example/choices \
--header 'Authorization: Bearer <token>'

Asks one choice source for its current options, live. Changes nothing.

The list can change at any time. Saving a component does not check a value against it, so a value chosen earlier can later fall off the list.

Key: a management key with content.management.read.

pluginKey
required
string

{ "choices": [{ "value", "label" }] }.

missing_api_key or invalid_api_key: no key was sent, or it is unknown, revoked or expired.

payment_required: the organization’s subscription needs attention.

scope_denied: the key lacks this route’s scope. tier_required: the Content Management API needs the Pro plan or above. ip_denied: the caller’s address is outside the key’s allowed ranges. app_not_available: Content is not enabled for the organization.

unknown_choice_source: pluginKey is not a choice source activated for the organization.

Rate limit or quota exceeded; Retry-After says how long to wait. too_many_failed_authentications: too many bad keys from this address.

choice_source_failed: the source is unavailable or failed; message carries its own explanation. Check the source’s configuration.