---
title: "Invoke a plugin function"
method: POST
path: "/v1/plugins/{pluginId}/invoke"
tags: ["Plugin"]
---

# Invoke a plugin function

`POST /v1/plugins/{pluginId}/invoke`

Dispatch a named function on an enabled plugin. Disabled plugins return 404.

## Request body

- object
  - `function` string, required
  - `scope_id` string, required — Composite or bare resource ID the call is scoped to.
  - `payload` unknown

## Response `200`

OK

- PluginInvokeResult — Result of POST /v1/plugins/{pluginId}/invoke.
  - `ok` boolean, required
  - `error` string
  - `data` unknown

## Other responses

- `400` — Bad request
- `401` — Unauthorized request
- `403` — Forbidden
- `404` — The requested resource not found
- `500` — Internal Server Error

## Changes

- **2026-09-03** `6c0b21e4101e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/opcotech/apis/elemo-api/changes/v1/plugins/:pluginId/invoke/post.md)

---

[API](https://skmtc.dev/opcotech/apis/elemo-api.md) · [All operations](https://skmtc.dev/opcotech/apis/elemo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/opcotech/elemo-api/revisions/6c0b21e4101e/schema)