RudderStack HTTP API — Internal API

naftiko: 1.0.0-alpha2
info:
  label: RudderStack HTTP API — Internal API
  description: 'RudderStack HTTP API — Internal API. 5 operations. Lead operation: Audience List. Self-contained Naftiko capability
    covering one Rudderstack business surface.'
  tags:
  - Rudderstack
  - Internal API
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    RUDDERSTACK_API_KEY: RUDDERSTACK_API_KEY
capability:
  consumes:
  - type: http
    namespace: gateway-internal-api
    baseUri: ''
    description: RudderStack HTTP API — Internal API business capability. Self-contained, no shared references.
    resources:
    - name: internal-v1-audiencelist
      path: /internal/v1/audiencelist
      operations:
      - name: audiencelist
        method: POST
        description: Audience List
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: internal-v1-batch
      path: /internal/v1/batch
      operations:
      - name: internalbatch
        method: POST
        description: Batch
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: internal-v1-extract
      path: /internal/v1/extract
      operations:
      - name: extract
        method: POST
        description: Extract
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: internal-v1-replay
      path: /internal/v1/replay
      operations:
      - name: replay
        method: POST
        description: Replay
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: internal-v1-retl
      path: /internal/v1/retl
      operations:
      - name: retl
        method: POST
        description: Retl
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: basic
      username: '{{env.RUDDERSTACK_USER}}'
      password: '{{env.RUDDERSTACK_PASS}}'
  exposes:
  - type: rest
    namespace: gateway-internal-api-rest
    port: 8080
    description: REST adapter for RudderStack HTTP API — Internal API. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/internal/v1/audiencelist
      name: internal-v1-audiencelist
      description: REST surface for internal-v1-audiencelist.
      operations:
      - method: POST
        name: audiencelist
        description: Audience List
        call: gateway-internal-api.audiencelist
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/internal/v1/batch
      name: internal-v1-batch
      description: REST surface for internal-v1-batch.
      operations:
      - method: POST
        name: internalbatch
        description: Batch
        call: gateway-internal-api.internalbatch
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/internal/v1/extract
      name: internal-v1-extract
      description: REST surface for internal-v1-extract.
      operations:
      - method: POST
        name: extract
        description: Extract
        call: gateway-internal-api.extract
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/internal/v1/replay
      name: internal-v1-replay
      description: REST surface for internal-v1-replay.
      operations:
      - method: POST
        name: replay
        description: Replay
        call: gateway-internal-api.replay
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/internal/v1/retl
      name: internal-v1-retl
      description: REST surface for internal-v1-retl.
      operations:
      - method: POST
        name: retl
        description: Retl
        call: gateway-internal-api.retl
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: gateway-internal-api-mcp
    port: 9090
    transport: http
    description: MCP adapter for RudderStack HTTP API — Internal API. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: audience-list
      description: Audience List
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: gateway-internal-api.audiencelist
      outputParameters:
      - type: object
        mapping: $.
    - name: batch
      description: Batch
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: gateway-internal-api.internalbatch
      outputParameters:
      - type: object
        mapping: $.
    - name: extract
      description: Extract
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: gateway-internal-api.extract
      outputParameters:
      - type: object
        mapping: $.
    - name: replay
      description: Replay
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: gateway-internal-api.replay
      outputParameters:
      - type: object
        mapping: $.
    - name: retl
      description: Retl
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: gateway-internal-api.retl
      outputParameters:
      - type: object
        mapping: $.