Update a section

PUT 
https://api.staging.powerapi.com/api/v2/catalog/sections/:section_id

Update a section by its id

Request

Path Parameters

section_id stringrequired
Possible values: >= 12 characters and <= 12 characters, Value must match regular expression ^[0-9a-z]+$
Unique ID of the section
Example: u7m4f8ep5nfi

application/json

Body

required

name string

Possible values: non-empty

Name of the section

order integer

Default value: 0

Used to order the item, order defaults to ascending.

category_id string

Category ID of the section

Responses

200

application/json

Schema

Schema

id stringrequired

Possible values: >= 12 characters and <= 12 characters, Value must match regular expression ^[0-9a-z]+$

Unique ID of the section

name stringrequired

Possible values: non-empty

Name of the section

slug stringrequired

Possible values: non-empty

Slug of the section

order integerrequired

Default value: 0

Used to order the item, order defaults to ascending.

created_at date-timerequired
updated_at date-timerequired

Example (from schema)

{
  "id": "u7m4f8ep5nfi",
  "name": "Pizza",
  "slug": "pizza",
  "order": 1,
  "created_at": "2024-07-29T15:51:28.071Z",
  "updated_at": "2024-07-29T15:51:28.071Z"
}

400

application/json

Schema

Schema

statusCode integerrequired

HTTP status code

message string

Error message

error string

Error name

Example (from schema)

{
  "statusCode": 404,
  "message": "Cannot find item",
  "error": "Not Found"
}

401

application/json

Schema

Schema

statusCode integerrequired

HTTP status code

message string

Error message

error string

Error name

Example (from schema)

{
  "statusCode": 404,
  "message": "Cannot find item",
  "error": "Not Found"
}

403

application/json

Schema

Schema

statusCode integerrequired

HTTP status code

message string

Error message

error string

Error name

Example (from schema)

{
  "statusCode": 404,
  "message": "Cannot find item",
  "error": "Not Found"
}

404

application/json

Schema

Schema

statusCode integerrequired

HTTP status code

message string

Error message

error string

Error name

Example (from schema)

{
  "statusCode": 404,
  "message": "Cannot find item",
  "error": "Not Found"
}

422

application/json

Schema

Schema

statusCode integerrequired

HTTP status code

message string

Error message

location stringrequired

Possible values: [query, body, response, param]

Where in the request the error occurred

errors

object[]

required

Array [

path stringrequired

Possible values: non-empty

Path to the property with the error

constraints

object

required

property name* string

Error message

]

Example (from schema)

{
  "statusCode": 404,
  "message": "Cannot find item",
  "location": "query",
  "errors": [
    {
      "path": "business.id",
      "constraints": {
        "object_required_property": "Required property"
      }
    }
  ]
}

500

application/json

Schema

Schema

statusCode integerrequired

HTTP status code

message string

Error message

error string

Error name

Example (from schema)

{
  "statusCode": 404,
  "message": "Cannot find item",
  "error": "Not Found"
}

• curl
• python
• go
• nodejs
• ruby
• java
• powershell

• CURL

curl -L -X PUT 'https://api.staging.powerapi.com/api/v2/catalog/sections/:section_id' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
-d '{
  "name": "Pizza",
  "order": 1,
  "category_id": "5m4v972ra9ue"
}'

Request Collapse all

Base URL

https://api.staging.powerapi.com

Auth

Security Scheme

beareroauth2

Bearer Token

Parameters

section_id — pathrequired

Body required

{
  "name": "Pizza",
  "order": 1,
  "category_id": "5m4v972ra9ue"
}

ResponseClear

Click the Send API Request button above and see the response here!