action asuarez_src_searchly_api_v1_controllers_song_search {
  label: "API endpoint to search songs from the database given a query"
  description: "Endpoint for an end-user client to search songs from the database given a String query.\n\nIf you want to run the /song/search operation, you can do so via an HTTP GET command to the following URL:\n\n```\nhttps://searchly.asuarez.dev/api/v1/song/search\n```\n"
  provider: asuarez
  method: GET
  path: "/song/search"
  encoding: json
  input: {
    type: "object"
    properties: {
      query: {
        type: "string"
      }
    }
    required: ["query"]
    additionalProperties: false
  }
  output: {
    type: "object"
    properties: {
      error: {
        type: "boolean"
        description: "Whether or not the request was successfully processed or not."
      }
      message: {
        type: "string"
        description: "Error message if the request was unsuccessful."
      }
      response: {
        type: "object"
        description: "Contains the response data if the request was successful."
        properties: {
          results: {
            type: "array"
            description: "Contains all the songs."
            items: {
              type: "object"
              description: "Song item."
              properties: {
                id: {
                  type: "integer"
                  description: "Song internal identifier."
                }
                name: {
                  type: "string"
                  description: "Song and Artist name."
                }
              }
            }
          }
        }
      }
    }
  }
}