Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Widen Categories API

Manage asset categories and category trees.

Widen Categories API is one of 17 APIs that Widen publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Categories. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 6 operations across 6 paths, and defines 5 schemas. It is described by OpenAPI 3.0.3, at version 2.0.

Requests are made against 2 base URLs: https://api.widencollective.com/v2, https://api.widencollective.com/v1.

6 operations 6 paths 5 schemas 3 GET2 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
2.0
Base URL
https://api.widencollective.com/v2
Authentication
HTTP Bearer
License
Proprietary
Resource Areas
1

Authentication & Security 1

Widen Categories API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — OAuth2 Bearer token obtained from Acquia DAM.

Paths & Operations 6

Across 6 paths, the API surfaces 6 operations — 3 GET, 2 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Categories 6

Manage asset categories and category trees.

GET
/categories
List top-level asset categories
listAssetCategories → 200
GET
/categories/{categoryPath}
List child asset categories by path
listAssetCategoriesByPath 1 param → 200
POST
/category/assets
Add or remove assets from categories (v1)
updateCategoryAssets body → 204
POST
/category
Create a new category (v1)
createCategory body → 201
PUT
/category/uuid/{uuid}
Edit a category (v1)
editCategory 1 param body → 200
GET
/category/categoryTree
Get the full category tree (v1)
getCategoryTree 1 param → 200

Schemas 5

The contract defines 5 schemas that model the data the API accepts and returns. The most detailed are CategoryV2 (5 properties), CreateEditCategoryResult (4 properties), CategoryV1 (4 properties), ListCategoriesResult (3 properties). Each schema is shown below with its type and property counts.

CategoryV1
object
4 properties
CategoryV2
object
5 properties
CategoryTreeResult
object
2 properties
ListCategoriesResult
object
3 properties
CreateEditCategoryResult
object
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

widen-categories-api-openapi.yml Raw ↑

Other APIs Widen publishes across the network.

Widen Acquia-DAM-Webhooks API
Widen Analytics API
Widen Assets API
Widen Attributes API
Widen Channels API
Widen Collections API
Widen File-Formats API
Widen Integration-Links API
Widen Metadata API
Widen Orders API
Widen Products API
Widen Search-Connector API