Get all categories for a specific project

GET 
/categories/:projectId

Get all categories for a specific project

Request

Path Parameters

projectId projectIdrequired

ID of the project to retrieve categories for

Query Parameters

categoryId categoryId

Optional ID of the category to treat as the root

Responses

200

Categories successfully retrieved

application/json

Schema

Schema

id categoryId (string)

Unique identifier for Category

name string

Category name

children

object[]

Array [

name string

Category name

children

id string

Category Id

]

Example (from schema)

{
  "id": "C16w81Bvr0",
  "name": "Fantasy animals",
  "children": [
    {
      "name": "Dragons",
      "children": {},
      "id": "CWZTp1wnm"
    }
  ]
}

Example

[
  {
    "name": "Fantasy animals",
    "children": [
      {
        "children": [
          {
            "children": [],
            "name": "Dragons",
            "id": "Cl1RfnQTy"
          }
        ],
        "name": "Magical Creatures",
        "id": "C17r3cW2m"
      },
      {
        "name": "Beasts of Burden",
        "children": [
          {
            "id": "C16naMbvS",
            "name": "Tal'Dorei",
            "children": []
          }
        ],
        "id": "CkIaWdWRL"
      }
    ],
    "id": "C16w81Bvr0"
  }
]

403

Forbidden

application/json

Schema

Schema

error string

Example (from schema)

{
  "error": "string"
}

Example

{
  "error": "Forbidden access"
}

404

NotFound

application/json

Schema

Schema

error string

Example (from schema)

{
  "error": "string"
}

Example

{
  "error": "A mandatory item was not found"
}

500

Internal Server Error

application/json

Schema

Schema

error string

Example (from schema)

{
  "error": "string"
}

Example

{
  "error": "Internal Server Error"
}

default

Unexpected error

application/json

Schema

Schema

error string

Example (from schema)

{
  "error": "string"
}

Example

{
  "error": "An unexpected error occured"
}

Loading...