> ## 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. # Create Proof Point > Create a new proof point ## OpenAPI ````yaml post /api/v2/proof-point/create openapi: 3.0.0 info: version: 1.0.0 title: Octave API description: API for Octave workspace management and AI-powered content generation servers: - url: https://app.octavehq.com security: - ApiKeyAuth: [] paths: /api/v2/proof-point/create: post: tags: - Proof Point summary: Create Proof Point description: Create a new proof point operationId: createProofPoint requestBody: description: Proof point creation input content: application/json: schema: type: object properties: name: type: string minLength: 1 description: The external name of the proof point example: 99% Customer Satisfaction internalName: type: string description: The internal name of the proof point example: Customer Satisfaction Stat - Q4 2024 description: type: string description: A description of the proof point example: Our customer satisfaction rate consistently exceeds 99% type: type: string enum: - stat - fact - quote - award - recognition - other description: The type of proof point example: stat theProof: type: array items: type: string description: >- The complete evidence statement: the actual fact, statistic, claim, metric, achievement or recognition AND where it comes from and when (if available). example: - 99% customer satisfaction rate (annual NPS survey, 2024). whatItSupports: type: array items: type: string description: >- The specific value claims, differentiators, or message this proof point backs up — what links the proof into the broader value story. example: - >- Backs the claim that our customer experience is best-in-class. howWeTalkAboutThis: type: array items: type: string description: Different ways to present or talk about this proof point example: - 99% customer satisfaction rate - Nearly perfect customer satisfaction - Best-in-class customer experience whyItMatters: type: array items: type: string description: >- The strategic frame for why this proof point is compelling: what objection it neutralizes, what doubt it removes, what conviction it builds. example: - Shows customer trust - Demonstrates product quality - Proves our commitment to excellence customFields: allOf: - $ref: '#/components/schemas/CustomDataFields' - description: Custom fields for additional proof point information additionalProperties: type: object additionalProperties: anyOf: - type: string - type: array items: type: string - type: number - type: boolean description: >- Workspace-defined additional property values for this proof point, keyed by property key. example: tier: Enterprise region: APAC primaryOfferingOId: type: string description: >- Primary Offering to use as context when creating proof points. If not provided, the primary company attached to the Workspace will be used. example: o_123456 linkingStrategy: allOf: - $ref: '#/components/schemas/LinkingStrategy' - description: >- Strategy for linking this proof point to offerings (products/services) required: - name responses: '200': description: Proof point created successfully content: application/json: schema: type: object properties: _metadata: $ref: '#/components/schemas/Metadata' data: type: object properties: oId: type: string createdAt: type: string nullable: true format: date-time updatedAt: type: string nullable: true format: date-time deletedAt: type: string nullable: true format: date-time archivedAt: type: string nullable: true format: date-time name: type: string internalName: type: string description: type: string active: type: boolean default: true data: type: object nullable: true properties: theProof: type: array nullable: true items: type: string whatItSupports: type: array nullable: true items: type: string howWeTalkAboutThis: type: array nullable: true items: type: string whyItMatters: type: array nullable: true items: type: string type: type: string enum: - stat - fact - quote - award - recognition - other customFields: $ref: '#/components/schemas/CustomDataFields' additionalProperties: type: object additionalProperties: anyOf: - type: string - type: array items: type: string - type: number - type: boolean user: type: object nullable: true properties: oId: type: string nullable: true firstName: type: string nullable: true description: >- The first name of the user who created the proof point example: John lastName: type: string nullable: true description: >- The last name of the user who created the proof point example: Doe workspace: type: object nullable: true properties: oId: type: string nullable: true required: - oId - createdAt - updatedAt - name - internalName - description required: - _metadata - data '400': description: Bad request content: application/json: schema: type: object properties: _metadata: $ref: '#/components/schemas/Metadata' message: type: string required: - _metadata - message '404': description: Offering not found content: application/json: schema: type: object properties: _metadata: $ref: '#/components/schemas/Metadata' message: type: string required: - _metadata - message deprecated: false components: schemas: CustomDataFields: type: array items: $ref: '#/components/schemas/CustomDataFieldItem' LinkingStrategy: oneOf: - $ref: '#/components/schemas/LinkingStrategyAll' - $ref: '#/components/schemas/LinkingStrategySpecific' discriminator: propertyName: mode mapping: ALL: $ref: '#/components/schemas/LinkingStrategyAll' SPECIFIC: $ref: '#/components/schemas/LinkingStrategySpecific' default: mode: ALL description: Strategy for linking this persona to offerings (products/services) Metadata: type: object properties: usage: type: number default: 0 example: 0 description: API usage requestId: type: string example: requestId description: Request ID message: type: string example: message description: Message timestamp: type: string example: '2021-01-01T00:00:00.000Z' description: Timestamp required: - requestId - timestamp CustomDataFieldItem: type: object properties: title: type: string value: type: array items: type: string required: - title - value LinkingStrategyAll: type: object properties: mode: type: string enum: - ALL description: >- Link to all active offerings in the workspace (products, services, and solutions) example: ALL required: - mode LinkingStrategySpecific: type: object properties: mode: type: string enum: - SPECIFIC description: >- Link to specific offerings by their IDs (products, services, and solutions) example: SPECIFIC offeringOIds: type: array items: type: string minLength: 1 minItems: 1 description: >- Array of offering IDs to link to (supports product, service, and solution oIds) example: - px_123 - sc_456 - sv_789 required: - mode - offeringOIds securitySchemes: ApiKeyAuth: type: apiKey in: header name: api_key ````