---
title: "PUT /public/self-serve/v1/application-instance"
method: PUT
path: "/public/self-serve/v1/application-instance"
tags: ["cli_application-instance_self-serve_v1_8"]
---

# PUT /public/self-serve/v1/application-instance

`PUT /public/self-serve/v1/application-instance`

## Request

- Base URL: `https://developers.conduktor.io` (the document declares no server; this is the origin it was published from)
- URL: `https://developers.conduktor.io/public/self-serve/v1/application-instance`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/conduktor/apis/conduktor-console-api/docs/public/self-serve/v1/application-instance/put.ts> (a function with typed inputs; its response is checked against the schema)

Create or update a ApplicationInstance

**Requires a paid license.** Returns 403 Forbidden on Free plan.

## Query parameters

- `dryMode` boolean

## Request body

- ApplicationInstanceResourceV1
  - `apiVersion` string, required
  - `kind` 'ApplicationInstance', required
  - `metadata` ApplicationInstanceMetadata, required
    - `name` string, required
    - `application` string, required
    - `labels` MapLabelKeyString
  - `spec` ApplicationInstanceSpec, required
    - `cluster` string, required
    - `topicPolicyRef` string[]
    - `policyRef` string[]
    - `resources` ResourceWithOwnership[]
      - `type` 'TOPIC' | 'CONSUMER_GROUP' | 'SUBJECT' | 'CONNECTOR' | 'TRANSACTIONAL_ID', required
      - `name` string, required
      - `patternType` 'LITERAL' | 'PREFIXED', required
      - `connectCluster` string
      - `ownershipMode` 'ALL' | 'LIMITED'
    - `applicationManagedServiceAccount` boolean
    - `serviceAccount` string
    - `defaultCatalogVisibility` 'PRIVATE' | 'PUBLIC'

## Response `200`

- ApplicationInstanceApplyResultV1
  - `resource` ApplicationInstanceResourceV1, required
    - `apiVersion` string, required
    - `kind` 'ApplicationInstance', required
    - `metadata` ApplicationInstanceMetadata, required
      - `name` string, required
      - `application` string, required
      - `labels` MapLabelKeyString
    - `spec` ApplicationInstanceSpec, required
      - `cluster` string, required
      - `topicPolicyRef` string[]
      - `policyRef` string[]
      - `resources` ResourceWithOwnership[]
        - `type` 'TOPIC' | 'CONSUMER_GROUP' | 'SUBJECT' | 'CONNECTOR' | 'TRANSACTIONAL_ID', required
        - `name` string, required
        - `patternType` 'LITERAL' | 'PREFIXED', required
        - `connectCluster` string
        - `ownershipMode` 'ALL' | 'LIMITED'
      - `applicationManagedServiceAccount` boolean
      - `serviceAccount` string
      - `defaultCatalogVisibility` 'PRIVATE' | 'PUBLIC'
  - `upsertResult` 'Created' | 'Updated' | 'NotChanged', required

## Other responses

- `400`: The request is not valid
- `401`: The user is not authenticated
- `403`: The user doesn't have sufficient privilege to do this operation
- `404`: No application-instance with this technical id exists
- `409`: The request does not match one of the business rules
- `500`: An unexpected error occurred in the server

---

[API](https://skmtc.dev/conduktor/apis/conduktor-console-api.md) - [All operations](https://skmtc.dev/conduktor/apis/conduktor-console-api/llms.txt) - [OpenAPI document](https://skmtc.dev/conduktor/apis/conduktor-console-api/revisions/24750c294805?raw)