# ✉️ Engagement

Create, send, and track engagement.

 - [POST /gql/v1/engagements](https://dev.docs.api.aiwyn.ai/api/bundle/engagement/getengagements.md): **Project engagement tracking with comprehensive workflow management** **Pagination (v1 — limit/offset):** `pageSize` is a limit (records to return). `page` is an offset (records to skip), not a page
 - [POST /gql/v1/engagements/search](https://dev.docs.api.aiwyn.ai/api/bundle/engagement/searchengagementsdynamic.md): **Search Engagements with Dynamic Filters** **Pagination (v1 — limit/offset):** `pageSize` is a limit (records to return). `page` is an offset (records to skip), not a page index. Hasura maps these as
 - [GET /gql/v1/engagement/{id}](https://dev.docs.api.aiwyn.ai/api/bundle/engagement/getengagementbyid.md): **Retrieve a specific engagement by its unique identifier** This endpoint provides detailed engagement information including: - Complete engagement details and scope - Engagement status and lifecycle
 - [PATCH /api/v1/engagements/{engagementId}](https://dev.docs.api.aiwyn.ai/api/bundle/engagement/updateengagement.md): **Update an existing engagement by ID** Partially updates an engagement. Only the fields included in the request body are modified — omitted fields are left unchanged. At least one field must be provi
 - [POST /api/v1/engagements/create](https://dev.docs.api.aiwyn.ai/api/bundle/engagement/createengagementletter.md): **Create a single engagement letter** Creates an engagement letter for a specific client. The engagement letter will be associated with the specified client, fiscal year, and assigned staff. **Require
 - [POST /api/v1/engagements/batch/create](https://dev.docs.api.aiwyn.ai/api/bundle/engagement/createbatchengagementletters.md): **Create a batch of engagement letters asynchronously** Submits a batch of engagement letter creation requests. The batch is processed asynchronously — use the returned batch ID with the `GET /api/v1/
 - [GET /api/v1/engagements/batch/{batchId}/status](https://dev.docs.api.aiwyn.ai/api/bundle/engagement/getengagementbatchstatus.md): **Retrieve the status of an engagement batch** Returns the current processing status of a previously submitted engagement batch, along with the IDs of any engagements that have been created so far. Us
 - [GET /gql/v1/engagement_documents/by_engagement/{engagementId}](https://dev.docs.api.aiwyn.ai/api/bundle/engagement/getengagementdocumentsbyengagementid.md): **Retrieve documents associated with a specific engagement** Returns all engagement documents linked to the given engagement ID, including the document type name for each record. **Real Example:** ``