API Reference
Start typing to search…
  1. Delivr Taxonomy API

Delivr Taxonomy API — Overview

Coming Soon

The Taxonomy API is currently in development and not yet available for public use. Please contact [email protected] for more information on availability.

What it is. A client-facing API to work with taxonomy entities. It lets you:

  • Retrieve categories and subcategories
  • Work with intent topics (list and details)
  • Create and manage topic requests (proposals for new intent topics)
  • View reviews for specific topics

Base and Format

  • Base URL: https://apiv2.delivr.ai/taxonomy
  • Data format: JSON
  • HTTP methods: GET, POST, PUT
  • Auth header (when required): X-Api-Key: dlvr_example

Key Resources

  • /categories - list categories
  • /categories/{id} - get category by ID
  • /categories/count - count by filters
  • /subcategories - list subcategories
  • /subcategories/{id} - get subcategory by ID
  • /subcategories/count - count
  • /topics - list intent topics
  • /topics/{id} - get topic by ID
  • /topics/count - count
  • /topic-requests - list/create topic requests
  • /topic-requests/{id} - read/update a specific request
  • /topic-requests/count - count
  • /topic-reviews/{topic_id} - get reviews/notes for a specific intent topic

Domain Notes (Statuses and Types)

Topic Requests - workflow statuses

  • accepted
  • rejected
  • waiting_for_approval

Topics - lifecycle statuses

  • active
  • inactive

Topic types

  • B2C
  • B2B
  • B2B2C

Use these values for filtering and for interpreting responses.