Retrieves a list of all non-archived projects accessible to your API key.
GET /api/v1/machine/project| Header | Type | Required | Description |
|---|---|---|---|
X-API-Key | string | Yes | Your API key |
Success (200 OK)
{
"projects": [
{
"id": "507f1f77bcf86cd799439014",
"name": "Production Infrastructure",
"externalId": "PROJ-001",
"description": "Contains all production environment resources",
"vaultsCount": 5,
"licensesCount": 12,
"licenseGroupsCount": 3,
"archivedAt": null
},
{
"id": "507f1f77bcf86cd799439015",
"name": "Development Environment",
"externalId": "PROJ-002",
"description": "Development and testing resources",
"vaultsCount": 2,
"licensesCount": 4,
"licenseGroupsCount": 1,
"archivedAt": null
}
]
}| Field | Type | Description |
|---|---|---|
projects | array | Array of project objects |
projects[].id | string | The unique identifier of the project |
projects[].name | string | The name of the project |
projects[].externalId | string | null | Optional external identifier for integration |
projects[].description | string | null | A description of the project |
projects[].vaultsCount | number | Number of vaults associated with the project |
projects[].licensesCount | number | Number of licenses (internal + manual) associated |
projects[].licenseGroupsCount | number | Number of license groups associated |
projects[].archivedAt | string | null | ISO 8601 timestamp when archived (null if active) |
401 Unauthorized - Invalid or missing API key
{
"error": {
"code": "unauthorized",
"message": "Invalid or missing API key. Please provide your API key in the X-API-Key header."
}
}curl -X GET "https://r4.dev/api/v1/machine/project" \
-H "X-API-Key: rk_abc123def456.ghijklmnopqrstuvwxyz1234567890abcdef"