operation post api v1 assignments extend.md

Extend an assignment

POST /api/v1/assignments/extend

Extends an existing assignment based on the provided job ID. Sets a new end date for bound coverage. If you attempt to extend after coverage has ended, or the end date is invalid, the request will fail. Updating end_date on a bound assignment via PUT is not supported; use this endpoint instead.

Certificate of Insurance (COI) regeneration: When extending coverage, COI PDFs are regenerated asynchronously to reflect the new end date. The response returns immediately with certificate_refresh_pending: true, indicating that:

This async design ensures the API responds quickly without blocking for PDF generation.

Servers

Parameters

Body: application/json (object)

Responses

200

Assignment end date updated, or unchanged (no-op) when end_date matches the current value. COIs are always regenerated asynchronously, so the response includes certificate_refresh_pending: true to indicate that certificate URLs are stale and fresh URLs will be available in the webhook.

Body: application/json (object)

A positive integer representing the premium owed per $100 earned. The net_rate is stored in cents (e.g., 48 represents $0.48).

400

Invalid input, voided or cancelled record, expired coverage, attempted shortening, or same end date when no-op is not allowed.

404

Job not found, or no assignment found for the associated job id.