Skip to main content
GET /v1/settings returns your organization’s configuration. One field is writable; the rest are set up by Endstate during onboarding.
​
string | null
Where taps land when no unit or collection redirect applies. Writable.
​
integer | null
Your organization’s default network - the one collections are created on when chain_id is omitted. null if none is configured. Read-only.
​
integer[]
The networks enabled for your organization. An explicit chain_id on collection create must be one of these. Read-only.

​
Set the default redirect

Set your organization’s fallback redirect, used when a tap has no more specific destination. Send null to clear it.
This is the lowest-priority redirect: a redirect set on the unit or its collection wins. See Tap redirects for the full resolution order.

​
Network configuration

default_chain_id and allowed_chain_ids are read-only and configured by Endstate. Most integrations never send a chain_id at all - omit it and collections are created on your default network. If you do send one explicitly, it must appear in allowed_chain_ids, or the request fails with validation.failed. To change either, contact Endstate.

​
Other settings

  • Publishable keys - the client-safe key identifying your organization.
  • CORS origins - which web origins may call the API from a browser. Managed at /v1/settings/cors-origins.

​
Next steps

Tap redirects

Set redirects per unit, per collection, or org-wide, and how they resolve.

Collections

How networks apply when you create a collection.