get · projects:read
List projects
Returns every project the credential can reach. An API key is scoped to one project and always returns exactly that project.
Read onlyIdempotent
REST
get
/api/v1/projectscurl "https://herculradar.com/api/v1/projects" \ --header "Authorization: Bearer hr_live_…"
MCP
Tool name list_projects. It takes the same input and returns the same { data, meta } envelope as REST, because both call the same function.
List the projects this credential can reach. Start here when you do not know the project id.
Response
{
"data": {
"projects": [
{
"id": "uuid",
"name": "Acme",
"plan": "starter"
}
]
},
"meta": {
"capability": "list_projects",
"requestId": "req_9f2b4a8c1d0e",
"idempotencyReplayed": false,
"docs": "https://herculradar.com/docs/reference/list_projects"
}
}Authorization
Requires the projects:read scope. A credential without it gets 403 FORBIDDEN. Resources in projects the credential cannot reach answer 404 NOT_FOUND rather than 403, so ids cannot be probed across tenants.