# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for AI Governance - AI Governance Attribute Management API
  version: 1.0.0
extends: openapi/onetrust-attribute-management-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 4
- target: $.paths['/api/ai-governance/v1/schema-attribute-options'].post
  update:
    x-apievangelist-phrasing:
      intent: Add options to an attribute
      effect: write
      questions:
      - How do I add choices to a picklist attribute on AI models?
      - Can I extend an existing AI governance attribute with new options?
      instructions:
      - text: Add options to attribute {attributeId}.
        slots:
          attributeId: query.attributeId
      - text: Append new picklist choices to AI governance attribute {attributeId}.
        slots:
          attributeId: query.attributeId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/ai-governance/v1/schema-attributes'].post
  update:
    x-apievangelist-phrasing:
      intent: Add an attribute to a schema
      effect: write
      questions:
      - How do I add a custom field to the AI system or dataset schema?
      - Can a new schema attribute be required or allow an Other answer?
      instructions:
      - text: Add attribute {name} with field {fieldName} and response type {responseType} to schema {schemaName}.
        slots:
          name: requestBody.name
          fieldName: requestBody.fieldName
          responseType: requestBody.responseType
          schemaName: query.schemaName
      - text: 'Add attribute {name} ({fieldName}, {responseType}) to {schemaName} and mark it required: {required}.'
        slots:
          name: requestBody.name
          fieldName: requestBody.fieldName
          responseType: requestBody.responseType
          schemaName: query.schemaName
          required: requestBody.required
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/ai-governance/v1/schema-attributes/{attributeId}/disable'].put
  update:
    x-apievangelist-phrasing:
      intent: Disable a schema attribute
      effect: write
      questions:
      - How do I hide an attribute from AI governance forms?
      - Can I turn off a schema attribute without deleting it?
      instructions:
      - text: Disable attribute {attributeId} in schema {schemaId}.
        slots:
          attributeId: path.attributeId
          schemaId: query.schemaId
      - text: Turn off attribute {attributeId} on schema {schemaId}.
        slots:
          attributeId: path.attributeId
          schemaId: query.schemaId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/ai-governance/v1/schema-attributes/{attributeId}/enable'].put
  update:
    x-apievangelist-phrasing:
      intent: Enable a schema attribute
      effect: write
      questions:
      - How do I re-enable an attribute I previously disabled?
      - Can I switch a schema attribute back on for AI models?
      instructions:
      - text: Enable attribute {attributeId} in schema {schemaId}.
        slots:
          attributeId: path.attributeId
          schemaId: query.schemaId
      - text: Turn attribute {attributeId} back on for schema {schemaId}.
        slots:
          attributeId: path.attributeId
          schemaId: query.schemaId
      method: generated
      generated: '2026-09-26'