# Permutive Taxonomy API

**Canonical:** https://apis.io/apis/permutive/permutive-taxonomy-api/  
**Provider:** Permutive — https://apis.io/providers/permutive/  
**Base URL:** https://api.permutive.com/ctx/v1  
**Documentation:** https://docs.permutive.com/api/contextual/introduction

Permutive Taxonomy API is one of 7 APIs that [Permutive](https://apis.io/providers/permutive/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Taxonomy. The published artifact set on APIs.io includes an OpenAPI specification.

Manage second-party data imports and their segment taxonomy.

## Operations (11)

| Method | Path | Summary |
|---|---|---|
| GET | `/imports` | Get all imports |
| GET | `/imports/{importId}` | Retrieve an import |
| GET | `/imports/{importId}/segments` | Get all segments for an import |
| POST | `/imports/{importId}/segments` | Create a segment |
| PATCH | `/imports/{importId}/segments` | Batch update segments |
| GET | `/imports/{importId}/segments/{segmentId}` | Get a segment by its public ID |
| PATCH | `/imports/{importId}/segments/{segmentId}` | Update a segment by its public ID |
| DELETE | `/imports/{importId}/segments/{segmentId}` | Delete a segment by its public ID |
| GET | `/imports/{importId}/segments/code/{segmentCode}` | Get a segment by its code |
| PATCH | `/imports/{importId}/segments/code/{segmentCode}` | Update a segment by its code |
| DELETE | `/imports/{importId}/segments/code/{segmentCode}` | Delete a segment by its code |

## Machine-readable artifacts (1)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/permutive/refs/heads/main/openapi/permutive-taxonomy-api-openapi.yml

## Other Permutive APIs (6)

- [Permutive Contextual API](https://apis.io/apis/permutive/permutive-contextual-api/)
- [Permutive MCP Server](https://apis.io/apis/permutive/permutive-mcp/)
- [Permutive Cohorts API](https://apis.io/apis/permutive/permutive-cohorts-api/)
- [Permutive Events API](https://apis.io/apis/permutive/permutive-events-api/)
- [Permutive Identity API](https://apis.io/apis/permutive/permutive-identity-api/)
- [Permutive Segmentation API](https://apis.io/apis/permutive/permutive-segmentation-api/)

## Tags

Taxonomy

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/permutive/permutive-taxonomy-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/permutive/.