{"document_type":"rest-capability-catalog","name":"Keeper Agent API","description":"AI agent API for managing dating profiles, preferences, photo tests, and questionnaires on the Keeper matchmaking platform.","documentation_url":"https://app.keeper.ai/agent-api","provider":{"name":"Keeper Dating","url":"https://app.keeper.ai"},"api":{"discovery_url":"https://app.keeper.ai/.well-known/agent-configuration","openapi_url":"https://app.keeper.ai/agent-api/openapi.json","authentication":{"type":"bearer","description":"Use a Keeper Agent API key (prefix: keeper_) as a Bearer token. Keys can be generated in Keeper Settings > Connected Agents (rolling out behind a feature flag), or via the browser OAuth PKCE flow. If Connected Agents is not visible yet: local agents can use the OAuth flow; remote/cloud agents must wait for the rollout (the flow requires a loopback redirect on the user's machine)."}},"operations_note":"Non-exhaustive summary of common operations. The OpenAPI document (api.openapi_url) is the canonical, complete inventory — preference items, photo cancel/end, module detail, and the eight lookup endpoints, among others, appear only there.","operations":[{"name":"read_profile","description":"Read the user's dating profile","endpoint":"GET /v1/agent/profile","scope":"manage_profile"},{"name":"update_profile","description":"Update the user's dating profile","endpoint":"PATCH /v1/agent/profile","scope":"manage_profile"},{"name":"read_preferences","description":"Read the user's dating preferences and filters","endpoint":"GET /v1/agent/preferences","scope":"manage_profile"},{"name":"update_preferences","description":"Update the user's dating preferences","endpoint":"PATCH /v1/agent/preferences","scope":"manage_profile"},{"name":"rerank_preference","description":"Change the priority ranking of a single preference","endpoint":"PUT /v1/agent/preferences/:id/rerank","scope":"manage_profile"},{"name":"batch_rerank_preferences","description":"Rerank multiple preferences in a single request","endpoint":"POST /v1/agent/preferences/rerank","scope":"manage_profile"},{"name":"get_status","description":"Get profile completion status and onboarding progress","endpoint":"GET /v1/agent/status","scope":"manage_profile"},{"name":"get_photo_credits","description":"Get the user's photo test credit balance","endpoint":"GET /v1/agent/photos/credits","scope":"manage_profile"},{"name":"list_photo_tests","description":"List photo tests the user has created","endpoint":"GET /v1/agent/photos/tests","scope":"manage_profile"},{"name":"create_photo_test","description":"Create a new photo test","endpoint":"POST /v1/agent/photos/test","scope":"manage_profile"},{"name":"get_pool_stats","description":"Get dating pool statistics for the user","endpoint":"GET /v1/agent/pool/stats","scope":"manage_profile"},{"name":"list_questionnaire_modules","description":"List all available questionnaire modules","endpoint":"GET /v1/agent/modules","scope":"manage_profile"},{"name":"get_module_answers","description":"Get the user's answers for a questionnaire module","endpoint":"GET /v1/agent/modules/:id/answers","scope":"manage_profile"},{"name":"update_module_answers","description":"Update answers for a questionnaire module","endpoint":"PATCH /v1/agent/modules/:id/answers","scope":"manage_profile"}]}