Projects API

Create, list, and manage projects in your Rorix workspace.

GET /api/projects

List all projects in your workspace.

curl https://rorix.io/api/projects \
  -H "Authorization: Bearer rxk_your_api_key_here"

Response

{
  "projects": [
    {
      "id": "proj_abc123",
      "name": "MyApp",
      "repository": "github.com/acme/myapp",
      "lastScan": "2025-12-01T10:30:00Z",
      "grade": "B",
      "score": 78
    }
  ]
}

POST /api/projects

Create a new project.

curl -X POST https://rorix.io/api/projects \
  -H "Authorization: Bearer rxk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "MyApp",
    "repository": "github.com/acme/myapp"
  }'

Response

{
  "id": "proj_abc123",
  "name": "MyApp",
  "repository": "github.com/acme/myapp",
  "createdAt": "2025-12-01T10:30:00Z"
}

GET /api/projects/:id

Get details for a specific project.

curl https://rorix.io/api/projects/proj_abc123 \
  -H "Authorization: Bearer rxk_your_api_key_here"

Response

{
  "id": "proj_abc123",
  "name": "MyApp",
  "repository": "github.com/acme/myapp",
  "lastScan": "2025-12-01T10:30:00Z",
  "grade": "B",
  "score": 78,
  "vulnerabilities": {
    "critical": 0,
    "high": 1,
    "medium": 3,
    "low": 2
  },
  "createdAt": "2025-01-15T08:00:00Z"
}

DELETE /api/projects/:id

Delete a project and all associated scan data.

curl -X DELETE https://rorix.io/api/projects/proj_abc123 \
  -H "Authorization: Bearer rxk_your_api_key_here"

Returns 204 No Content on success.

GET /api/projects/:id/scans

List all scans for a project, ordered by most recent first.

curl https://rorix.io/api/projects/proj_abc123/scans \
  -H "Authorization: Bearer rxk_your_api_key_here"

Response

{
  "scans": [
    {
      "id": "scan_xyz789",
      "createdAt": "2025-12-01T10:30:00Z",
      "grade": "B",
      "score": 78,
      "totalPackages": 45,
      "totalVulnerabilities": 6,
      "trigger": "webhook"
    },
    {
      "id": "scan_xyz788",
      "createdAt": "2025-11-28T14:15:00Z",
      "grade": "C",
      "score": 65,
      "totalPackages": 44,
      "totalVulnerabilities": 9,
      "trigger": "manual"
    }
  ]
}