Skip to main content
A second-party taxonomy provides a mapping of segment codes to human-readable names and metadata (e.g. descriptions) for use in building Permutive cohorts. The Taxonomy API allows for the programmatic creation, mutation, and deletion of second-party taxonomies for imported data in your workspace.

​
Authentication

It’s important to note that all requests to the Taxonomy API must be authenticated with a private API key. See the Authentication documentation for details on obtaining and using a private API key.

​
Endpoints

The Taxonomy API provides 11 endpoints:

Get all imports

Get all imports for a workspace.

Retrieve an import

Retrieve a specific import by its import ID.

Get all segments for an import

Get all segments for a given import.

Get a segment by its ID

Get a segments for an import by its public import ID.

Get a segment by its code

Get a segment for an import by its code.

Create a segment

Create a segment for an import.

Update a segment by its public ID

Update a segment for an import by its public import ID.

Update a segment by its code

Update a segment for an import by its code.

Batch update segments

Batch update segments for an import.

Delete a segment by its public ID

Delete a segment for an import by its public import ID.

Delete a segment by its code

Delete a segment for an import by its code.