# Search Workflow Actions

> Search tenant-permitted platform actions; connection setup is reported separately.

Source: [https://genhealth.ai/docs/workflows/api-reference/v1/workflow-developer-api/search-workflow-actions](https://genhealth.ai/docs/workflows/api-reference/v1/workflow-developer-api/search-workflow-actions)

## Endpoint

`GET /developer/v1/actions`

## Authentication

Send a GenHealth credential in the `Authorization` header:

```http
Authorization: Bearer <YOUR_API_KEY>
Accept: application/json
```

Required scopes: `workflow:read`

## Parameters

| Name | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `query` | query | string \| null | No | Terms such as Brightree patient search or Niko order. |
| `group` | query | string \| null | No | Optional partial integration group name. |
| `limit` | query | integer | No | No description provided. Default: 25. |
| `offset` | query | integer | No | No description provided. Default: 0. |

## Request examples

### cURL

```curl
curl --request GET \
  --url 'https://api.umpa.genhealth.ai/developer/v1/actions?limit=25&offset=0' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Accept: application/json'
```

### JavaScript

```javascript
const response = await fetch('https://api.umpa.genhealth.ai/developer/v1/actions?limit=25&offset=0', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer <YOUR_API_KEY>',
    Accept: 'application/json',
  },
});

const data = await response.json();
```

### Python

```python
import requests

response = requests.get(
    'https://api.umpa.genhealth.ai/developer/v1/actions?limit=25&offset=0',
    headers={
        'Authorization': 'Bearer <YOUR_API_KEY>',
        'Accept': 'application/json',
    },
)

data = response.json()
```

## Responses

| Status | Description |
| --- | --- |
| 200 | Successful Response |
| 422 | Validation Error |

### 200 response example

```json
{
  "success": true,
  "query": "string",
  "group": "string",
  "count": 1,
  "total_matches": 1,
  "offset": 0,
  "has_more": false,
  "next_offset": 1
}
```

### 422 response example

```json
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}
```
