curl --request POST \
  --url https://api.redbark.com/v2/categories/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Redbark-Version: <api-key>' \
  --data '
{
  "name": "<string>",
  "parent": "<string>",
  "icon": "<string>",
  "color": "<string>",
  "position": 1,
  "archived": true,
  "metadata": {}
}
'

const options = {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <token>',
    'Redbark-Version': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: '<string>',
    parent: '<string>',
    icon: '<string>',
    color: '<string>',
    position: 1,
    archived: true,
    metadata: {}
  })
};

fetch('https://api.redbark.com/v2/categories/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.redbark.com/v2/categories/{id}"

payload = {
    "name": "<string>",
    "parent": "<string>",
    "icon": "<string>",
    "color": "<string>",
    "position": 1,
    "archived": True,
    "metadata": {}
}
headers = {
    "Authorization": "Bearer <token>",
    "Redbark-Version": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "id": "cat_8Mn3Pq5rSt7uVw9xYz1aBc",
  "object": "category",
  "name": "<string>",
  "parent": "<string>",
  "icon": "<string>",
  "color": "<string>",
  "position": 123,
  "archived": true,
  "sources": [
    "<string>"
  ],
  "category_count": 123,
  "metadata": {},
  "livemode": true,
  "created": "2026-08-21T09:30:00.000Z",
  "updated": "2026-08-21T09:30:00.000Z"
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "request_id": "<string>"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "request_id": "<string>"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "request_id": "<string>"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "request_id": "<string>"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "request_id": "<string>"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "request_id": "<string>"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "request_id": "<string>"
  }
}