/api/v2/shared-hosting/{accountId}/diagnostics/files Inspect eligible website code and configuration using the existing account-scoped cPanel Fileman API.
Source reads are limited to 1 MiB; large-log tails use the existing FTPS path.
Config files return selected non-secret static settings.
Private data, backups, keys, binary files and symbolic links are excluded by diagnostic policy.
No commands or application code execute.
Search is literal and bounded to 40 file reads, 2 MiB and 1000 entries; truncated results cannot prove absence.
Paths are relative to the verified website root.
read:hostingconsole:services
Authenticate with an API key in the Authorization: Bearer <token> header.
accountId string required
Example: acct_01hxa3b4c5d6e7f8g9h0j1k2m3 Public shared-hosting account ID. Get it from GET /api/v2/shared-hosting data[].id. Do not invent this value; use the exact ID returned by the referenced API response.
domain string Exact hosted domain. Defaults to the account main domain.
action string · enum required What to do with path: list a directory (paged with offset), read one file (source lines, a config's settings, or a log tail), or search the tree for query.
list read search path string · default: Site-relative directory/file; empty string is the website root.
query string Required for search only; literal substring, not regex.
startLine integer · min: 1 · max: 100000 · default: 1 First source line for read; cannot combine with tail.
lines integer · min: 1 · max: 200 · default: 100 read only: how many lines to return, counted from startLine or, with tail, from the end of the log. Each line is cut at 2000 characters.
tail boolean · default: false For log reads only: return the end of the file.
offset integer · min: 0 · max: 100000 · default: 0 List only: use nextOffset to read the next directory page. scanLimited indicates the overall scan cap was reached.
Authorization Bearer <token> Accept application/json domain string required view string · enum settings source log_tail entries array<object> entries[].name string entries[].type string · enum file directory entries[].sizeBytes integer entries[].view string · enum settings source settings object lines array<object> lines[].line integer · nullable required One-based source line; null for log tails/settings.
lines[].text string required matches array<object> matches[].path string matches[].line integer · nullable One-based source line; null for log tails/settings.
matches[].text string sizeBytes integer inspectedEntries integer truncated boolean notice string nextOffset integer · nullable scanLimited boolean filesRead integer No response body
No response body
No response body
No response body
No response body
Retry-After seconds plus X-RateLimit-* headers. 10 fields type string
· Example: https://developer.hostup.se/errors/invalid_request title string
· Example: Validation failed status integer
· Example: 400 detail string
· Example: The request body failed validation. code string
· Example: invalid_request Stable machine-readable code. Branch on this field, not on detail.
instance string
· Example: /api/v2/orders requestId string
· Example: req_01hxa3b4c5d6e7f8g9h0j1k2m3 timestamp string
· Example: 2026-04-27T12:34:56.000Z errors array<object> Field-level validation errors when code is invalid_request.
errors[].pointer string required
· Example: /items/0/eppCode errors[].detail string required
· Example: `eppCode` is required for this transfer. errors[].code string required
· Example: missing_required extensions object type string
· Example: https://developer.hostup.se/errors/invalid_request title string
· Example: Validation failed status integer
· Example: 400 detail string
· Example: The request body failed validation. code string
· Example: invalid_request Stable machine-readable code. Branch on this field, not on detail.
instance string
· Example: /api/v2/orders requestId string
· Example: req_01hxa3b4c5d6e7f8g9h0j1k2m3 timestamp string
· Example: 2026-04-27T12:34:56.000Z errors array<object> Field-level validation errors when code is invalid_request.
errors[].pointer string required
· Example: /items/0/eppCode errors[].detail string required
· Example: `eppCode` is required for this transfer. errors[].code string required
· Example: missing_required extensions object No response body
https://cloud.hostup.se/api/v2/shared-hosting/{accountId}/diagnostics/files curl -X GET "https://cloud.hostup.se/api/v2/shared-hosting/acct_01hxa3b4c5d6e7f8g9h0j1k2m3/diagnostics/files?action=list" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json"{
"domain": "shop.example.com",
"view": "settings",
"settings": {
"ps_caching": "CacheMemcached",
"ps_cache_enable": false
},
"sizeBytes": 1005,
"notice": "Only recognized non-secret static settings; omitted values are unknown."
}