This document is generated by Aladia.

Update a Category

Testing

PATCH

/categories/{id}

This endpoint updates a category or subcategory.

Returns:

Updated category

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH 'https://api.aladia.io/v2/categories/' \
--header 'apikey: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "parentId": "c5d65a582a72e54a6dee0bd3",
    "name": "Programming",
    "image": {
        "fileName": "test.png",
        "metadata": {
            "fileSize": 31809,
            "fileType": "image/png",
            "originalName": "test.png"
        }
    },
    "proposedUserId": "e5bd7fe83f2c0a674ca5b67e",
    "status": "active"
}'

Response Example

200 - Success

{
    "id": "d22fc1feb9dcf1bdbc63d9d8",
    "parentId": "d8123706d1e386abde59de8a",
    "name": "Programming",
    "image": {
        "url": "https://loremflickr.com/640/480",
        "metadata": {
            "size": 1000,
            "mimetype": "image/png",
            "name": "test.png"
        },
        "fileId": "6683e28c1f74eef6fe9f0322"
    },
    "proposedUserId": "feb9a8b0dec5edef1d8da15f",
    "status": "active"
}

Request

Path Params

Header Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Body

🟠401Unauthorized

🟠403Forbidden

🟠422Parameter Error

🟠404Record Not Found

Modified at 2025-04-08 11:03:00

Create a Category

Retrieve a Category