PATCH
/
sources
/
{source_id}
/
filter_segments
/
{segment_id}
curl --request PATCH \
  --url https://app.getcensus.com/api/v1/sources/{source_id}/filter_segments/{segment_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "priority accounts",
  "molecules": [
    {
      "attribute": "last_seen_at",
      "attribute_type": "property",
      "operator": "isnotnull",
      "value": "id"
    }
  ]
}'
{
  "status": "updated",
  "data": {
    "type": "segment",
    "id": 18,
    "name": "priority accounts",
    "filter_segment_source_object_id": 32,
    "model_id": 9,
    "query": "SELECT * FROM (\n  SELECT 1 AS id, 'Planet Express'::text AS company_name\n) AS census_1d19740e93f711b22efaea201fcf3f8f\nWHERE (\"id\" IS NOT NULL )\n",
    "record_count": 12540,
    "created_at": "2021-10-20T02:43:07.120Z",
    "updated_at": "2021-10-20T02:50:35.477Z",
    "resource_identifier": "segment:priority-accounts",
    "molecules": [
      {
        "attribute": "last_seen_at",
        "attribute_type": "property",
        "operator": "isnotnull",
        "value": "id"
      }
    ]
  }
}

Authorizations

Authorization
string
headerrequired

Bearer token for the current workspace. Can be retrieved from the Workspace's settings page.

Path Parameters

source_id
integer
required

ID of the source

segment_id
integer
required

ID of the segment

Body

application/json
name
string

The name of this segment.

molecules
object[]

A list of Atomic Molecules, Related Segment Molecules, Relationship Molecules, Molecule Groups and at most one Operation Molecule.

Response

200 - application/json
status
enum<string>

Outcome of the operation.

Available options:
success,
updated,
created,
not_found,
error
data
object