Edit Category

Description: Updates an existing category’s details, identified by its ID (e.g., 97). Uses a POST method with _method=PUT to simulate a PUT request, allowing updates to status, alias, image, and descriptions. Requires authentication headers and userToken. Update details of an existing category by its ID.

Headers

Key	Value	Description	Type
`apikey`	`5f28583f26a1a`	API key for authentication; contact support to obtain. `Required`	`string`
`apiconnection`	`appmobile`	Connection type; contact support to obtain. `Required`	`string`
`secure-business-key`	`4765066450c0bd66325.48403130`	Business-specific key; contact support for valid values. `Required`	`string`
`userToken`	`09119b2691afaa567bc1d46c829ebd41193c8545191146cc5df791681a792ad9`	User token from authentication API. `Required` (Get user token from `https://testaccounts.vodoerp.com/api/login` or `https://accounts.vodoerp.com/api/login`)	`string`

Body or Form Data

Key	Value	Description	Type
`_method`	`PUT`	Simulates PUT method for update. `Required`	`string`
`status`	`1`	Category status (1 or 0).	`string`
`top`	`0`	Top category (1 or 0).	`string`
`alias`	`454722tssvsvdfg`	Category alias.	`string`
`sort`	`10`	Sorting order.	`string`
`image`	`http://127.0.0.1:8000/data/37/lfm/code 2.png`	Category image URL.	`string`
`parent`	(empty)	Parent category ID. (Get from api request `{{APP_URL}}/api/v1/ecomm_categories`)	`string`
`descriptions[0][lang]`	`en`	Language for first description.	`string`
`descriptions[0][keyword]`	`keyword_en`	Keyword for first description. Optional	`string`
`descriptions[0][title]`	`Category Name ENvsvdfg`	Title for first description. Optional	`string`
`descriptions[0][description]`	`Category Description EN`	Description for first description. Optional	`string`
`descriptions[1][lang]`	`ar`	Language for second description.	`string`
`descriptions[1][keyword]`	`keyword_ar`	Keyword for second description. Optional	`string`
`descriptions[1][title]`	`Category Name ARsvsvdfg`	Title for second description. Optional	`string`
`descriptions[1][description]`	`Category Description AR`	Description for second description. Optional	`string`

Response

Upon successful execution, the endpoint returns a status of true and an optional message in the JSON format.

Example:

{
    "status": true,
    "message": ""
}

curl --location -g --request POST 'https://www.testecommerce.vodoerp.com/{{categories}}/97' \ --header 'apikey: 5f28583f26a1a' \ --header 'apiconnection: appmobile' \ --header 'secure-business-key: 4765066450c0bd66325.48403130' \ --header 'userToken: 09119b2691afaa567bc1d46c829ebd41193c8545191146cc5df791681a792ad9' \ --form '_method="PUT"' \ --form 'status="1"' \ --form 'top="0"' \ --form 'alias="454722tssvsvdfg"' \ --form 'sort="10"' \ --form 'image="http://127.0.0.1:8000/data/37/lfm/code 2.png"' \ --form 'parent=""' \ --form 'descriptions[0][lang]="en"' \ --form 'descriptions[0][keyword]="keyword_en"' \ --form 'descriptions[0][title]="Category Name ENvsvdfg"' \ --form 'descriptions[0][description]="Category Description EN"' \ --form 'descriptions[1][lang]="ar"' \ --form 'descriptions[1][keyword]="keyword_ar"' \ --form 'descriptions[1][title]="Category Name ARsvsvdfg"' \ --form 'descriptions[1][description]="Category Description AR"'

{"status":true,"message":"Category updated successfully","data":{"id":97,"business_id":259,"image":"http://127.0.0.1:8000/data/37/categories/categories_images/671f9ac6b0a1a_code%202.png","alias":"454722tssvsvdfg","parent":65,"top":"0","status":"1","sort":"10","attr_id":null,"parent_type":"Custom","standard_category_id":null,"descriptions":[{"category_id":97,"lang":"ar","title":"Category Name ARsvsvdfg","keyword":"keyword_ar","description":"Category Description AR"},{"category_id":97,"lang":"en","title":"Category Name ENvsvdfg","keyword":"keyword_en","description":"Category Description EN"}],"parent_object":{"id":65,"business_id":37,"image":"http://127.0.0.1:8000/data/37/categories/categories_images/66fe873ca02a2_code%202.png","alias":"454722ts","parent":2,"top":1,"status":0,"sort":10,"attr_id":"","parent_type":"Custom","standard_category_id":null}}}

Request

Header Params

apikey

string

required

You must contact support to get the apikey.

Example:

5f28583f26a1a

apiconnection

string

required

You must contact support to get the apiconnection.

Example:

appmobile

secure-business-key

string

required

You must contact support to get the secure-business-key like: 4765066450c0bd66325.48403130
728106399db2b289783.89154521
2680667168f2f8a68f6.12561200
140356399db2b2c32f0.25237063
96701678e330f31f768.22400604
14807664478836358b0.31329842

Example:

4765066450c0bd66325.48403130

userToken

string

required

Get user token from
https://testaccounts.vodoerp.com/api/login
or
https://accounts.vodoerp.com/api/login

Example:

09119b2691afaa567bc1d46c829ebd41193c8545191146cc5df791681a792ad9

Body Params multipart/form-data

_method

string

required

Example:

PUT

status

string

required

1 or 0

Example:

top

string

required

1 or 0

Example:

alias

string

required

Example:

454722tssvsvdfg

sort

string

required

Example:

image

string

required

Example:

http://127.0.0.1:8000/data/37/lfm/code 2.png

parent

string

required

descriptions[0][lang]

string

required

Example:

descriptions[0][keyword]

string

required

Example:

keyword_en

descriptions[0][title]

string

required

Example:

Category Name ENvsvdfg

descriptions[0][description]

string

required

Example:

Category Description EN

descriptions[1][lang]

string

required

Example:

descriptions[1][keyword]

string

required

Example:

keyword_ar

descriptions[1][title]

string

required

Example:

Category Name ARsvsvdfg

descriptions[1][description]

string

required

Example:

Category Description AR

Response#

Request

Responses

Response