# Change application status

`client_intake_applications.change_status`

Record one shared application lifecycle change using client_intake_applications.review_status_change first. Use the same application, target status and optional destination stage as reviewed. Choose optional communication recipients explicitly; review suggestions are not consent. Automatic effects still apply with recipients=[]. This operation owns status, stage synchronization, history and communications together. It does not deliver or submit an application. Retry identical arguments with the same idempotency key. Delivery is not verified by the receipt. Read businesses.get afterwards to verify.

[Intake applications guide](https://docs.levr.ai/mcp/resources/client_intake_applications.md)

Availability depends on live discovery and your access to the record. Do not infer MCP calls from REST paths.

Operation: write. Required OAuth scopes: mcp.

## Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "application_id": {
      "description": "Client Intake Application ID (ciappl_): copy client_intake_application.id from businesses.get.",
      "pattern": "^ciappl_[a-z0-9]+$",
      "type": "string"
    },
    "destination_stage_id": {
      "description": "Optional stage for your provider, from stage configuration. Must map to the target status and belong to the current pipeline. Omit to respect existing status-to-stage synchronization preferences.",
      "pattern": "^bstg_[a-z0-9]+$",
      "type": "string"
    },
    "idempotency_key": {
      "format": "uuid",
      "type": "string"
    },
    "message": {
      "maxLength": 4000,
      "type": "string"
    },
    "provider_slug": {
      "description": "Provider slug returned by providers.list; reuse a known value. Named slugs are valid.",
      "pattern": "^[a-zA-Z0-9_-]{1,64}$",
      "type": "string"
    },
    "recipients": {
      "description": "Copy each selected email AND origin from the review’s recipients. [] selects none; automatic effects still apply.",
      "items": {
        "additionalProperties": false,
        "properties": {
          "email": {
            "format": "email",
            "maxLength": 254,
            "type": "string"
          },
          "origin": {
            "maxLength": 50,
            "type": "string"
          }
        },
        "required": [
          "email",
          "origin"
        ],
        "type": "object"
      },
      "maxItems": 100,
      "type": "array",
      "uniqueItems": true
    },
    "review_token": {
      "maxLength": 4096,
      "minLength": 1,
      "type": "string"
    },
    "target_status": {
      "description": "pre_submitted: Reopen intake; retains historical submission timestamp; action_required: Request further intake work; completed: Intake completed; withdrawn: Intake withdrawn; closed_not_proceeding: Close without proceeding",
      "enum": [
        "pre_submitted",
        "action_required",
        "completed",
        "withdrawn",
        "closed_not_proceeding"
      ],
      "type": "string"
    },
    "user_confirmed": {
      "const": true,
      "type": "boolean"
    }
  },
  "required": [
    "application_id",
    "target_status",
    "provider_slug",
    "review_token",
    "idempotency_key",
    "recipients",
    "user_confirmed"
  ],
  "type": "object"
}
```

## Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "oneOf": [
    {
      "not": {
        "required": [
          "error"
        ]
      },
      "properties": {
        "ok": {
          "const": true
        }
      },
      "required": [
        "data"
      ]
    },
    {
      "not": {
        "required": [
          "data"
        ]
      },
      "properties": {
        "ok": {
          "const": false
        }
      },
      "required": [
        "error"
      ]
    }
  ],
  "properties": {
    "data": {
      "additionalProperties": false,
      "properties": {
        "application_id": {
          "type": "string"
        },
        "communications": {
          "additionalProperties": false,
          "properties": {
            "automatic_effects": {
              "items": {
                "type": "string"
              },
              "maxItems": 10,
              "type": "array"
            },
            "delivery_status": {
              "const": "not_verified",
              "type": "string"
            },
            "requested_recipients": {
              "items": {
                "additionalProperties": false,
                "properties": {
                  "email": {
                    "format": "email",
                    "maxLength": 254,
                    "type": "string"
                  },
                  "origin": {
                    "maxLength": 50,
                    "type": "string"
                  }
                },
                "required": [
                  "email",
                  "origin"
                ],
                "type": "object"
              },
              "maxItems": 100,
              "type": "array",
              "uniqueItems": true
            }
          },
          "required": [
            "requested_recipients",
            "delivery_status",
            "automatic_effects"
          ],
          "type": "object"
        },
        "frontend_link": {
          "format": "uri",
          "type": "string"
        },
        "revision": {
          "minimum": 0,
          "type": "integer"
        },
        "stage": {
          "anyOf": [
            {
              "additionalProperties": false,
              "properties": {
                "id": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "name"
              ],
              "type": "object"
            },
            {
              "type": "null"
            }
          ]
        },
        "status": {
          "type": "string"
        }
      },
      "required": [
        "application_id",
        "status",
        "revision",
        "stage",
        "frontend_link",
        "communications"
      ],
      "type": "object"
    },
    "error": {
      "additionalProperties": false,
      "properties": {
        "code": {
          "type": "string"
        },
        "details": {
          "additionalProperties": true,
          "description": "Optional bounded, agent-safe correction or recovery facts.",
          "type": "object"
        },
        "message": {
          "type": "string"
        },
        "retryable": {
          "type": "boolean"
        }
      },
      "required": [
        "code",
        "message",
        "retryable"
      ],
      "type": "object"
    },
    "meta": {
      "additionalProperties": false,
      "properties": {
        "request_id": {
          "type": "string"
        }
      },
      "required": [
        "request_id"
      ],
      "type": "object"
    },
    "ok": {
      "description": "Whether the tool completed successfully.",
      "type": "boolean"
    }
  },
  "required": [
    "ok",
    "meta"
  ],
  "type": "object"
}
```

Check the result, then read the affected record to confirm your change.