> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zapier.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Find an action

> Search for Zapier actions by app, ordered by relevancy.



## OpenAPI

````yaml get /api/v2/apps/{app}/actions/
openapi: 3.1.0
info:
  title: Zapier AI Actions API V2
  version: 1.0.0
  description: ''
servers:
  - url: https://actions.zapier.com
security: []
paths:
  /api/v2/apps/{app}/actions/:
    get:
      tags:
        - actions
      summary: Search Actions
      description: Search for Zapier actions by app, ordered by relevancy.
      operationId: api_search_search_actions
      parameters:
        - in: path
          name: app
          schema:
            description: The application to list actions for.
            title: App
            type: string
          required: true
          description: The application to list actions for.
        - in: query
          name: query
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Query for actions to search for. If this is not provided, all
              actions for the `app` will be returned.
            title: Query
          required: false
          description: >-
            Query for actions to search for. If this is not provided, all
            actions for the `app` will be returned.
        - in: query
          name: filter_action_type
          schema:
            default:
              - write
              - search
            description: >

              Filter actions by type. This should be a comma-separated list of
              action types.
                                                  
              This can be:

              - `write`: Actions that have side effects (such as sending an
              email or updating a spreadsheet)

              - `search`: Actions that return results (such as searching for a
              contact or getting a list of emails)
            items:
              enum:
                - read
                - write
                - search
                - read_bulk
              title: ActionType
              type: string
            title: Filter Action Type
            type: array
            uniqueItems: true
          required: false
          description: >

            Filter actions by type. This should be a comma-separated list of
            action types.
                                                
            This can be:

            - `write`: Actions that have side effects (such as sending an email
            or updating a spreadsheet)

            - `search`: Actions that return results (such as searching for a
            contact or getting a list of emails)
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResults_ActionSchema_'
      security:
        - AccessPointApiKeyHeader: []
        - AccessPointOAuth: []
components:
  schemas:
    GenericResults_ActionSchema_:
      additionalProperties: true
      properties:
        results:
          items:
            $ref: '#/components/schemas/ActionSchema'
          title: Results
          type: array
      required:
        - results
      title: GenericResults[ActionSchema]
      type: object
    ActionSchema:
      properties:
        app:
          description: >

            The key for the app that this action belongs to.


            This is used to reference the app throughout AI
            Actions.                     
          title: App
          type: string
        action:
          description: >

            The key for the action itself.
                                    
            This, along with `app` and `type`, is used to reference the action
            throughout AI Actions. 
          title: Action
          type: string
        type:
          allOf:
            - $ref: '#/components/schemas/ActionType'
          description: >

            The type of the action.
                                  
            This can be:

            - `write`: Actions that have side effects (such as sending an email
            or updating a spreadsheet)

            - `search`: Actions that return results (such as searching for a
            contact or getting a list of emails)
        display_name:
          description: The name of the action.
          title: Display Name
          type: string
        description:
          description: The description of the action.
          title: Description
          type: string
        search_relevancy_score:
          description: >-
            If a search query is provided this will be the relevancy that the
            action has to the query, between 0 and 1.
          title: Search Relevancy Score
          type: number
        app_info:
          anyOf:
            - $ref: '#/components/schemas/AppSchema'
            - type: 'null'
          description: Information about the app that this action belongs to.
        app_needs_auth:
          description: >

            If this is true, then an `authentication_id` must be provided when
            running this action.


            Authentications available to the user can be listed using the [List
            Authentications For
            App](/docs/api-reference/actions/list-authentications-for-app)
            endpoint.
          title: App Needs Auth
          type: boolean
      required:
        - app
        - action
        - type
        - display_name
        - description
        - search_relevancy_score
        - app_info
        - app_needs_auth
      title: ActionSchema
      type: object
    ActionType:
      enum:
        - read
        - write
        - search
        - read_bulk
      title: ActionType
      type: string
    AppSchema:
      properties:
        app:
          description: >

            The key for the app.


            This is used to reference the app throughout AI
            Actions.                     
          title: App
          type: string
        name:
          description: The name of the app.
          title: Name
          type: string
        logo_url:
          description: URL of the logo for the app.
          title: Logo Url
          type: string
        auth_type:
          anyOf:
            - type: string
            - type: 'null'
          description: >

            The type of authentication that the app uses.
                                              
            If this is `null`, then it means that the app does not require
            authentication.
          title: Auth Type
        actions:
          additionalProperties:
            type: integer
          description: |

            The actions available for the app with their respective counts.
          title: Actions
          type: object
      required:
        - app
        - name
        - logo_url
        - auth_type
        - actions
      title: AppSchema
      type: object
  securitySchemes:
    AccessPointApiKeyHeader:
      type: apiKey
      in: header
      name: x-api-key
    AccessPointOAuth:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: /oauth/authorize/
          tokenUrl: /oauth/token/
          scopes:
            nla:exposed_actions:execute: Run AI Actions
            openid: OpenID Connect scope

````