---
title: "Invoke a capability (name@version)"
method: POST
path: "/v1/capabilities/{key}:invoke"
tags: ["capabilities"]
---

# Invoke a capability (name@version)

`POST /v1/capabilities/{key}:invoke`

## Request

- Base URL: `https://api.claims.zicron.ai`
- URL: `https://api.claims.zicron.ai/v1/capabilities/{key}:invoke`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `zicron_session`

## Path parameters

- `key` string, required

## Headers

- `Idempotency-Key` string, nullable

## Request body

- InvokeRequest
  - `input` unknown
  - `dry_run` boolean
  - `intent` string, nullable: Why; required with confirmed=true for high/critical blast.
  - `confirmed` boolean

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/zicron/apis/zicron-api.md) · [All operations](https://skmtc.dev/zicron/apis/zicron-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zicron/apis/zicron-api/revisions/abe62e22aa46?raw)