# Submit Deal Application

`deal_applications.submit`

Submit a Deal Application only after reading its application record, answers, and submission readiness. Submission can deliver information and documents to the recipient, advance lifecycle and pipeline state, and notify participants. Explain those effects and every remaining readiness issue before following the transport confirmation flow. Pass both current revisions so the reviewed answers are the ones submitted. After success, read the application again before reporting its state.

[Deal applications guide](https://docs.levr.ai/mcp/resources/deal_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
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "application_id": {
      "description": "Deal Application id returned by deals.get or deals.create. Prefix: dapp_.",
      "maxLength": 255,
      "minLength": 1,
      "type": "string"
    },
    "expected_answers_revision": {
      "description": "answers_revision returned by the latest answers read.",
      "minimum": 0,
      "type": "integer"
    },
    "expected_revision": {
      "description": "revision returned by the latest Deal Application detail read.",
      "minimum": 0,
      "type": "integer"
    },
    "idempotency_key": {
      "format": "uuid",
      "type": "string"
    },
    "provider_slug": {
      "description": "Portal workspace where the Deal Application is available. Copy provider_slug from providers.list; named slugs are valid.",
      "maxLength": 255,
      "minLength": 1,
      "type": "string"
    },
    "user_confirmed": {
      "const": true,
      "type": "boolean"
    }
  },
  "required": [
    "provider_slug",
    "application_id",
    "expected_revision",
    "expected_answers_revision",
    "idempotency_key",
    "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": {
        "answers_revision": {
          "description": "Answer revision required when changing or submitting answers.",
          "minimum": 0,
          "type": "integer"
        },
        "created_at": {
          "format": "date-time",
          "type": "string"
        },
        "frontend_link": {
          "type": "string"
        },
        "id": {
          "description": "Stable public identifier for the referenced resource.",
          "maxLength": 255,
          "minLength": 1,
          "type": "string"
        },
        "object": {
          "const": "deal_application",
          "type": "string"
        },
        "revision": {
          "description": "Deal Application lifecycle revision required for submission.",
          "minimum": 0,
          "type": "integer"
        },
        "status": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "submitted_at": {
          "anyOf": [
            {
              "format": "date-time",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "updated_at": {
          "format": "date-time",
          "type": "string"
        }
      },
      "required": [
        "id",
        "object",
        "revision",
        "answers_revision",
        "status",
        "submitted_at",
        "created_at",
        "updated_at",
        "frontend_link"
      ],
      "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.