curl --request POST \
  --url https://app.octavehq.com/api/v2/segment/update \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "oId": "sg_1234",
  "name": "Enterprise Technology Companies",
  "internalName": "EnterpriseTech500Plus",
  "description": "Large technology companies with 500+ employees seeking digital transformation",
  "firmographicCharacteristics": [
    "Typically mid-market to enterprise companies with 200-5000 employees.",
    "Series B through late-stage or publicly traded, with established revenue streams.",
    "Predominantly North American footprint with growing international presence.",
    "Sales-led or hybrid go-to-market motion with dedicated account management."
  ],
  "relevanceToOurBusiness": [
    "High contract values driven by complex operational requirements.",
    "Strong expansion potential as adoption spreads across departments."
  ],
  "definingAttributes": [
    "Heavy reliance on cross-functional workflows spanning engineering and operations.",
    "Decision-making distributed across technical and business stakeholders."
  ],
  "businessDrivers": [
    "Revenue growth through expansion into adjacent markets.",
    "Operational efficiency gains to protect margins at scale."
  ],
  "strategicPriorities": [
    "Investing in automation to reduce manual operational overhead.",
    "Building data infrastructure to support real-time decision making."
  ],
  "marketPressures": [
    "Increasing competition from well-funded startups offering point solutions.",
    "Regulatory complexity growing across multiple jurisdictions."
  ],
  "firmographics": {
    "industry": [],
    "businessModel": [],
    "geography": [],
    "revenue": [],
    "employees": []
  },
  "customFields": [
    {
      "title": "<string>",
      "value": [
        "<string>"
      ]
    }
  ]
}
'

{
  "_metadata": {
    "requestId": "requestId",
    "timestamp": "2021-01-01T00:00:00.000Z",
    "usage": 0,
    "message": "message"
  },
  "data": {
    "oId": "<string>",
    "createdAt": "<string>",
    "updatedAt": "<string>",
    "name": "<string>",
    "internalName": "<string>",
    "description": "<string>",
    "unrecognized": true,
    "rejected": true,
    "deletedAt": "<string>",
    "archivedAt": "<string>",
    "active": true,
    "data": {
      "relevanceToOurBusiness": [],
      "firmographics": {
        "industry": [],
        "businessModel": [],
        "geography": [],
        "revenue": [],
        "employees": []
      },
      "firmographicCharacteristics": [],
      "definingAttributes": [],
      "businessDrivers": [],
      "strategicPriorities": [],
      "marketPressures": [],
      "customFields": [
        {
          "title": "<string>",
          "value": [
            "<string>"
          ]
        }
      ]
    },
    "qualifyingQuestions": [
      {
        "question": "<string>",
        "rationale": "<string>",
        "fitType": "GOOD",
        "weight": "MEDIUM",
        "archivedAt": "<string>"
      }
    ],
    "user": {
      "oId": "<string>",
      "firstName": "John",
      "lastName": "Doe"
    },
    "workspace": {
      "oId": "<string>"
    }
  }
}