# recruiting.applications.summarize

Have AI summarize an application against the posting (a short summary, strengths, gaps and questions to ask), when the posting has aiAssist on, with applicationId and idempotencyKey. It never scores, ranks or decides; people make every decision. Administrators and the hiring manager only.

`POST /api/v1/accounting/recruiting.applications.summarize`

Permissions: `accounting:read`, `accounting:write` · Roles: admin, finance, contributor · Idempotency key required

MCP tool: `accounting_recruiting_applications_summarize`

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `applicationId` | string (ID) | Yes | The ID of the related record. |
| `idempotencyKey` | string | Yes | Any unique text you generate once per intended change, so a retried request only happens once. Send it as the Idempotency-Key header instead if you prefer; if you send both they must match. 8–200 characters. |

## Example request

```bash
curl https://app.getoatmilk.com/api/v1/accounting/recruiting.applications.summarize \
  -H "Authorization: Bearer $OATMILK_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "applicationId": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d"
}'
```

Reference page: https://app.getoatmilk.com/docs/api/recruiting.applications.summarize