# Categories

# Get Categories List

Retrieve a list of all blog/news categories.

  • URL: blogs/categories/
  • Method: GET
  • Response Example:
    [
      {
        "unique_id": "123",
        "name": "Tech",
        "description": "Technology related blogs and news",
        "date_created": "2021-01-01T00:00:00Z",
        "last_updated": "2021-01-01T00:00:00Z"
      },
      ...
    ]
    

# Get a Category

Retrieve details of a specific blog/news category by unique ID.

  • URL: blogs/categories/<str:unique_id>/
  • Method: GET
  • Response Example:
    {
      "unique_id": "123",
      "name": "Tech",
      "description": "Technology related blogs and news",
      "date_created": "2021-01-01T00:00:00Z",
      "last_updated": "2021-01-01T00:00:00Z"
    }
    

# Create a Category

Create a new blog/news category.

  • URL: blogs/categories/
  • Method: POST
  • Request Example:
    {
      "name": "Tech",
      "description": "Technology related blogs and news"
    }
    
  • Response Example:
    {
      "unique_id": "123",
      "name": "Tech",
      "description": "Technology related blogs and news",
      "date_created": "2021-01-01T00:00:00Z",
      "last_updated": "2021-01-01T00:00:00Z"
    }
    

# Update a Category

Update an existing blog/news category by unique ID.

  • URL: blogs/categories/<str:unique_id>/
  • Method: PUT
  • Request Example:
    {
      "name": "Tech",
      "description": "Updated description"
    }
    
  • Response Example:
    {
      "unique_id": "123",
      "name": "Tech",
      "description": "Updated description",
      "date_created": "2021-01-01T00:00:00Z",
      "last_updated": "2021-01-02T00:00:00Z"
    }
    

# Delete a Category

Delete a blog/news category by unique ID.

  • URL: blogs/categories/<str:unique_id>/
  • Method: DELETE
  • Response: 204 No Content