1. Create an account
Sign up at abigail.app using your email or Google account.
Authentication is handled by Clerk.
2. Generate an API key
- Log in at abigail.app
- Go to Settings > API Keys
- Click Create API Key and name it (e.g., “OpenClaw Agent”)
- Copy the key immediately — it is shown only once
Your key looks like: abi_sk_a1b2c3d4e5f6... (39 characters).
Store your API key securely. It cannot be retrieved after creation.
If lost, revoke the old key and create a new one.
3. Make your first call
Try a free endpoint first (no API key needed):
curl https://api.abigail.app/v1/openclaw/lookup/17200011
Then try a paid endpoint with your key:
curl -X POST https://api.abigail.app/v1/openclaw/analyze \
-H "X-API-Key: abi_sk_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"application_number": "17200011",
"office_action_text": "Claims 1-5 are rejected under 35 U.S.C. 102(a)(1)...",
"office_action_type": "CTNF"
}'
4. Full workflow
The typical agent workflow is:
- Lookup the application to get metadata and examiner name
- Analyze the office action text to get claim-by-claim analysis
- Draft ROA using the analysis_id and your strategy selections
- Poll the draft job until status is
complete
- Download the DOCX via the signed URL
5. Error handling
Every error response includes an agent_suggestion field with actionable guidance
for AI agents:
{
"error": true,
"error_code": "app_not_found",
"message": "Application 99999999 not found.",
"agent_suggestion": "Application not found. Verify the number format (17200011 or 17/200,011) and check for typos."
}
Your agent should read agent_suggestion and act on it automatically.