# Infinite Audience Segments API

**Canonical:** https://apis.io/apis/infiniteaudience-ai/infiniteaudience-ai-segments-api/  
**Provider:** Infinite Audience — https://apis.io/providers/infiniteaudience-ai/  
**Base URL:** https://api.infiniteaudience.ai  
**Documentation:** https://docs.infiniteaudience.ai/api/

Infinite Audience Segments API is one of 18 APIs that [Infinite Audience](https://apis.io/providers/infiniteaudience-ai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Segments. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 6 JSON Schemas.

Save and manage reusable filter definitions

## Operations (17)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/segments` | Create a segment |
| GET | `/v1/segments` | List segments for the caller's org |
| GET | `/v1/segments/{id}` | Get a segment by ID |
| PATCH | `/v1/segments/{id}` | Partially update a segment |
| DELETE | `/v1/segments/{id}` | Permanently remove a segment |
| POST | `/v1/segments/{id}/count` | Recount a segment |
| GET | `/v1/segments/{id}/demographics` | Get demographic breakdown for a segment |
| GET | `/v1/segments/{id}/audiences` | List audiences referencing a segment |
| POST | `/v1/segments/{id}/duplicate` | Duplicate a segment with lineage tracking |
| PATCH | `/v1/segments/bulk` | Bulk update segments |
| DELETE | `/v1/segments/bulk` | Bulk archive segments |
| DELETE | `/v1/segments/bulk-delete` | Bulk hard-delete segments |
| POST | `/v1/segments/{id}/refresh` | Refresh a segment against the latest data |
| POST | `/v1/segments/{id}/mappings` | Confirm column mapping overrides for a matched segment |
| POST | `/v1/segments/{id}/mappings/cancel` | Abort a staged (hitl:true) matched-segment upload without confirming |
| POST | `/v1/segments/{id}/upload-failed` | Report that a matched segment's client-side re-upload failed |
| POST | `/v1/segments/bulk-create` | Bulk create segments |

## Machine-readable artifacts (8)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/infiniteaudience-ai/refs/heads/main/openapi/infiniteaudience-ai-segments-api-openapi.yml
- **Documentation** — https://docs.infiniteaudience.ai/
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/infiniteaudience-ai/refs/heads/main/json-schema/infiniteaudience-ai-segment-object-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/infiniteaudience-ai/refs/heads/main/json-schema/infiniteaudience-ai-audience-object-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/infiniteaudience-ai/refs/heads/main/json-schema/infiniteaudience-ai-delivery-object-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/infiniteaudience-ai/refs/heads/main/json-schema/infiniteaudience-ai-file-match-job-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/infiniteaudience-ai/refs/heads/main/json-schema/infiniteaudience-ai-audience-refresh-result-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/infiniteaudience-ai/refs/heads/main/json-schema/infiniteaudience-ai-campaign-schema.json

## Other Infinite Audience APIs (12)

- [Infinite Audience MCP Server](https://apis.io/apis/infiniteaudience-ai/infinite-audience-mcp/)
- [Infinite Audience A2A API](https://apis.io/apis/infiniteaudience-ai/infiniteaudience-ai-a2a-api/)
- [Infinite Audience Account API](https://apis.io/apis/infiniteaudience-ai/infiniteaudience-ai-account-api/)
- [Infinite Audience Audiences API](https://apis.io/apis/infiniteaudience-ai/infiniteaudience-ai-audiences-api/)
- [Infinite Audience Auth API](https://apis.io/apis/infiniteaudience-ai/infiniteaudience-ai-auth-api/)
- [Infinite Audience Campaigns API](https://apis.io/apis/infiniteaudience-ai/infiniteaudience-ai-campaigns-api/)
- [Infinite Audience Deliveries API](https://apis.io/apis/infiniteaudience-ai/infiniteaudience-ai-deliveries-api/)
- [Infinite Audience Discovery API](https://apis.io/apis/infiniteaudience-ai/infiniteaudience-ai-discovery-api/)
- [Infinite Audience Enrichment API](https://apis.io/apis/infiniteaudience-ai/infiniteaudience-ai-enrichment-api/)
- [Infinite Audience Integrations API](https://apis.io/apis/infiniteaudience-ai/infiniteaudience-ai-integrations-api/)
- [Infinite Audience MCP API](https://apis.io/apis/infiniteaudience-ai/infiniteaudience-ai-mcp-api/)
- [Infinite Audience OAuth API](https://apis.io/apis/infiniteaudience-ai/infiniteaudience-ai-oauth-api/)

## Tags

Segments

---

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