# Search operations

> One query across every integration's operations, grouped by service in rank order.

Source: https://docs.generalinput.com/api/integrations/search-operations



<Endpoint method="GET" path="/v1/operations" />

<Access scope="docs:read" />

The one-shot form of "which service and operation does what I need?". Hybrid search (semantic plus lexical) over every documented operation the workspace can use, grouped by service with the best-matching service first.

## Query parameters [#query-parameters]

| Name | Type   | Notes                                                                                            |
| ---- | ------ | ------------------------------------------------------------------------------------------------ |
| `q`  | string | Required. A capability, phrased the way a person would ("create github issue", "list invoices"). |

## Response [#response]

```json
{
  "results": [
    {
      "service": "github",
      "serviceTitle": "GitHub",
      "operations": [
        {
          "id": "9f2a…",
          "title": "Create an Issue",
          "description": "Open a new issue on a repository.",
          "score": 0.93
        }
      ]
    }
  ]
}
```

`score` is the relevance rank in `0..1`. An empty `results` array means no documented operation matches; the service may not be supported for credentialed access.

## Errors [#errors]

| Status | When            |
| ------ | --------------- |
| `400`  | `q` is missing. |