/Docs
Search docs or ask a question⌘K
DocsAgent
Changelog
API Reference Get Ownership Summary

Get Ownership Summary

Ownership coverage, stale-page counts, unowned pages and the stale-alert settings.

GET/v1/projects/{projectId}/ownership/summaryTry it
Session token

How much of the project has an owner, how much of it has gone stale, which pages nobody owns, and the project's stale-alert settings — in one call.

Note

Any member of the workspace can call this, signed in with a session JWT — API keys are refused with 401. You must belong to the organization that owns {projectId}. Available on every plan.

Path Parameters

NameDescription
projectId:stringpathRequired
The project ID.

Response — 200 OK

A project with no pages returns zeros and an empty unownedPages — never a 404.

Response Fields

NameDescription
total:integer
Every page the project knows about: pages recorded by builds and content-health checks, plus owned pages those have not seen.
owned:integer
Pages with an owner. unowned is the rest.
stale:integer
Owned pages whose last change is older than alerts.staleAfterDays. Pages with no known change are not counted.
medianAgeDays:integer
Median days since the last change, over the pages with a known change. 0 when there are none.
medianAgeDeltaDays:null
Always null for now — no history is kept to compare against.
unownedPages:array
Unowned pages, longest-unchanged first (pages with no known change last), at most 50. Each is { pagePath, lastChangedAt }, with lastChangedAt null when unknown.
alerts:object
The stale-alert settings, defaults filled in. Change them with Update Ownership Settings.

Paths are matched loosely: /getting-started, getting-started.mdx and getting-started/index.mdx count as the same page.

Error Responses

401 Unauthorized

No session JWT, an expired one, or an API key.

403 Forbidden

forbidden — you are not a member of the organization that owns the project.

404 Not Found

not_found — the project does not exist or was deleted.

Was this page helpful? Yes No
Request
cURLJavaScriptPythonGoRubyPHPJavaC#cURL
curl https://api.syntext.dev/v1/projects/3f2a9c1e-8b4d-4e7a-9c21-5d6e7f8a9b0c/ownership/summary \
-H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."
Responseapplication/json
200OK
{
"data": {
"owned": 38,
"total": 52,
"stale": 6,
"unowned": 14,
"medianAgeDays": 41,
"medianAgeDeltaDays": null,
"unownedPages": [
{ "pagePath": "guides/legacy-auth.mdx", "lastChangedAt": "2025-12-03T08:21:00.000Z" },
{ "pagePath": "reference/limits.mdx", "lastChangedAt": "2026-06-19T14:02:00.000Z" }
],
"alerts": {
"staleAfterDays": 90,
"emailWeekly": false,
"slackChannel": null,
"postToSlack": false
}
}
}
Product
Resources
Company
© 2026 SyntextBuilt with Syntext