---
title: "Invoke"
method: POST
path: "/api/v1/functions/{function_id}/invoke"
tags: ["Function"]
---

# Invoke

`POST /api/v1/functions/{function_id}/invoke`

Invoke executes a function at a specific commit with the provided input data.

## Path parameters

- `function_id` string, required — The ID of the function to invoke.

## Request body

- C1ApiFunctionsV1FunctionsServiceInvokeRequestInput — The FunctionsServiceInvokeRequest message. This message contains a oneof named arg. Only a single field of the following list may be set at a time: - json
  - `commitId` string — The commit ID specifying which version of the function code to run.
  - `json` string, base64, nullable — The JSON-encoded input data passed to the function. This field is part of the `arg` oneof. See the documentation for `c1.api.functions.v1.FunctionsServiceInvokeRequest` for more details.
  - `vfsId` string — Optional VFS volume ID to attach to this invocation. If empty, VFS operations will error.

## Response `200`

Successful response

- C1ApiFunctionsV1FunctionsServiceInvokeResponse — The FunctionsServiceInvokeResponse message. This message contains a oneof named resp. Only a single field of the following list may be set at a time: - json
  - `invocationId` string — The ID of the created invocation, used to track execution status and retrieve results.
  - `json` string, base64, nullable — Deprecated. The JSON-encoded output returned by the function. This field is part of the `resp` oneof. See the documentation for `c1.api.functions.v1.FunctionsServiceInvokeResponse` for more details.

---

[API](https://skmtc.net/conductorone/apis/c1-api.md) · [All operations](https://skmtc.net/conductorone/apis/c1-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/conductorone/c1-api/versions/d391405a35d3/schema)