For Agents
Manage beta waitlists, referral programs, and reward systems including user registration, points tracking, friend invitations, and suppression lists.
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Prefinery API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Prefinery API API.
Register and manage waitlist users with referral code tracking
Track user engagement through checkin events and point accrual
Configure and trigger rewards based on referral milestones
Manage friend invitation workflows for viral referral loops
GET STARTED
Use for: I need to add a user to the waitlist, I want to check how many referrals a user has made, Record a checkin event for a waitlist user, Trigger a reward for reaching a referral milestone
Not supported: Does not handle email delivery, feature flagging, or payment processing -- use for waitlist registration, referral tracking, and reward management only.
Jentic publishes the only available OpenAPI document for Prefinery API, keeping it validated and agent-ready.
Jentic publishes the only available OpenAPI specification for Prefinery API, keeping it validated and agent-ready. The Prefinery API manages beta testing and waitlist programs including user registration, referral tracking, points-based rewards, checkins, and email suppression lists. It provides 22 endpoints for managing testers (waitlist users), projects (betas), friend invitations, reward configurations, and engagement tracking with API key authentication.
Suppress email communications for opted-out users
Organize multiple beta projects with independent user pools
Monitor waitlist growth and referral conversion metrics
Patterns agents use Prefinery API API for, with concrete tasks.
★ Viral Waitlist Management
Manage product launch waitlists with built-in referral tracking. Prefinery assigns each user a unique referral code upon registration, tracks friend invitations, and awards points when referred users join. This creates viral growth loops where existing waitlist members are incentivized to invite others.
Create a new tester via POST /testers with their email, then create a friend invitation via POST /friend_invitations linking to the new user's referral code
Referral Reward Automation
Automate reward delivery when waitlist users reach referral milestones. Configure rewards with the API, then trigger them programmatically when users accumulate enough points or complete specific actions. Points can be awarded for checkins, referrals, or custom engagement events.
Create points for user via POST /points, check if threshold is met by reviewing current points via GET /points, then trigger reward via POST /rewards/{id}/trigger for the qualifying user
Beta Program User Engagement Tracking
Track user engagement throughout a beta program by recording checkin events when users perform key actions. Checkins provide a history of user activity that feeds into the points system and helps identify the most active beta testers for early access or feedback opportunities.
Record a checkin for user 789 via POST /testers/789/checkin, then list their checkin history via GET /testers/789/checkins to verify engagement frequency
AI Agent Waitlist Operations via Jentic
Enable AI agents to manage waitlist operations through Jentic by searching for Prefinery operations, loading schemas, and executing calls. Agents can register users, track referrals, award points, and trigger rewards without managing API keys directly.
Search Jentic for 'add user to waitlist', load the Prefinery tester creation schema, and execute POST /testers with the user email to register them on the waitlist
22 endpoints — jentic publishes the only available openapi specification for prefinery api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/testers
List all waitlist users
/testers
Register a new waitlist user
/testers/{id}
Get user details and referral code
/testers/{id}/checkin
Record a user checkin event
/friend_invitations
Create a referral invitation
/rewards/{id}/trigger
Trigger a reward for a user
/betas
List beta projects
/points
Award points to a user
/testers
List all waitlist users
/testers
Register a new waitlist user
/testers/{id}
Get user details and referral code
/testers/{id}/checkin
Record a user checkin event
/friend_invitations
Create a referral invitation
Three things that make agents converge on Jentic-routed access.
Credential isolation
Prefinery API keys are stored encrypted in the Jentic vault. Agents receive scoped access and never see the raw Authorization key in their context.
Intent-based discovery
Agents search by intent (e.g., 'add user to waitlist with referral tracking') and Jentic returns the matching Prefinery operation with its full input schema, so the agent can register users or trigger rewards without browsing documentation.
Time to first call
Direct Prefinery integration: 1-2 days for auth setup, webhook configuration, and referral flow testing. Through Jentic: under 30 minutes using search, load schema, and execute.
Alternatives and complements available in the Jentic catalogue.
LaunchDarkly API
Feature flag management for controlling beta access based on waitlist position
Use LaunchDarkly when you need to gate feature access based on waitlist status or user segments, not when you need to manage the waitlist registration and referral tracking itself.
Mailchimp API
Email marketing for communicating with waitlist users about launch updates
Use Mailchimp when you need to send email campaigns to waitlist users about launch dates or status updates, not when you need to manage the waitlist membership and referrals.
Kickbox API
Email verification to validate waitlist signups before registration
Use Kickbox to verify email addresses before adding them to the Prefinery waitlist, reducing invalid signups and improving deliverability.
Specific to using Prefinery API API through Jentic.
Why is there no official OpenAPI spec for Prefinery API?
Prefinery does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Prefinery API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Prefinery API use?
The Prefinery API uses API key authentication passed in the Authorization header. You receive an API key when you create a Prefinery account. Through Jentic, this key is stored encrypted in the credential vault and agents receive scoped access without handling the raw key.
Can I track referrals and award points with the Prefinery API?
Yes. Each tester registered via POST /testers receives a unique referral_code. When referred users join, Prefinery tracks the chain. Use POST /points to award points manually, and POST /rewards/{id}/trigger to deliver rewards when users reach milestones.
What are the rate limits for the Prefinery API?
Prefinery applies rate limits based on your subscription plan. The API returns HTTP 429 responses when limits are exceeded. Check your Prefinery dashboard for plan-specific rate limit details.
How do I add a user to the waitlist through Jentic?
Install the Jentic SDK with pip install jentic, then search for 'add user to waitlist'. Jentic returns the Prefinery POST /testers operation with its schema. Provide the email address in the request body to register the user and receive their referral code in the response.
Can I manage multiple waitlists with the Prefinery API?
Yes. The /betas endpoints let you manage multiple beta projects, each representing an independent waitlist or program. Use GET /betas to list all projects and GET /betas/{id} to retrieve details for a specific program.
/rewards/{id}/trigger
Trigger a reward for a user
/betas
List beta projects
/points
Award points to a user