# Execute a Bot by identifier

Canonical page: https://docs.ovok.com/primitives/execute-bot-by-identifier

Execute a Bot selected by its FHIR `identifier`, instead of supplying the Bot resource ID. The input body and output are defined by the selected Bot.

| Method | Path |
| --- | --- |
| `POST` | `/fhir/R4/Bot/$execute?identifier=` |

## Request [#request]

The `identifier` query value identifies the Bot, commonly as `system|value`. URL-encode the complete identifier value.

```bash
curl --request POST \
  --url 'https://api.sandbox.ovok.com/fhir/R4/Bot/$execute?identifier=https%3A%2F%2Fexample.org%2Fbot-id%7Cnightly-summary' \
  --header "Authorization: Bearer ${OVOK_TOKEN}" \
  --header 'Content-Type: application/json' \
  --data '{"date":"2026-10-05"}'
```

| Request part | Description |
| --- | --- |
| `identifier` | Bot identifier query parameter. Encode reserved characters such as `:` and `|`. |
| Body | JSON input consumed by the Bot. The required shape depends on the Bot. |

## Response [#response]

The response body and content type are determined by the Bot. A request using `Prefer: respond-async` may return `202 Accepted` with a job location; follow that location to check completion.
