norbelys 0.1.0

data/spec/api/groups_api_spec.rb

@@ -0,0 +1,127 @@
+=begin
+#Norbelys API
+
+#The **Norbelys API** is a single, predictable REST surface for cold email and outreach — people, senders, programs, and sending all live behind the five patterns below. Developer-first and AI-first: every name is either already invented (Schema.org) or obvious.  ## Authentication  Every request authenticates with an **org-scoped API key**. Create one in **Settings → API keys** and send it as a bearer token:  ```http GET https://api.norbelys.com/v1/people Authorization: Bearer ak_live_… ```  Interactive agents may instead use OAuth 2.1 (see `/auth.md` and the `/.well-known/oauth-protected-resource` metadata).  ## Conventions  - **Base URL** — `https://api.norbelys.com/v1`. - **JSON in, JSON out.** Timestamps are ISO-8601 in UTC. - **Cursor pagination.** List endpoints take `limit` + `cursor` and return   `{ data, hasMore, nextCursor }` (offset-paged tables add `page` + `total`). - **Expansions.** Detail GETs take an `expand[]` query param to inline related   data (e.g. `GET /people/{id}?expand[]=timeline`) instead of extra calls. - **Soft deletes.** Anything that has been used is archived, never hard-deleted —   `DELETE` archives the resource and returns it.  ## Errors  Failures return the same envelope on every 4xx/5xx, with the matching HTTP status:  ```json { \"error\": { \"type\": \"invalid_request\", \"code\": \"invalid_param\",             \"message\": \"…\", \"hint\": \"…\", \"doc_url\": \"…\" } } ```  `type` is a broad, machine-routable category derived from the status; `code` is the stable machine contract you branch on (never the human `message`). See the `ApiError` schema.  ## Idempotency  Every `POST` accepts an optional **`Idempotency-Key`** header. Reuse the same key to replay the original result for 24h instead of re-executing — so a retried create can never double-charge or duplicate a record.  ## Rate limits & versioning  Abuse control is enforced at the edge; responses advertise the policy via the `RateLimit-Policy` header, and a `429` carries `Retry-After`. The API is versioned in the URL path (`/v1`). Breaking changes ship under a new version; a retiring surface is announced with `Deprecation` + `Sunset` response headers at least 90 days ahead.
+
+The version of the OpenAPI document: 0.0.1
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.10.0
+
+=end
+
+require 'spec_helper'
+require 'json'
+
+# Unit tests for Norbelys::GroupsApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'GroupsApi' do
+  before do
+    # run before each test
+    @api_instance = Norbelys::GroupsApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of GroupsApi' do
+    it 'should create an instance of GroupsApi' do
+      expect(@api_instance).to be_instance_of(Norbelys::GroupsApi)
+    end
+  end
+
+  # unit tests for groups_archive
+  # Delete a group
+  # Permanently delete the group and its membership rows. The people themselves are kept — only their membership in this group is removed.
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @return [Group]
+  describe 'groups_archive test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for groups_create
+  # Create a group
+  # Create a group: an empty static list of people. Add members with groups.members.add (explicit person ids, or snapshot a segment's current matches), then view them at GET /v1/people?groupId={id}.
+  # @param group_create_params 
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :idempotency_key Opt-in idempotency for a safely retried write: reuse the same key to replay the original result for 24h instead of re-executing. Recommended on every POST.
+  # @return [Group]
+  describe 'groups_create test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for groups_find
+  # Get a group
+  # Read one group, including its live member count. List its members at GET /v1/people?groupId={id} — there is no separate members endpoint.
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @return [Group]
+  describe 'groups_find test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for groups_list
+  # List groups
+  # List the org's groups — static, hand-curated lists of people — newest first.
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :cursor 
+  # @option opts [Boolean] :include_archived 
+  # @option opts [Integer] :limit 
+  # @option opts [String] :q 
+  # @return [GroupList]
+  describe 'groups_list test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for groups_members_add
+  # Add people to a group
+  # Add people to the group by explicit person ids and/or by snapshotting a segment's current matches into it. Idempotent — people already in the group are skipped.
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :idempotency_key Opt-in idempotency for a safely retried write: reuse the same key to replay the original result for 24h instead of re-executing. Recommended on every POST.
+  # @option opts [GroupAddMembersParams] :group_add_members_params 
+  # @return [GroupAddMembersResult]
+  describe 'groups_members_add test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for groups_members_remove
+  # Remove a person from a group
+  # Remove one person from the group. The person record is kept — only their membership in this group is removed.
+  # @param id 
+  # @param rel_id 
+  # @param [Hash] opts the optional parameters
+  # @return [DetachResult]
+  describe 'groups_members_remove test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for groups_update
+  # Update a group
+  # Rename a group or change its description and color chip. Membership is edited separately via groups.members.add / groups.members.remove.
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @option opts [GroupUpdateParams] :group_update_params 
+  # @return [Group]
+  describe 'groups_update test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end

data/spec/api/integrations_api_spec.rb

@@ -0,0 +1,124 @@
+=begin
+#Norbelys API
+
+#The **Norbelys API** is a single, predictable REST surface for cold email and outreach — people, senders, programs, and sending all live behind the five patterns below. Developer-first and AI-first: every name is either already invented (Schema.org) or obvious.  ## Authentication  Every request authenticates with an **org-scoped API key**. Create one in **Settings → API keys** and send it as a bearer token:  ```http GET https://api.norbelys.com/v1/people Authorization: Bearer ak_live_… ```  Interactive agents may instead use OAuth 2.1 (see `/auth.md` and the `/.well-known/oauth-protected-resource` metadata).  ## Conventions  - **Base URL** — `https://api.norbelys.com/v1`. - **JSON in, JSON out.** Timestamps are ISO-8601 in UTC. - **Cursor pagination.** List endpoints take `limit` + `cursor` and return   `{ data, hasMore, nextCursor }` (offset-paged tables add `page` + `total`). - **Expansions.** Detail GETs take an `expand[]` query param to inline related   data (e.g. `GET /people/{id}?expand[]=timeline`) instead of extra calls. - **Soft deletes.** Anything that has been used is archived, never hard-deleted —   `DELETE` archives the resource and returns it.  ## Errors  Failures return the same envelope on every 4xx/5xx, with the matching HTTP status:  ```json { \"error\": { \"type\": \"invalid_request\", \"code\": \"invalid_param\",             \"message\": \"…\", \"hint\": \"…\", \"doc_url\": \"…\" } } ```  `type` is a broad, machine-routable category derived from the status; `code` is the stable machine contract you branch on (never the human `message`). See the `ApiError` schema.  ## Idempotency  Every `POST` accepts an optional **`Idempotency-Key`** header. Reuse the same key to replay the original result for 24h instead of re-executing — so a retried create can never double-charge or duplicate a record.  ## Rate limits & versioning  Abuse control is enforced at the edge; responses advertise the policy via the `RateLimit-Policy` header, and a `429` carries `Retry-After`. The API is versioned in the URL path (`/v1`). Breaking changes ship under a new version; a retiring surface is announced with `Deprecation` + `Sunset` response headers at least 90 days ahead.
+
+The version of the OpenAPI document: 0.0.1
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.10.0
+
+=end
+
+require 'spec_helper'
+require 'json'
+
+# Unit tests for Norbelys::IntegrationsApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'IntegrationsApi' do
+  before do
+    # run before each test
+    @api_instance = Norbelys::IntegrationsApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of IntegrationsApi' do
+    it 'should create an instance of IntegrationsApi' do
+      expect(@api_instance).to be_instance_of(Norbelys::IntegrationsApi)
+    end
+  end
+
+  # unit tests for integrations_connect
+  # Connect an integration
+  # Mints a Nango Connect session for the provider and returns its `sessionToken` for the frontend Connect UI. There is no direct create — the connection row is born from the provider's auth webhook once the user finishes authorizing.
+  # @param integration_connect_params 
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :idempotency_key Opt-in idempotency for a safely retried write: reuse the same key to replay the original result for 24h instead of re-executing. Recommended on every POST.
+  # @return [IntegrationConnectResult]
+  describe 'integrations_connect test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for integrations_find
+  # Get an integration
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @return [Integration]
+  describe 'integrations_find test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for integrations_list
+  # List integrations
+  # Each row is one connected provider account. There is no create endpoint — a connection is born from the provider's auth webhook after you call `connect`.
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :cursor 
+  # @option opts [Boolean] :include_archived 
+  # @option opts [Integer] :limit 
+  # @option opts [String] :provider 
+  # @return [IntegrationList]
+  describe 'integrations_list test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for integrations_options
+  # List an integration's config options
+  # Config-time lookup of the provider's selectable options, proxied live through Nango — today, the postable Slack channels for the notification channel picker.
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @return [IntegrationOptions]
+  describe 'integrations_options test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for integrations_remove
+  # Disconnect an integration
+  # Disconnects the account: revokes the credential at the provider via Nango and soft-archives the row.
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @return [Integration]
+  describe 'integrations_remove test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for integrations_sync
+  # Sync an integration now
+  # Triggers an immediate, off-schedule sync, queuing a drain of every model the provider syncs (e.g. leads and deals for a CRM).
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :idempotency_key Opt-in idempotency for a safely retried write: reuse the same key to replay the original result for 24h instead of re-executing. Recommended on every POST.
+  # @return [IntegrationSyncResult]
+  describe 'integrations_sync test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for integrations_update
+  # Update an integration
+  # Shallow-merges the given `config` over the stored config (top-level keys replace). Slack carries the notification toggles and target channel; CRMs carry the sync-in / push-out direction gates.
+  # @param id 
+  # @param integration_update_params 
+  # @param [Hash] opts the optional parameters
+  # @return [Integration]
+  describe 'integrations_update test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end

data/spec/api/messages_api_spec.rb

@@ -0,0 +1,139 @@
+=begin
+#Norbelys API
+
+#The **Norbelys API** is a single, predictable REST surface for cold email and outreach — people, senders, programs, and sending all live behind the five patterns below. Developer-first and AI-first: every name is either already invented (Schema.org) or obvious.  ## Authentication  Every request authenticates with an **org-scoped API key**. Create one in **Settings → API keys** and send it as a bearer token:  ```http GET https://api.norbelys.com/v1/people Authorization: Bearer ak_live_… ```  Interactive agents may instead use OAuth 2.1 (see `/auth.md` and the `/.well-known/oauth-protected-resource` metadata).  ## Conventions  - **Base URL** — `https://api.norbelys.com/v1`. - **JSON in, JSON out.** Timestamps are ISO-8601 in UTC. - **Cursor pagination.** List endpoints take `limit` + `cursor` and return   `{ data, hasMore, nextCursor }` (offset-paged tables add `page` + `total`). - **Expansions.** Detail GETs take an `expand[]` query param to inline related   data (e.g. `GET /people/{id}?expand[]=timeline`) instead of extra calls. - **Soft deletes.** Anything that has been used is archived, never hard-deleted —   `DELETE` archives the resource and returns it.  ## Errors  Failures return the same envelope on every 4xx/5xx, with the matching HTTP status:  ```json { \"error\": { \"type\": \"invalid_request\", \"code\": \"invalid_param\",             \"message\": \"…\", \"hint\": \"…\", \"doc_url\": \"…\" } } ```  `type` is a broad, machine-routable category derived from the status; `code` is the stable machine contract you branch on (never the human `message`). See the `ApiError` schema.  ## Idempotency  Every `POST` accepts an optional **`Idempotency-Key`** header. Reuse the same key to replay the original result for 24h instead of re-executing — so a retried create can never double-charge or duplicate a record.  ## Rate limits & versioning  Abuse control is enforced at the edge; responses advertise the policy via the `RateLimit-Policy` header, and a `429` carries `Retry-After`. The API is versioned in the URL path (`/v1`). Breaking changes ship under a new version; a retiring surface is announced with `Deprecation` + `Sunset` response headers at least 90 days ahead.
+
+The version of the OpenAPI document: 0.0.1
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.10.0
+
+=end
+
+require 'spec_helper'
+require 'json'
+
+# Unit tests for Norbelys::MessagesApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'MessagesApi' do
+  before do
+    # run before each test
+    @api_instance = Norbelys::MessagesApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of MessagesApi' do
+    it 'should create an instance of MessagesApi' do
+      expect(@api_instance).to be_instance_of(Norbelys::MessagesApi)
+    end
+  end
+
+  # unit tests for messages_attachment
+  # Download a message attachment
+  # Download one attachment's Base64 content by its id from the attachments list — works for both sent (read from the immutable R2 source) and received (saved at ingest) messages.
+  # @param id 
+  # @param attachment_id 
+  # @param [Hash] opts the optional parameters
+  # @return [MessageAttachmentDownload]
+  describe 'messages_attachment test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for messages_attachments
+  # List a message's attachments
+  # List every file carried on a sent or received message — metadata only; fetch each file's content with messages.attachment.
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @return [MessageAttachmentList]
+  describe 'messages_attachments test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for messages_create
+  # Send a message
+  # Send a real email — the one send door for all outbound mail. `from` is a sender id (snd_…) or any address on a provisioned sending domain (e.g. \"david@hola.com\" or \"Acme <david@hola.com>\"; the identity is created on first use). Provide content inline (subject + html/text) or render a stored template with variantId + data. Reply to an inbound message by passing inReplyTo (the send threads to that conversation); set test:true for a one-off preview that is excluded from campaign stats. For a paced (cold) sender, pass sequence to enroll the person instead of sending now.
+  # @param message_create_params 
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :idempotency_key Opt-in idempotency for a safely retried write: reuse the same key to replay the original result for 24h instead of re-executing. Recommended on every POST.
+  # @return [Message]
+  describe 'messages_create test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for messages_find
+  # Get a message
+  # Read one message by id — an outbound send or an inbound reply.
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @return [Message]
+  describe 'messages_find test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for messages_list
+  # List messages
+  # List the unified message log — outbound and inbound interleaved by time, newest first. Pass direction=inbound for the unibox (replies only), senderId for one mailbox's full history, or programId / personId / threadId to scope; filter by status, classification, isRead, or channel.
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :cursor 
+  # @option opts [Boolean] :include_archived 
+  # @option opts [String] :channel 
+  # @option opts [String] :classification 
+  # @option opts [String] :dir 
+  # @option opts [String] :direction 
+  # @option opts [String] :email 
+  # @option opts [Boolean] :is_read 
+  # @option opts [Integer] :limit 
+  # @option opts [String] :order_by 
+  # @option opts [Integer] :page 
+  # @option opts [String] :person_id 
+  # @option opts [String] :program_id 
+  # @option opts [String] :search 
+  # @option opts [String] :sender_id 
+  # @option opts [String] :status 
+  # @option opts [String] :step_id 
+  # @option opts [String] :thread_id 
+  # @return [MessageList]
+  describe 'messages_list test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for messages_source
+  # Get a sent message's source
+  # Return the exact bytes that left — the fully personalized email (final subject, HTML and text, with tracking and footer applied) as persisted to R2 at send time. Outbound messages only; inbound bodies ride on the message itself.
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @return [MessageSource]
+  describe 'messages_source test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for messages_update
+  # Triage an inbound message
+  # Triage an inbound reply: mark it read or unread, re-classify its intent, and/or assign it to a teammate. Inbound messages only.
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @option opts [MessageUpdateParams] :message_update_params 
+  # @return [Message]
+  describe 'messages_update test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end

data/spec/api/organization_api_spec.rb

@@ -0,0 +1,92 @@
+=begin
+#Norbelys API
+
+#The **Norbelys API** is a single, predictable REST surface for cold email and outreach — people, senders, programs, and sending all live behind the five patterns below. Developer-first and AI-first: every name is either already invented (Schema.org) or obvious.  ## Authentication  Every request authenticates with an **org-scoped API key**. Create one in **Settings → API keys** and send it as a bearer token:  ```http GET https://api.norbelys.com/v1/people Authorization: Bearer ak_live_… ```  Interactive agents may instead use OAuth 2.1 (see `/auth.md` and the `/.well-known/oauth-protected-resource` metadata).  ## Conventions  - **Base URL** — `https://api.norbelys.com/v1`. - **JSON in, JSON out.** Timestamps are ISO-8601 in UTC. - **Cursor pagination.** List endpoints take `limit` + `cursor` and return   `{ data, hasMore, nextCursor }` (offset-paged tables add `page` + `total`). - **Expansions.** Detail GETs take an `expand[]` query param to inline related   data (e.g. `GET /people/{id}?expand[]=timeline`) instead of extra calls. - **Soft deletes.** Anything that has been used is archived, never hard-deleted —   `DELETE` archives the resource and returns it.  ## Errors  Failures return the same envelope on every 4xx/5xx, with the matching HTTP status:  ```json { \"error\": { \"type\": \"invalid_request\", \"code\": \"invalid_param\",             \"message\": \"…\", \"hint\": \"…\", \"doc_url\": \"…\" } } ```  `type` is a broad, machine-routable category derived from the status; `code` is the stable machine contract you branch on (never the human `message`). See the `ApiError` schema.  ## Idempotency  Every `POST` accepts an optional **`Idempotency-Key`** header. Reuse the same key to replay the original result for 24h instead of re-executing — so a retried create can never double-charge or duplicate a record.  ## Rate limits & versioning  Abuse control is enforced at the edge; responses advertise the policy via the `RateLimit-Policy` header, and a `429` carries `Retry-After`. The API is versioned in the URL path (`/v1`). Breaking changes ship under a new version; a retiring surface is announced with `Deprecation` + `Sunset` response headers at least 90 days ahead.
+
+The version of the OpenAPI document: 0.0.1
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.10.0
+
+=end
+
+require 'spec_helper'
+require 'json'
+
+# Unit tests for Norbelys::OrganizationApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'OrganizationApi' do
+  before do
+    # run before each test
+    @api_instance = Norbelys::OrganizationApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of OrganizationApi' do
+    it 'should create an instance of OrganizationApi' do
+      expect(@api_instance).to be_instance_of(Norbelys::OrganizationApi)
+    end
+  end
+
+  # unit tests for organization_features
+  # Get the organization's feature flags
+  # Returns the workspace's resolved feature flags (per-org, evaluated at the edge). Use it to conditionally render gated features in a client; server endpoints enforce their own gate independently.
+  # @param [Hash] opts the optional parameters
+  # @return [Features]
+  describe 'organization_features test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for organization_find
+  # Get the organization
+  # The workspace this credential acts on: org id, display name, company profile, onboarding and notification state. Read-only — THE first call to confirm \"who am I / which tenant is this?\".
+  # @param [Hash] opts the optional parameters
+  # @return [Organization]
+  describe 'organization_find test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for organization_pulse
+  # Get the workspace pulse
+  # One-call workspace briefing: every campaign with its lead count, completion, and engagement funnel over the window (default 7 days), the mailbox fleet rolled up by state and reputation, and the account deliverability headline. THE first read for any \"how is everything going?\" / status question — prefer it over separately listing programs, senders, and analytics.
+  # @param [Hash] opts the optional parameters
+  # @option opts [Integer] :days 
+  # @return [OrganizationPulse]
+  describe 'organization_pulse test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for organization_update
+  # Update the organization
+  # Update the workspace's editable profile and settings: company profile, onboarding state, deliverability alerts, and bounce-handling policy. Idempotent — every field is optional, and calling it with an empty body just reconciles the tenant (it provisions the org's registry row when the user moves faster than the provisioning webhook). Returns the full resolved organization state. Members and invites are managed through Clerk, not this endpoint.
+  # @param organization_update_params 
+  # @param [Hash] opts the optional parameters
+  # @return [Organization]
+  describe 'organization_update test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for organization_usage
+  # Get the organization's plan usage
+  # The workspace's usage against its plan limits: live campaigns, active contacts, and emails sent this UTC month, each with the cap and an `ok`/`near`/`reached` level, plus the plan itself. Use it to answer \"how close am I to my limits?\" — the caps are enforced server-side regardless.
+  # @param [Hash] opts the optional parameters
+  # @return [OrganizationUsage]
+  describe 'organization_usage test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end

data/spec/api/people_api_spec.rb

@@ -0,0 +1,158 @@
+=begin
+#Norbelys API
+
+#The **Norbelys API** is a single, predictable REST surface for cold email and outreach — people, senders, programs, and sending all live behind the five patterns below. Developer-first and AI-first: every name is either already invented (Schema.org) or obvious.  ## Authentication  Every request authenticates with an **org-scoped API key**. Create one in **Settings → API keys** and send it as a bearer token:  ```http GET https://api.norbelys.com/v1/people Authorization: Bearer ak_live_… ```  Interactive agents may instead use OAuth 2.1 (see `/auth.md` and the `/.well-known/oauth-protected-resource` metadata).  ## Conventions  - **Base URL** — `https://api.norbelys.com/v1`. - **JSON in, JSON out.** Timestamps are ISO-8601 in UTC. - **Cursor pagination.** List endpoints take `limit` + `cursor` and return   `{ data, hasMore, nextCursor }` (offset-paged tables add `page` + `total`). - **Expansions.** Detail GETs take an `expand[]` query param to inline related   data (e.g. `GET /people/{id}?expand[]=timeline`) instead of extra calls. - **Soft deletes.** Anything that has been used is archived, never hard-deleted —   `DELETE` archives the resource and returns it.  ## Errors  Failures return the same envelope on every 4xx/5xx, with the matching HTTP status:  ```json { \"error\": { \"type\": \"invalid_request\", \"code\": \"invalid_param\",             \"message\": \"…\", \"hint\": \"…\", \"doc_url\": \"…\" } } ```  `type` is a broad, machine-routable category derived from the status; `code` is the stable machine contract you branch on (never the human `message`). See the `ApiError` schema.  ## Idempotency  Every `POST` accepts an optional **`Idempotency-Key`** header. Reuse the same key to replay the original result for 24h instead of re-executing — so a retried create can never double-charge or duplicate a record.  ## Rate limits & versioning  Abuse control is enforced at the edge; responses advertise the policy via the `RateLimit-Policy` header, and a `429` carries `Retry-After`. The API is versioned in the URL path (`/v1`). Breaking changes ship under a new version; a retiring surface is announced with `Deprecation` + `Sunset` response headers at least 90 days ahead.
+
+The version of the OpenAPI document: 0.0.1
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.10.0
+
+=end
+
+require 'spec_helper'
+require 'json'
+
+# Unit tests for Norbelys::PeopleApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'PeopleApi' do
+  before do
+    # run before each test
+    @api_instance = Norbelys::PeopleApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of PeopleApi' do
+    it 'should create an instance of PeopleApi' do
+      expect(@api_instance).to be_instance_of(Norbelys::PeopleApi)
+    end
+  end
+
+  # unit tests for people_archive
+  # Archive a person
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @return [Person]
+  describe 'people_archive test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for people_audience_summary
+  # Get audience summary
+  # Summarize the whole workspace, one group, or one segment: exact people total, lifecycle mix, recent engagement, average score, and a 12-week audience-arrival series.
+  # @param scope 
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :group_id 
+  # @option opts [String] :segment_id 
+  # @return [AudienceSummary]
+  describe 'people_audience_summary test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for people_bulk_create
+  # Bulk create people (verifies + suppresses in the background; optional group / campaign)
+  # @param people_bulk_create_params 
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :idempotency_key Opt-in idempotency for a safely retried write: reuse the same key to replay the original result for 24h instead of re-executing. Recommended on every POST.
+  # @return [PeopleBulkCreateResult]
+  describe 'people_bulk_create test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for people_create
+  # Create a person
+  # Add one person (a lead) to the CRM. `email` is required; anything beyond the system fields rides in `customFields` keyed by code. To insert many at once, use bulkCreate instead.
+  # @param person_create_params 
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :idempotency_key Opt-in idempotency for a safely retried write: reuse the same key to replay the original result for 24h instead of re-executing. Recommended on every POST.
+  # @return [Person]
+  describe 'people_create test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for people_erase
+  # Erase a person (GDPR)
+  # Permanently scrub this person's PII and redact their inbound messages — the ONE true hard delete (distinct from archive/DELETE, which only soft-archives and keeps the data). Irreversible; use for a GDPR erasure request.
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :idempotency_key Opt-in idempotency for a safely retried write: reuse the same key to replay the original result for 24h instead of re-executing. Recommended on every POST.
+  # @return [PersonErased]
+  describe 'people_erase test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for people_find
+  # Get a person
+  # Read one person. Pass `expand[]=timeline` for their merged sent/received messages, `expand[]=enrollments` for campaign memberships, `expand[]=groups` for their static lists, and/or `expand[]=segments` for dynamic audiences they currently match.
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @option opts [Array<String>] :expand 
+  # @return [PersonDetail]
+  describe 'people_find test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for people_get_bulk
+  # Get a bulk import&#39;s verify stats (sendable / suppressed / pending)
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @return [PersonImportStats]
+  describe 'people_get_bulk test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for people_list
+  # List people
+  # List the org&#39;s people (its CRM leads); &#x60;total&#x60; is the full match count. Filter by status, source, group, or segment, or pass a live &#x60;filter&#x60; rule tree to preview a draft segment. Cursor callers remain newest-first; page-based callers can sort by creation, name, email, last activity, or engagement score.
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :cursor 
+  # @option opts [Boolean] :include_archived 
+  # @option opts [String] :dir 
+  # @option opts [AudienceFilter] :filter 
+  # @option opts [String] :group_id 
+  # @option opts [Integer] :limit 
+  # @option opts [Integer] :page 
+  # @option opts [String] :search 
+  # @option opts [String] :segment_id 
+  # @option opts [String] :sort 
+  # @option opts [Array<String>] :source 
+  # @option opts [Array<String>] :status 
+  # @return [PersonList]
+  describe 'people_list test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for people_update
+  # Update a person
+  # Patch a person&#39;s editable fields; only the fields you send change. Note that &#x60;customFields&#x60; replaces the entire custom-field bag — send the full set, not a partial delta.
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @option opts [PersonUpdateParams] :person_update_params 
+  # @return [PersonDetail]
+  describe 'people_update test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end