Skip to main content

Documentation Index

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

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

What is a Service?

A Service is an offering type that represents the consulting, implementation, advisory, managed, or professional services your company sells. Services sit alongside Products and Solutions as one of the three offering types in the Octave Library. Where a Product captures features and capabilities, a Service captures deliverables, competencies, and the comparative advantage of how you deliver — the dimensions that actually matter when agents position services-based revenue. Every persona, use case, motion, and qualifying question can attach to a Service exactly like it can to a Product. The downstream library structure is identical; only the offering’s shape differs.

What a Service contains

FieldPurpose
NameExternal-facing service name
Internal nameInternal alias used by your team
DescriptionWhat the service does and who it’s for
Primary URLService page link
SummaryOne-paragraph overview
DeliverablesWhat the customer actually receives
CompetenciesSkills and expertise required to deliver it
Comparative advantageWhy your delivery beats the alternatives
Likely alternativeWhat prospects fall back on if they don’t buy
Challenges addressedThe problems this service solves
Customer benefitsWhat changes for the customer after delivery
Qualifying questionsQuestions to assess service fit

How Services connect to other entities

Services play the same role as Products in the Library graph:
  • Personas — who buys and benefits from the service
  • Use Cases — problems the service addresses
  • Motions — strategies built around the service
  • References — customer success stories
  • Competitors — other firms competing on the same engagement
  • Alternatives — in-house delivery, “do nothing”, manual processes
  • Proof Points — outcome metrics from past engagements
  • Buying Triggers — events that drive service demand

Managing Services via API

  • GET /api/v2/service/list — list services
  • GET /api/v2/service/get — get a service
  • POST /api/v2/service/create — create a service
  • POST /api/v2/service/generate — AI-generate a service definition from your site or description
  • POST /api/v2/service/update — update a service
  • POST /api/v2/service/delete — delete a service