FAQ
Frequently asked questions
Short answers to the questions people ask first.
Can I read the catalog without an account?
Yes, the public rows. Rows whose Mode lets everyone view them (the default, public-read) are returned to anonymous callers; everything else needs sign-in or an API key.
How do I sign in?
Through Zitadel, the shared Fleetworks identity provider. Account creation is limited by a signup allowlist that an admin switches on.
What is a Mode?
A chmod-style permission value on each row: view, edit and delete bits for the owner, the owner group and everyone else. 484 is public-read, 480 adds the group, 448 is private.
Is an owner group the same as a Team?
No. A Team is a catalog resource that owns Services and Agents. An owner group is the access group whose members get the group bits of a row’s Mode.
How do I verify a webhook?
Compute HMAC-SHA256 of the X-YP-Timestamp value, a dot and the raw body, keyed with the signing secret returned when you created the webhook, and compare it with the X-YP-Signature header (sha256=<hex>).
Does Yellow Pages deploy anything?
No. It declares and validates Compositions and resolves their plan; your CI/CD does the deploying.
Is there a mobile or desktop app to download?
Not from this site. The mobile app’s builds go to TestFlight through a manual workflow, and the desktop app has not been released.
Is there billing?
No. The plans page shows sample pricing only; use the contact form to ask about access.
Still stuck? Contact us.