get · projects:read

Retrieve a project

One project, including its plan and mention quota.

Read onlyIdempotent

REST

get/api/v1/projects/{id}
curl "https://herculeradar.com/api/v1/projects/:id" \
  --header "Authorization: Bearer hr_live_…"

MCP

Tool name get_project. It takes the same input and returns the same { data, meta } envelope as REST, because both call the same function.

One project: name, plan, quota and public-dashboard flags.

Parameters

idrequiredstringProject id

Response

{
  "data": {
    "id": "uuid",
    "name": "Acme",
    "plan": "starter",
    "mention_quota": 1000
  },
  "meta": {
    "capability": "get_project",
    "requestId": "req_9f2b4a8c1d0e",
    "idempotencyReplayed": false,
    "docs": "https://herculeradar.com/docs/reference/get_project"
  }
}

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.