# Invocation

> API reference for invocations (clrk.apoxy.dev/v1alpha1)

**API Group:** `clrk.apoxy.dev/v1alpha1`

## Operations

### List Invocation

<APIEndpoint method="GET" path="/apis/clrk.apoxy.dev/v1alpha1/invocations" />

List Invocation

**Response**

- `200`: OK

---

### List Invocation

<APIEndpoint method="GET" path="/apis/clrk.apoxy.dev/v1alpha1/namespaces/{namespace}/invocations" />

List Invocation

**Response**

- `200`: OK

---

### Create Invocation

<APIEndpoint method="POST" path="/apis/clrk.apoxy.dev/v1alpha1/namespaces/{namespace}/invocations" />

create an Invocation

**Request Body**

Spec fields (`InvocationSpec`):

| Field | Type | Description |
| --- | --- | --- |
| `identity` | [InvocationIdentity](#invocationidentity) | Identity is the resolved identity asserted at ingress. |
| `parentRef` | [InvocationParentRef](#invocationparentref) | ParentRef identifies the TaskAgent or DaemonAgent that owns this Invocation. Required. **(required)** |
| `trigger` | [InvocationTrigger](#invocationtrigger) | Trigger describes how this invocation was initiated. **(required)** |

**Response**

- `200`: OK
- `201`: Created
- `202`: Accepted

---

### Get Invocation

<APIEndpoint method="GET" path="/apis/clrk.apoxy.dev/v1alpha1/namespaces/{namespace}/invocations/{name}" />

Get the specified Invocation

**Response**

- `200`: OK

---

### Replace Invocation

<APIEndpoint method="PUT" path="/apis/clrk.apoxy.dev/v1alpha1/namespaces/{namespace}/invocations/{name}" />

Replace the specified Invocation

**Request Body**

Spec fields (`InvocationSpec`):

| Field | Type | Description |
| --- | --- | --- |
| `identity` | [InvocationIdentity](#invocationidentity) | Identity is the resolved identity asserted at ingress. |
| `parentRef` | [InvocationParentRef](#invocationparentref) | ParentRef identifies the TaskAgent or DaemonAgent that owns this Invocation. Required. **(required)** |
| `trigger` | [InvocationTrigger](#invocationtrigger) | Trigger describes how this invocation was initiated. **(required)** |

**Response**

- `200`: OK
- `201`: Created

---

### Update Invocation

<APIEndpoint method="PATCH" path="/apis/clrk.apoxy.dev/v1alpha1/namespaces/{namespace}/invocations/{name}" />

Partially update the specified Invocation

**Response**

- `200`: OK
- `201`: Created

---

## Schema Reference

### InvocationIdentity

| Field | Type | Description |
| --- | --- | --- |
| `audiences` | string[] |  |

### InvocationParentRef

| Field | Type | Description |
| --- | --- | --- |
| `name` | string |  **(required)** |

### InvocationTrigger

| Field | Type | Description |
| --- | --- | --- |
| `source` | string |  |
| `type` | string |  **(required)** |

---

**Navigation** (CLRK / Reference)

- Previous: [FallbackRoutingPolicy](/docs/clrk/reference/clrk/fallbackroutingpolicies.md)
- Next: [LoggingPolicy](/docs/clrk/reference/clrk/loggingpolicies.md)
- All pages: [index](/docs/llms.txt)