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

# Mythic_rpc_file_search

> Search files



## AsyncAPI

````yaml mythic-docs/mythicrpc/mythicrpc-asyncapi.yaml mythic_rpc_file_search
id: mythic_rpc_file_search
title: Mythic_rpc_file_search
description: Search files
servers:
  - id: development
    protocol: amqp
    host: mythic-rabbitmq:5672
    bindings: []
    variables: []
address: mythic_rpc_file_search
parameters: []
bindings: []
operations:
  - &ref_2
    id: sendFileSearch
    title: Send file search
    description: Send file search request
    type: send
    messages:
      - &ref_4
        id: FileSearchRequest
        contentType: application/json
        payload:
          - name: File Search Request
            description: Search for files
            type: object
            properties:
              - name: task_id
                type: integer
                description: Task ID for scoping
                required: false
              - name: callback_id
                type: integer
                description: Callback ID for scoping
                required: false
              - name: agent_file_id
                type: string
                description: Specific file UUID
                required: false
              - name: filename
                type: string
                description: Filter by filename
                required: false
              - name: limit_by_callback
                type: boolean
                description: Limit results to current callback
                required: false
              - name: max_results
                type: integer
                description: Maximum number of results
                required: false
        headers: []
        jsonPayloadSchema:
          type: object
          description: Search for files
          properties:
            task_id:
              type: integer
              description: Task ID for scoping
              default: 0
              x-parser-schema-id: <anonymous-schema-60>
            callback_id:
              type: integer
              description: Callback ID for scoping
              default: 0
              x-parser-schema-id: <anonymous-schema-61>
            agent_file_id:
              type: string
              format: uuid
              description: Specific file UUID
              default: ''
              x-parser-schema-id: <anonymous-schema-62>
            filename:
              type: string
              description: Filter by filename
              default: ''
              x-parser-schema-id: <anonymous-schema-63>
            limit_by_callback:
              type: boolean
              description: Limit results to current callback
              default: false
              x-parser-schema-id: <anonymous-schema-64>
            max_results:
              type: integer
              description: Maximum number of results
              default: 100
              x-parser-schema-id: <anonymous-schema-65>
          x-parser-schema-id: FileSearchPayload
        title: File Search Request
        description: Search for files
        example: |-
          {
            "task_id": 123,
            "callback_id": 123,
            "agent_file_id": "<string>",
            "filename": "<string>",
            "limit_by_callback": true,
            "max_results": 123
          }
        bindings: []
        extensions:
          - id: x-parser-unique-object-id
            value: FileSearchRequest
    bindings: []
    extensions: &ref_0
      - id: x-parser-unique-object-id
        value: mythic_rpc_file_search
  - &ref_1
    id: receiveFileSearchResponse
    title: Receive file search response
    description: Receive file search response
    type: receive
    messages:
      - &ref_3
        id: FileSearchResponse
        contentType: application/json
        payload:
          - name: File Search Response
            description: Response for file search operation
            type: object
            properties:
              - name: success
                type: boolean
                description: Operation success status
                required: true
              - name: error
                type: string
                description: Error message if success is false
                required: false
              - name: files
                type: array
                description: Array of file objects
                required: false
                properties:
                  - name: agent_file_id
                    type: string
                    required: false
                  - name: filename
                    type: string
                    required: false
                  - name: file_size
                    type: integer
                    required: false
                  - name: comment
                    type: string
                    required: false
                  - name: host
                    type: string
                    required: false
                  - name: full_remote_path
                    type: string
                    required: false
                  - name: timestamp
                    type: string
                    required: false
        headers: []
        jsonPayloadSchema:
          type: object
          properties:
            success:
              type: boolean
              description: Operation success status
              default: true
              x-parser-schema-id: <anonymous-schema-66>
            error:
              type: string
              description: Error message if success is false
              default: ''
              x-parser-schema-id: <anonymous-schema-67>
            files:
              type: array
              description: Array of file objects
              default: []
              items:
                type: object
                properties:
                  agent_file_id:
                    type: string
                    format: uuid
                    default: ''
                    x-parser-schema-id: <anonymous-schema-70>
                  filename:
                    type: string
                    default: ''
                    x-parser-schema-id: <anonymous-schema-71>
                  file_size:
                    type: integer
                    default: 0
                    x-parser-schema-id: <anonymous-schema-72>
                  comment:
                    type: string
                    default: ''
                    x-parser-schema-id: <anonymous-schema-73>
                  host:
                    type: string
                    default: ''
                    x-parser-schema-id: <anonymous-schema-74>
                  full_remote_path:
                    type: string
                    default: ''
                    x-parser-schema-id: <anonymous-schema-75>
                  timestamp:
                    type: string
                    format: date-time
                    default: '2024-01-01T00:00:00Z'
                    x-parser-schema-id: <anonymous-schema-76>
                x-parser-schema-id: <anonymous-schema-69>
              x-parser-schema-id: <anonymous-schema-68>
          required:
            - success
          x-parser-schema-id: FileSearchResponsePayload
        title: File Search Response
        description: Response for file search operation
        example: |-
          {
            "success": true,
            "error": "<string>",
            "files": {
              "agent_file_id": "<string>",
              "filename": "<string>",
              "file_size": 123,
              "comment": "<string>",
              "host": "<string>",
              "full_remote_path": "<string>",
              "timestamp": "<string>"
            }
          }
        bindings: []
        extensions:
          - id: x-parser-unique-object-id
            value: FileSearchResponse
    bindings: []
    extensions: *ref_0
sendOperations:
  - *ref_1
receiveOperations:
  - *ref_2
sendMessages:
  - *ref_3
receiveMessages:
  - *ref_4
extensions:
  - id: x-parser-unique-object-id
    value: mythic_rpc_file_search
securitySchemes: []

````