Documentation
/installs
Query app installations. Check who has your app installed, or use @me to verify your own installation status.
Quick Start: Check Your Installation
Use @me to verify you have an app installed on your own ring. Useful before using @me with /vibes/trigger.
- "Do I have this app installed?" →
GET /apps/:app_id/installs/@me - "Check my installation" →
GET /apps/:app_id/installs/@me
Quick Links
GET
/v1/apps/:app_id/installs
List all installations for an app
GET
/v1/apps/:app_id/installs/@me
Get your own installation
GET
/v1/apps/:app_id/installs
List all users who have this app installed. Only works for apps you own.
Request
cURL
curl -X GET "https://developer.arkh.com/api/apps/app_01234567/installs" \
-H "Authorization: Bearer arkh_your_api_key_here"Response
{
"installs": [
{
"user_app_id": "550e8400-e29b-41d4-a716-446655440000",
"is_active": true,
"installed_at": "2024-01-15T14:30:00Z"
}
]
}GET
/v1/apps/:app_id/installs/@me
Check if you (the API key owner) have this app installed. Useful for verifying @me will work with /vibes/trigger.
Request
cURL
curl -X GET "https://developer.arkh.com/api/apps/app_01234567/installs/@me" \
-H "Authorization: Bearer arkh_your_api_key_here"Response
{
"user_app_id": "550e8400-e29b-41d4-a716-446655440000",
"app_id": "app_01234567",
"is_active": true,
"installed_at": "2024-01-15T14:30:00Z"
}Error Responses
400
Your API key is not linked to an ARKH user account (when using
@me)404
App not found, not owned by you, or you don't have it installed (for
@me)