Skip to main content
POST
/
api
/
v2
/
playbook
/
update
Update Playbook
curl --request POST \
  --url https://app.octavehq.com/api/v2/playbook/update \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '{
  "oId": "pb_1234",
  "name": "Enterprise Sales Playbook",
  "description": "Comprehensive playbook for enterprise sales processes",
  "explanation": "This playbook focuses on enterprise accounts with complex decision-making processes",
  "attributes": {
    "industry": [
      "technology",
      "healthcare"
    ],
    "size": [
      "enterprise"
    ]
  },
  "icpConcerns": [
    "Budget constraints",
    "Security requirements",
    "Integration complexity"
  ],
  "icpPriorities": [
    "Reduce costs",
    "Improve efficiency",
    "Scale operations"
  ],
  "keyInsight": [
    "Enterprise buyers value ROI demonstrations",
    "Decision process involves multiple stakeholders"
  ],
  "statusQuo": [
    "Manual processes",
    "Legacy systems",
    "Disconnected tools"
  ],
  "differentiatedValue": [
    "Advanced automation",
    "Enterprise-grade security",
    "Seamless integrations"
  ],
  "exampleDomains": [
    "acme.com",
    "example.com",
    "enterprise.com"
  ],
  "exampleDescription": "Target Fortune 500 companies with existing CRM systems looking to modernize",
  "approachAngle": [
    "ROI-focused approach",
    "Security-first messaging",
    "Integration benefits"
  ],
  "strategicNarrative": [
    "Digital transformation is essential",
    "Legacy systems are holding you back"
  ],
  "customFields": [
    {
      "title": "<string>",
      "value": [
        "<string>"
      ]
    }
  ]
}'
{
  "_metadata": {
    "usage": 0,
    "requestId": "requestId",
    "message": "message",
    "timestamp": "2021-01-01T00:00:00.000Z"
  },
  "data": {
    "oId": "<string>",
    "createdAt": "<string>",
    "updatedAt": "<string>",
    "deletedAt": "<string>",
    "archivedAt": "<string>",
    "name": "<string>",
    "description": "<string>",
    "data": {
      "explanation": "<string>",
      "attributes": {},
      "icpConcerns": [],
      "icpPriorities": [],
      "keyInsight": [],
      "statusQuo": [],
      "differentiatedValue": [],
      "exampleDomains": [],
      "exampleDescription": "",
      "approachAngle": [
        "<string>"
      ],
      "strategicNarrative": [
        "<string>"
      ],
      "customFields": [
        {
          "title": "<string>",
          "value": [
            "<string>"
          ]
        }
      ]
    },
    "qualifyingQuestions": [
      {
        "question": "<string>",
        "rationale": "<string>",
        "fitType": "GOOD",
        "weight": "MEDIUM",
        "archivedAt": "<string>"
      }
    ],
    "shared": true,
    "active": true,
    "type": "LEGACY",
    "status": "active",
    "referenceMode": "specific",
    "proofPointMode": "none",
    "user": {
      "oId": "<string>",
      "firstName": "<string>",
      "lastName": "<string>"
    },
    "workspace": {
      "oId": "<string>"
    },
    "product": {
      "oId": "<string>",
      "name": "<string>",
      "data": {
        "type": "PRODUCT",
        "internalName": "<string>",
        "summary": "<string>",
        "capabilities": [
          "Capability 1",
          "Capability 2"
        ],
        "differentiatedValue": [
          "Differentiated Value 1",
          "Differentiated Value 2"
        ],
        "statusQuo": [
          "Status Quo 1",
          "Status Quo 2"
        ],
        "challengesAddressed": [
          "Challenge 1",
          "Challenge 2"
        ],
        "customerBenefits": [
          "Benefit 1",
          "Benefit 2"
        ],
        "customFields": [
          {
            "title": "<string>",
            "value": [
              "<string>"
            ]
          }
        ]
      },
      "description": "<string>"
    },
    "buyerPersonas": [
      {
        "oId": "<string>",
        "name": "<string>",
        "description": "<string>",
        "hypotheses": [
          {
            "oId": "<string>",
            "createdAt": "<string>",
            "archivedAt": "<string>",
            "deletedAt": "<string>",
            "updatedAt": "<string>",
            "title": "<string>",
            "details": "<string>",
            "context": "<string>",
            "persona": {
              "name": "<string>",
              "oId": "<string>"
            },
            "playbook": {
              "name": "<string>",
              "oId": "<string>"
            },
            "user": {
              "name": "<string>",
              "oId": "<string>"
            }
          }
        ],
        "data": {
          "internalName": "<string>",
          "primaryResponsibilities": [
            "Responsibility 1",
            "Responsibility 2"
          ],
          "painPoints": [
            "Pain Point 1",
            "Pain Point 2"
          ],
          "keyConcerns": [
            "Concern 1",
            "Concern 2"
          ],
          "keyObjectives": [
            "Objective 1",
            "Objective 2"
          ],
          "commonJobTitles": [
            "Job Title 1",
            "Job Title 2"
          ],
          "whyTheyMatterToUs": [
            "Reason 1",
            "Reason 2"
          ],
          "whyWeMatterToThem": [
            "Reason 1",
            "Reason 2"
          ],
          "customFields": [
            {
              "title": "<string>",
              "value": [
                "<string>"
              ]
            }
          ]
        }
      }
    ],
    "useCases": [
      {
        "oId": "<string>",
        "name": "<string>",
        "description": "<string>",
        "data": {
          "summary": "<string>",
          "scenarios": [
            "<string>"
          ],
          "desiredOutcomes": [
            "<string>"
          ],
          "businessDrivers": [
            "<string>"
          ],
          "customFields": [
            {
              "title": "<string>",
              "value": [
                "<string>"
              ]
            }
          ]
        }
      }
    ],
    "references": [
      {
        "oId": "<string>",
        "name": "<string>",
        "data": {
          "howTheyMakeMoney": "<string>",
          "howTheyUseProduct": "<string>",
          "howTheyBenefitFromProduct": "<string>",
          "emailSnippets": [
            "<string>"
          ],
          "howWeImpactedTheirBusiness": [
            "<string>"
          ],
          "keyStats": [
            "<string>"
          ],
          "customFields": [
            {
              "title": "<string>",
              "value": [
                "<string>"
              ]
            }
          ]
        },
        "description": "<string>"
      }
    ],
    "segment": {
      "oId": "<string>",
      "name": "<string>",
      "description": "<string>",
      "data": "<any>"
    },
    "competitor": {
      "oId": "<string>",
      "name": "<string>",
      "description": "<string>",
      "data": "<any>"
    },
    "proofPoints": [
      {
        "oId": "<string>",
        "name": "<string>",
        "description": "<string>",
        "data": "<any>"
      }
    ]
  }
}

Authorizations

api_key
string
header
required

Body

application/json

Playbook update input

oId
string
required

The ID of the playbook to update

Minimum length: 1
Example:

"pb_1234"

name
string

The name of the playbook

Example:

"Enterprise Sales Playbook"

description
string

A description of the playbook

Example:

"Comprehensive playbook for enterprise sales processes"

explanation
string

Detailed explanation of the playbook strategy

Example:

"This playbook focuses on enterprise accounts with complex decision-making processes"

attributes
object

Key attributes and characteristics of the playbook

Example:
{
"industry": ["technology", "healthcare"],
"size": ["enterprise"]
}
icpConcerns
string[]

Key concerns of the Ideal Customer Profile

Example:
[
"Budget constraints",
"Security requirements",
"Integration complexity"
]
icpPriorities
string[]

Top priorities of the Ideal Customer Profile

Example:
[
"Reduce costs",
"Improve efficiency",
"Scale operations"
]
keyInsight
string[]

Key insights that drive this playbook strategy

Example:
[
"Enterprise buyers value ROI demonstrations",
"Decision process involves multiple stakeholders"
]
statusQuo
string[]

Current state or status quo that this playbook addresses

Example:
[
"Manual processes",
"Legacy systems",
"Disconnected tools"
]
differentiatedValue
string[]

Unique value propositions that differentiate from competitors

Example:
[
"Advanced automation",
"Enterprise-grade security",
"Seamless integrations"
]
exampleDomains
string[]

Example company domains that fit this playbook

Example:
["acme.com", "example.com", "enterprise.com"]
exampleDescription
string

Example description or scenario for this playbook

Example:

"Target Fortune 500 companies with existing CRM systems looking to modernize"

approachAngle
string[]

Different angles or approaches for this playbook

Example:
[
"ROI-focused approach",
"Security-first messaging",
"Integration benefits"
]
strategicNarrative
string[]

Strategic narrative components for this playbook

Example:
[
"Digital transformation is essential",
"Legacy systems are holding you back"
]
customFields
object[]

Custom fields for additional playbook information

Response

Playbook updated successfully

_metadata
object
required
data
object
required
I