Projects
List projects#
GET
/v1/projectsAPI keyprojectsEvery project in the key's scope, with resource counts. Projects outside scope are silently omitted — an empty match is 200 with an empty list, never an error.
❯terminal
curl https://www.envpilot.dev/api/v1/projects \
-H "Authorization: Bearer envpk_..."❯json
{
"projects": [
{
"id": "proj_1",
"name": "Backend",
"slug": "backend",
"variableCount": 42,
"accountCount": 3
}
]
}Get one project#
GET
/v1/projects/{slug}API keyprojects❯terminal
curl https://www.envpilot.dev/api/v1/projects/backend \
-H "Authorization: Bearer envpk_..."A slug that does not exist and a slug outside the key's scope both return 404. That is deliberate: a key must not be able to confirm the existence of a project it cannot read.
Limits#
- Requires the
projectsresource. - Metadata bucket: 120 requests/min per key.
- Counts are of active resources; trashed items are not included.
- No pagination — see bounded reads.