As a machine, the REST API should provide an endpoint for CRUD operations on the Test Repository

// Folder create in root: POST /rest/raven/1.0/api/testrepository/FP/folders
{
  "name": "Folder1"
}

// returns self:
{
  "id": 6,
  "rank": 1,
  "name": "Folder1",
  "testRepositoryPath": "/Folder1"
  "testCount": 0,
  "totalTestCount": 0
}

// Folder create within folder: POST /rest/raven/1.0/api/testrepository/FP/folders/6
{
  "name": "Folder1"
}

// returns self:
{
  "id": 6,
  "rank": 1,
  "name": "Folder1",
  "testRepositoryPath": "/Folder1"
  "testCount": 0,
  "totalTestCount": 0
}

// Folder Get info: GET /rest/raven/1.0/api/testrepository/FP/folders/6
{
  "id": 6,
  "rank": 1,
  "name": "Folder1",
  "testRepositoryPath": "/Folder1"
  "testCount": 0,
  "totalTestCount": 0
}

// Folder delete: DELETE /rest/raven/1.0/api/testrepository/FP/folders/6
HTTP 200 ok (status code standard) ou HTTP 204 (without content)

// Folder update/rename: PUT /rest/raven/1.0/api/testrepository/FP/folders/6
// "name" and "rank" can be used together or individually
{
"name": "Folder1",
"rank": 4
}

// add/remove tests to a folder: PATCH /rest/raven/1.0/api/testrepository/FP/folders/9/tests
{
 "add": [
    "CALC-33",
    "CALC-75"
  ],
  "remove": [
    "CALC-25",
    "CALC-45"
  ]
}