action posthog_customer_analytics_external_accounts_retrieve {
  label: "List external customer analytics accounts"
  description: "List accounts with external IDs and their active relationship assignments. Requires a project secret API key with the `account:read` scope."
  provider: posthog
  method: GET
  path: "/api/customer_analytics/external/accounts"
  encoding: json
  input: {
    type: "object"
    properties: {
      assigned_only: {
        type: "boolean"
      }
      cursor: {
        type: "string"
      }
      limit: {
        type: "integer"
      }
    }
    additionalProperties: false
  }
  output: {
    type: "object"
    required: ["next_cursor", "results"]
    properties: {
      next_cursor: {
        type: ["string", "null"]
        description: "Account UUID to pass as `cursor` for the next page, or null when the list is exhausted."
      }
      results: {
        type: "array"
        description: "Accounts in this page, ordered by account id."
        items: {
          type: "object"
          required: ["external_id", "name", "relationships"]
          properties: {
            external_id: {
              type: "string"
              description: "External account key used by downstream systems."
            }
            name: {
              type: "string"
              description: "Human-readable account name."
            }
            relationships: {
              type: "object"
              description: "Active relationship assignments to current organization members, keyed by relationship definition name (e.g. 'CSM', 'Account executive'). Definitions with no active assignment are omitted."
            }
          }
        }
      }
    }
  }
}