{"name":"Fikra API agent-assisted accounts","version":1,"summary":"Agents can create a provisional account for a human, use the API with a 6-hour delegated token, and top it up. The human claim link converts it to a full account. No signup credit.","account":{"endpoint":"POST /v1/agents/accounts","body":{"email":"human@example.com","agent_name":"your-agent","agent_version":"1.0","idempotency_key":"optional"},"returns":["account_id","token","token_expires_at","claim_url"],"provisional_hours":6,"signup_credit":0},"auth":{"header":"Authorization: Bearer <agent token>","token_hours":6,"scopes":["keys:read","keys:write","chat:write","usage:read","balance:read","topup:link","topup:charge"]},"endpoints":["GET /v1/agents/me","POST /v1/agents/token/refresh","POST /v1/agents/keys","GET /v1/agents/keys","POST /v1/agents/keys/{id}/revoke","GET /v1/agents/balance","GET /v1/agents/usage","POST /v1/agents/topup","GET /v1/agents/topup/{reference}"],"payments":{"checkout":"POST /v1/agents/topup {amount_usd} returns a Paystack checkout URL. The human pays in the browser.","auto_charge":"POST /v1/agents/topup {amount_usd: 20, auto: true} charges a saved card up to $100 per day after the human claims the account and saves a card.","auto_recharge":"Not available to agents.","card_data":"Never seen by the agent or stored by Fikra."},"claim":{"url":"https://fikraapi.co.ke/agents/claim/<token>","ttl_days":30},"docs":"https://fikraapi.co.ke/for-agents","contact":"developers@fikraapi.co.ke"}