public

Create a taxonomy

Requires write. Returns 409 with the existing record if the slug is taken, so the caller can switch to using it instead of round-tripping to find out.

post/public/v1/directories/{directory}/taxonomies

Request

  • Base URL: https://api.epicdirectories.com
  • URL: https://api.epicdirectories.com/public/v1/directories/{directory}/taxonomies
  • Auth: API key in header x-api-key

Path parameters

directorystring required

Headers

Idempotency-Keystring

Optional. Send a unique key per logical operation to make retries safe. 1-256 characters, and only letters, digits, - and _ — colons and other separators are rejected with 400. A retry with the same key replays the original response (status + body) instead of re-executing. Cached for 24h. Reusing a key with a different request body returns 409 — note that a timestamp in the body (e.g. fetchedAt) turns an otherwise-stable key into a permanent 409, so either omit it (snapshots default it server-side) or fold a payload digest into the key. Skipped on 5xx responses (transient errors should be retried fresh).

x-api-keystring required

API Key for authentication

Request body

namestring required

Display name of the taxonomy

slugstring required

URL-friendly slug

structure'flat' | 'hierarchical'

Taxonomy structure type

Response

Taxonomy created

Changes

No recorded changes to this operation across all 1 revision of this API.