# GET /api/v1/apps/activity

> Read Installatron activity and running tasks

- Group: applications
- Tier: R
- Required scope: read:hosting
- Docs: https://api.inleed.com/reference/applications/get-app-activity

## Description

Returns `tasks[]` (running/queued/recent work with `percent` progress — poll this after an async install or import) and `activity[]` (recent log rows: `cmd`, `severity`, app, version, url, time + ISO-8601 `at`), newest first. A domain `input` narrows both to that domain; a username or service id shows the whole account. Filter with `install` (an app id from `list_apps`), `severity`, `days` (default 90) and `limit` (default 30). For web/error logs use `read_logs` instead.

## Query parameters

- `input` — string (required). A domain, email address, website URL, or Inleed service id — for example example.se, info@example.se or 42976. Resolved to the owning account automatically, and the resolved target is echoed back in the response.
- `install` — string. Optional: only rows for this install — an app id from list_apps.
- `severity` — enum. Optional: only rows of this severity. notice = completed work, error = failures. One of notice, info, error.
- `days` — integer. How far back to look, 1-365 (default 90).
- `limit` — integer. Page size for a collection. Range 1–100.

## Request

```bash
curl -X GET "https://mcp.inleed.com/api/v1/apps/activity?input=example.se&install=example.se&severity=notice&days=3&limit=3" \
  -H "Authorization: Bearer inl_live_…"
```

## Errors

- **400**  — codes: invalid_request
- **401** No token was presented, or the token is revoked, expired or unknown. — codes: unauthorized, token_expired, token_revoked
- **403** The token lacks a required scope, or this account does not own the resource. — codes: insufficient_scope, domain_not_owned
- **404** No such resource for this account. — codes: not_found
- **422** Validation error — codes: validation_failed
- **429** The rate limit for this token is exhausted. See `Retry-After`. — codes: rate_limited
- **500** Something went wrong on our side. The failure is logged against `requestId`. — codes: internal_error

## Related

- GET /api/v1/apps — https://api.inleed.com/reference/applications/list-apps
- POST /api/v1/apps — https://api.inleed.com/reference/applications/manage-app
- PATCH /api/v1/apps — https://api.inleed.com/reference/applications/update-app
- DELETE /api/v1/apps — https://api.inleed.com/reference/applications/delete-app