Update Segment

Patches a segment. `targetType` is immutable; passing it is a type-level error. Renames may collide → 409.

Authorization

AuthorizationRequiredBearer <token>

API key as Bearer token

In: header

Request Body

application/jsonRequired

updateRequiredobject

Path Parameters

idRequiredstring

Segment id.

Pattern: "^[a-f0-9]{24}$"

PATCH/v1/segments/{id}

curl -X PATCH "https://api.3common.com/v1/segments/string" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "update": {
      "name": "string",
      "description": "string",
      "filters": [
        {
          "logic": "and",
          "conditions": [
            null
          ],
          "property1": null,
          "property2": null
        }
      ],
      "folderId": "string",
      "trackMembershipEvents": true,
      "refreshIntervalMs": 60000
    }
  }'

Default Response

Response

{
  "segment": {
    "id": "string",
    "ownerId": "string",
    "name": "string",
    "description": "string",
    "targetType": "contact",
    "kind": "active",
    "filters": [
      {
        "logic": "and",
        "conditions": [
          null
        ],
        "property1": null,
        "property2": null
      }
    ],
    "formId": "string",
    "folderId": "string",
    "status": "active",
    "trackMembershipEvents": true,
    "refreshIntervalMs": 0,
    "lastRefreshedAt": "2019-08-24T14:15:22Z",
    "refreshingUntil": "2019-08-24T14:15:22Z",
    "memberCount": 0,
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z"
  }
}

TypeScript

export interface Response {
  segment: {
    id: string;
    ownerId: string;
    name: string;
    description?: string;
    targetType: "contact" | "order" | "ticket";
    kind: "active" | "static";
    filters: {
      logic: "and" | "or";
      conditions: unknown[];
      [k: string]: unknown;
    }[];
    formId?: string;
    folderId?: string;
    status: "active" | "archived";
    trackMembershipEvents: boolean;
    refreshIntervalMs?: number;
    lastRefreshedAt?: string;
    refreshingUntil?: string;
    memberCount?: number;
    createdAt: string;
    updatedAt: string;
  };
}