@zapier/zapier-sdk-core 0.3.0 → 0.5.0

package/openapi.yaml

@@ -11,6 +11,10 @@ info:
   description: The Zapier SDK API serves as a backend for the Zapier SDK.
 servers: []
 tags:
+  - name: Actions
+    description: Action-related routes
+  - name: Apps
+    description: App-related routes
   - name: Authentications
     description: Authentication-related routes
   - name: Documentation
@@ -282,6 +286,66 @@ components:
           $ref: "#/components/schemas/AuthenticationItem"
       required:
         - data
+    ListActionsResponse:
+      type: object
+      properties:
+        data:
+          type: array
+          items:
+            type: object
+            properties:
+              id:
+                type: string
+                description: Unique identifier for the action
+              key:
+                type: string
+                description: Unique key identifier for the action
+              description:
+                type: string
+                description: Description of what the action does
+              is_important:
+                type: boolean
+                description: Whether this action is marked as important
+              is_hidden:
+                type: boolean
+                description: Whether this action is hidden from listings
+              app_key:
+                type: string
+                description: App key extracted from implementation ID (without version)
+              app_version:
+                type: string
+                description: App version extracted from implementation ID
+              action_type:
+                type: string
+                enum:
+                  - filter
+                  - read
+                  - read_bulk
+                  - run
+                  - search
+                  - search_and_write
+                  - search_or_write
+                  - write
+                description: The type of action
+              title:
+                type: string
+                description: Display name of the action (mapped from name)
+              type:
+                type: string
+                enum:
+                  - action
+                description: Type identifier for this item
+            required:
+              - key
+              - description
+              - app_key
+              - action_type
+              - title
+              - type
+            description: Normalized action item returned by list actions endpoint
+          description: Array of action items
+      required:
+        - data
     ListAuthenticationsResponse:
       type: object
       properties:
@@ -505,8 +569,7 @@ paths:
         - userJwt: []
       parameters:
         - schema:
-            type: integer
-            exclusiveMinimum: 0
+            type: string
             description: Authentication ID to retrieve
           required: true
           description: Authentication ID to retrieve
@@ -541,6 +604,333 @@ paths:
           headers: *a6
           content:
             application/json: *a7
+  /api/v0/actions:
+    get:
+      summary: List actions
+      description: Returns a list of actions for a specific app with optional filtering by action type.
+      tags:
+        - Actions
+      operationId: v0_list_actions
+      security:
+        - userJwt: []
+      parameters:
+        - schema:
+            type: string
+            description: App key to list actions for (e.g., 'SlackCLIAPI@1.21.1' or 'SlackCLIAPI')
+          required: true
+          description: App key to list actions for (e.g., 'SlackCLIAPI@1.21.1' or 'SlackCLIAPI')
+          name: appKey
+          in: query
+        - schema:
+            type: string
+            enum:
+              - filter
+              - read
+              - read_bulk
+              - run
+              - search
+              - search_and_write
+              - search_or_write
+              - write
+            description: Filter actions by type (e.g., 'read', 'write', 'search')
+          required: false
+          description: Filter actions by type (e.g., 'read', 'write', 'search')
+          name: actionType
+          in: query
+      responses:
+        "200":
+          description: Successfully retrieved actions list
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ListActionsResponse"
+        "400":
+          description: Bad Request
+          content:
+            application/json: *a1
+        "401":
+          description: Unauthorized
+          content:
+            application/json: *a2
+        "429":
+          description: Too Many Requests
+          headers: *a3
+          content:
+            application/json: *a4
+        "500":
+          description: Server Error
+          content:
+            application/json: *a5
+        "503":
+          description: Service Unavailable
+          headers: *a6
+          content:
+            application/json: *a7
+  /api/v0/apps:
+    get:
+      summary: List apps
+      description: Returns a paginated list of apps with optional filtering by app keys or search term.
+      tags:
+        - Apps
+      operationId: v0_list_apps
+      security:
+        - userJwt: []
+      parameters:
+        - schema:
+            type: string
+            description: Comma-separated list of app keys to filter by (e.g., 'SlackCLIAPI' or slugs like 'github,slack')
+          required: false
+          description: Comma-separated list of app keys to filter by (e.g., 'SlackCLIAPI' or slugs like 'github,slack')
+          name: appKeys
+          in: query
+        - schema:
+            type: string
+            description: Search term to filter apps by name
+          required: false
+          description: Search term to filter apps by name
+          name: search
+          in: query
+        - schema:
+            type: integer
+            minimum: 1
+            maximum: 100
+            default: 20
+            description: Number of apps per page (1-100)
+          required: false
+          description: Number of apps per page (1-100)
+          name: pageSize
+          in: query
+        - schema:
+            type: string
+            description: Pagination offset from previous response
+          required: false
+          description: Pagination offset from previous response
+          name: offset
+          in: query
+      responses:
+        "200":
+          description: Successfully retrieved apps list
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  data:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        slug:
+                          type: string
+                          description: URL-friendly slug identifier
+                        age_in_days:
+                          type: number
+                          description: Number of days since the implementation was created
+                        auth_type:
+                          type: string
+                          description: Authentication type (e.g., oauth2, api_key)
+                        banner:
+                          type: string
+                          description: Banner message or status indicator
+                        categories:
+                          type: array
+                          items:
+                            type: object
+                            properties:
+                              id:
+                                type: number
+                                description: Unique identifier for the category
+                              name:
+                                type: string
+                                description: Display name of the category
+                              slug:
+                                type: string
+                                description: URL-friendly slug for the category
+                            required:
+                              - id
+                              - name
+                              - slug
+                          description: Categories the implementation belongs to
+                        images:
+                          type: object
+                          properties:
+                            url_16x16:
+                              type: string
+                              description: 16x16 pixel icon URL
+                            url_32x32:
+                              type: string
+                              description: 32x32 pixel icon URL
+                            url_64x64:
+                              type: string
+                              description: 64x64 pixel icon URL
+                            url_128x128:
+                              type: string
+                              description: 128x128 pixel icon URL
+                          description: Icon images at various sizes
+                        popularity:
+                          type: number
+                          description: Popularity score for ranking apps
+                        has_filters:
+                          type: boolean
+                          description: Whether the app has filter actions
+                        has_reads:
+                          type: boolean
+                          description: Whether the app has read actions
+                        has_searches:
+                          type: boolean
+                          description: Whether the app has search actions
+                        has_searches_or_writes:
+                          type: boolean
+                          description: Whether the app has search or write actions
+                        has_upfront_fields:
+                          type: boolean
+                          description: Whether the app has upfront input fields
+                        has_writes:
+                          type: boolean
+                          description: Whether the app has write actions
+                        is_beta:
+                          type: boolean
+                          description: Whether the app is in beta
+                        is_built_in:
+                          type: boolean
+                          description: Whether the app is a built-in Zapier app
+                        is_deprecated:
+                          type: boolean
+                          description: Whether the app is deprecated
+                        is_featured:
+                          type: boolean
+                          description: Whether the app is featured
+                        is_hidden:
+                          type: boolean
+                          description: Whether the app is hidden from listings
+                        is_invite:
+                          type: boolean
+                          description: Whether the app is invite-only
+                        is_premium:
+                          type: boolean
+                          description: Whether the app requires a premium plan
+                        is_public:
+                          type: boolean
+                          description: Whether the app is publicly available
+                        is_upcoming:
+                          type: boolean
+                          description: Whether the app is upcoming/not yet released
+                        version:
+                          type: string
+                          description: App version
+                        visibility:
+                          type: string
+                          description: Visibility status (e.g., public, private)
+                        actions:
+                          type: object
+                          properties:
+                            read:
+                              type: number
+                              description: Number of read actions
+                            read_bulk:
+                              type: number
+                              description: Number of bulk read actions
+                            write:
+                              type: number
+                              description: Number of write actions
+                            search:
+                              type: number
+                              description: Number of search actions
+                            search_or_write:
+                              type: number
+                              description: Number of search-or-write actions
+                            search_and_write:
+                              type: number
+                              description: Number of search-and-write actions
+                            filter:
+                              type: number
+                              description: Number of filter actions
+                          description: Count of available actions by type
+                        description:
+                          type: string
+                          description: Description of the app
+                        primary_color:
+                          type: string
+                          description: Primary brand color (hex)
+                        secondary_color:
+                          type: string
+                          description: Secondary brand color (hex)
+                        classification:
+                          type: string
+                          description: App classification category
+                        api_docs_url:
+                          type: string
+                          description: URL to API documentation
+                        image:
+                          type: string
+                          description: Default image URL for the app
+                        title:
+                          type: string
+                          description: Display name of the app
+                        key:
+                          type: string
+                          description: App key (versionless implementation name)
+                        implementation_id:
+                          type: string
+                          description: Full implementation ID including version
+                      required:
+                        - slug
+                        - title
+                        - key
+                        - implementation_id
+                    description: Array of app items
+                  links:
+                    type: object
+                    properties:
+                      next:
+                        type:
+                          - string
+                          - "null"
+                        description: Fully qualified URL for the next page of results (if available)
+                    description: Pagination links for navigating through results
+                  meta:
+                    type: object
+                    properties:
+                      count:
+                        type: number
+                        description: Number of items in current page
+                      limit:
+                        type: number
+                        description: Number of items per page
+                      offset:
+                        type: number
+                        description: Offset of the current page
+                    required:
+                      - count
+                      - limit
+                      - offset
+                    description: Metadata for the paginated result set
+                required:
+                  - data
+                  - links
+                  - meta
+        "400":
+          description: Bad Request
+          content:
+            application/json: *a1
+        "401":
+          description: Unauthorized
+          content:
+            application/json: *a2
+        "429":
+          description: Too Many Requests
+          headers: *a3
+          content:
+            application/json: *a4
+        "500":
+          description: Server Error
+          content:
+            application/json: *a5
+        "503":
+          description: Service Unavailable
+          headers: *a6
+          content:
+            application/json: *a7
   /api/v0/authentications:
     get:
       summary: List authentications

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zapier/zapier-sdk-core",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Core schemas and TypeScript types for the Zapier SDK API",
   "license": "SEE LICENSE IN LICENSE",
   "author": "Zapier, Inc.",
@@ -31,11 +31,26 @@
       "import": "./dist/v0/schemas/authentications.js",
       "require": "./dist/v0/schemas/authentications.cjs"
     },
+    "./v0/schemas/apps": {
+      "types": "./dist/v0/schemas/apps.d.ts",
+      "import": "./dist/v0/schemas/apps.js",
+      "require": "./dist/v0/schemas/apps.cjs"
+    },
+    "./v0/schemas/implementations": {
+      "types": "./dist/v0/schemas/implementations.d.ts",
+      "import": "./dist/v0/schemas/implementations.js",
+      "require": "./dist/v0/schemas/implementations.cjs"
+    },
     "./v0/schemas/errors": {
       "types": "./dist/v0/schemas/errors.d.ts",
       "import": "./dist/v0/schemas/errors.js",
       "require": "./dist/v0/schemas/errors.cjs"
     },
+    "./v0/schemas/actions": {
+      "types": "./dist/v0/schemas/actions.d.ts",
+      "import": "./dist/v0/schemas/actions.js",
+      "require": "./dist/v0/schemas/actions.cjs"
+    },
     "./v0/common/responses": {
       "types": "./dist/v0/common/responses.d.ts",
       "import": "./dist/v0/common/responses.js",