Skip to main content
GET
/
orgs
/
{org_id}
/
segments
/
{segment_id}
Get a Segment
curl --request GET \
  --url https://api.useinvent.com/orgs/{org_id}/segments/{segment_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "name": "<string>",
  "color": "red",
  "contacts_count": 123,
  "boards": [
    {
      "board_id": "<string>",
      "board_name": "<string>",
      "column_id": "<string>"
    }
  ],
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.useinvent.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer token authentication using your API key

Path Parameters

​
org_id
string
required

Org ID

​
segment_id
string
required

Segment ID

Response

200 - application/json

Schema for the segment

​
id
string
required
​
name
string
required
​
color
enum<string>
required

The name of the color to use in the UI

Available options:
red,
orange,
amber,
yellow,
lime,
green,
teal,
cyan,
sky,
blue,
indigo,
violet,
purple,
fuchsia,
pink,
rose,
neutral
​
contacts_count
number
required
​
boards
object[]
required
​
created_at
string<date-time>
required
​
updated_at
string<date-time>
required