Partner API — Apps

naftiko: 1.0.0-alpha2
info:
  label: Partner API — Apps
  description: 'Partner API — Apps. 4 operations. Lead operation: Zapier Get Apps [v1]. Self-contained Naftiko capability
    covering one Zapier business surface.'
  tags:
  - Zapier
  - Apps
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    ZAPIER_API_KEY: ZAPIER_API_KEY
capability:
  consumes:
  - type: http
    namespace: partner-apps
    baseUri: https://api.zapier.com
    description: Partner API — Apps business capability. Self-contained, no shared references.
    resources:
    - name: v1-apps
      path: /v1/apps
      operations:
      - name: v1appslist
        method: GET
        description: Zapier Get Apps [v1]
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: category
          in: query
          type: string
          description: Categories that apps must have in order to be returned in the response
        - name: is_in_zap_template_with
          in: query
          type: string
          description: If set, only return apps that are in a Zap Template with your app
        - name: page
          in: query
          type: number
          description: Which page to return
        - name: per_page
          in: query
          type: number
          description: Number of results to return per page
        - name: title_search
          in: query
          type: string
          description: Case-insensitive parameter to limit the results to apps whose titles match
        - name: title_starts_with
          in: query
          type: string
          description: Case-insensitive parameter to only return apps whose titles start with the parameter value in the response
    - name: v2-actions
      path: /v2/actions
      operations:
      - name: getactions
        method: GET
        description: Zapier Get Actions
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: action_type
          in: query
          type: string
          description: The type of Action to filter for. Defaults to returning all actions regardless of type.
        - name: app
          in: query
          type: string
          description: A canonical App ID, as provided by the `/apps` endpoint.
          required: true
    - name: v2-apps
      path: /v2/apps
      operations:
      - name: getv2apps
        method: GET
        description: Zapier Get Apps [v2]
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: category
          in: query
          type: string
          description: 'Categories that apps must have in order to be returned in the response. '
        - name: ids
          in: query
          type: string
          description: Parameter to restrict the results to apps whose ID matches those in the provided comma-separated value.
            Cannot be combined with `category`.
        - name: limit
          in: query
          type: integer
          description: Used for paginating results. Specifies the maximum number of items to return per page. If this value
            is not set, it defaults to 10.
        - name: offset
          in: query
          type: integer
          description: Used for paginating results. Specifies the offset to use.
        - name: query
          in: query
          type: string
          description: Parameter to limit the results to apps whose titles match the provided query.
    - name: v2-whitelabel-apps
      path: /v2/whitelabel/apps
      operations:
      - name: v2whitelabelappslist
        method: GET
        description: Zapier Get Whitelabel Apps [v2]
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: category
          in: query
          type: string
          description: Filter apps by category slug.
        - name: limit
          in: query
          type: number
          description: Limit the number of apps returned.
        - name: offset
          in: query
          type: number
          description: The number of apps to skip before beginning to return results.
        - name: search
          in: query
          type: string
          description: Case-insensitive search to filter apps by title.
    authentication:
      type: bearer
      token: '{{env.ZAPIER_API_KEY}}'
  exposes:
  - type: rest
    namespace: partner-apps-rest
    port: 8080
    description: REST adapter for Partner API — Apps. One Spectral-compliant resource per consumed operation, prefixed with
      /v1.
    resources:
    - path: /v1/v1/apps
      name: v1-apps
      description: REST surface for v1-apps.
      operations:
      - method: GET
        name: v1appslist
        description: Zapier Get Apps [v1]
        call: partner-apps.v1appslist
        with:
          category: rest.category
          is_in_zap_template_with: rest.is_in_zap_template_with
          page: rest.page
          per_page: rest.per_page
          title_search: rest.title_search
          title_starts_with: rest.title_starts_with
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/actions
      name: v2-actions
      description: REST surface for v2-actions.
      operations:
      - method: GET
        name: getactions
        description: Zapier Get Actions
        call: partner-apps.getactions
        with:
          action_type: rest.action_type
          app: rest.app
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/apps
      name: v2-apps
      description: REST surface for v2-apps.
      operations:
      - method: GET
        name: getv2apps
        description: Zapier Get Apps [v2]
        call: partner-apps.getv2apps
        with:
          category: rest.category
          ids: rest.ids
          limit: rest.limit
          offset: rest.offset
          query: rest.query
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/whitelabel/apps
      name: v2-whitelabel-apps
      description: REST surface for v2-whitelabel-apps.
      operations:
      - method: GET
        name: v2whitelabelappslist
        description: Zapier Get Whitelabel Apps [v2]
        call: partner-apps.v2whitelabelappslist
        with:
          category: rest.category
          limit: rest.limit
          offset: rest.offset
          search: rest.search
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: partner-apps-mcp
    port: 9090
    transport: http
    description: MCP adapter for Partner API — Apps. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: zapier-get-apps-v1
      description: Zapier Get Apps [v1]
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: partner-apps.v1appslist
      with:
        category: tools.category
        is_in_zap_template_with: tools.is_in_zap_template_with
        page: tools.page
        per_page: tools.per_page
        title_search: tools.title_search
        title_starts_with: tools.title_starts_with
      outputParameters:
      - type: object
        mapping: $.
    - name: zapier-get-actions
      description: Zapier Get Actions
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: partner-apps.getactions
      with:
        action_type: tools.action_type
        app: tools.app
      outputParameters:
      - type: object
        mapping: $.
    - name: zapier-get-apps-v2
      description: Zapier Get Apps [v2]
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: partner-apps.getv2apps
      with:
        category: tools.category
        ids: tools.ids
        limit: tools.limit
        offset: tools.offset
        query: tools.query
      outputParameters:
      - type: object
        mapping: $.
    - name: zapier-get-whitelabel-apps-v2
      description: Zapier Get Whitelabel Apps [v2]
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: partner-apps.v2whitelabelappslist
      with:
        category: tools.category
        limit: tools.limit
        offset: tools.offset
        search: tools.search
      outputParameters:
      - type: object
        mapping: $.