Webex Admin — Identity Organization

naftiko: 1.0.0-alpha2
info:
  label: Webex Admin — Identity Organization
  description: 'Webex Admin — Identity Organization. 3 operations. Lead operation: Get an organization. Self-contained Naftiko
    capability covering one Webex business surface.'
  tags:
  - Webex
  - Identity Organization
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    WEBEX_API_KEY: WEBEX_API_KEY
capability:
  consumes:
  - type: http
    namespace: admin-identity-organization
    baseUri: ''
    description: Webex Admin — Identity Organization business capability. Self-contained, no shared references.
    resources:
    - name: identity-organizations-orgId
      path: /identity/organizations/{orgId}
      operations:
      - name: getanorganization
        method: GET
        description: Get an organization
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgId
          in: path
          type: string
          description: Webex Identity assigned organization identifier.
          required: true
      - name: updateanorganization
        method: PATCH
        description: Update an organization
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgId
          in: path
          type: string
          description: Webex Identity assigned organization identifier.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: identity-organizations-orgId-users-userId-actions-generateOtp
      path: /identity/organizations/{orgId}/users/{userId}/actions/generateOtp
      operations:
      - name: generateotp
        method: POST
        description: Generate OTP
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orgId
          in: path
          type: string
          description: The Webex Identity-assigned organization identifier for a user's organization.
          required: true
        - name: userId
          in: path
          type: string
          description: The Common Identity-assigned user identifier for an existing user (`entryUUID`).
          required: true
    authentication:
      type: bearer
      token: '{{env.WEBEX_API_KEY}}'
  exposes:
  - type: rest
    namespace: admin-identity-organization-rest
    port: 8080
    description: REST adapter for Webex Admin — Identity Organization. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/identity/organizations/{orgid}
      name: identity-organizations-orgid
      description: REST surface for identity-organizations-orgId.
      operations:
      - method: GET
        name: getanorganization
        description: Get an organization
        call: admin-identity-organization.getanorganization
        with:
          orgId: rest.orgId
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: updateanorganization
        description: Update an organization
        call: admin-identity-organization.updateanorganization
        with:
          orgId: rest.orgId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/identity/organizations/{orgid}/users/{userid}/actions/generateotp
      name: identity-organizations-orgid-users-userid-actions-generateotp
      description: REST surface for identity-organizations-orgId-users-userId-actions-generateOtp.
      operations:
      - method: POST
        name: generateotp
        description: Generate OTP
        call: admin-identity-organization.generateotp
        with:
          orgId: rest.orgId
          userId: rest.userId
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: admin-identity-organization-mcp
    port: 9090
    transport: http
    description: MCP adapter for Webex Admin — Identity Organization. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: get-organization
      description: Get an organization
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: admin-identity-organization.getanorganization
      with:
        orgId: tools.orgId
      outputParameters:
      - type: object
        mapping: $.
    - name: update-organization
      description: Update an organization
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: admin-identity-organization.updateanorganization
      with:
        orgId: tools.orgId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: generate-otp
      description: Generate OTP
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: admin-identity-organization.generateotp
      with:
        orgId: tools.orgId
        userId: tools.userId
      outputParameters:
      - type: object
        mapping: $.