> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acreblitz.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Use the V2 API at https://esa.acreblitz.com/api/v2. V1 is deprecated and is no longer documented.
> Read /llms.txt for all supported endpoints. For bulk integration, read bulk submission, status, results, and /v2/errors before constructing requests.

# Set group portal lock

> Lock or unlock all current applications in an account-scoped group

Lock or unlock all current applications in an account-scoped group.

**provider\_group\_id** `string` *required*

Your job/work-order identifier, up to 200 characters.

**account\_id** `string` *required*

Required account identifier. Group identifiers may repeat across accounts.

**locked** `boolean` *required*

Use true to lock current applications or false to unlock them.

## Group scope

The operation applies to existing applications owned by your provider with this account and group. It returns their application-event references. An empty or unowned group returns 404.

New applications added afterward start unlocked. Wait for bulk completion before locking a complete job, and call again after adding applications. Group unlock also clears locks set individually on those applications. Shared runoff selections follow the same field/year lock rule as an individual application lock.

```bash cURL theme={null}
curl --request PUT 'https://esa.acreblitz.com/api/v2/groups/work-order-42/portal-lock' \
  --header "X-API-Key: $ACREBLITZ_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "account_id": "your-account",
  "locked": true
}'
```

```json 200 theme={null}
{
  "success": true,
  "provider_group_id": "work-order-42",
  "account_id": "your-account",
  "locked": true,
  "application_event_ids": [
    "019953f8-8c00-7000-8000-000000000002"
  ]
}
```

## Errors

No applications for the supplied group/account returns `404 GROUP_NOT_FOUND`. Invalid or missing account, group, or lock values return `422 INVALID_REQUEST`.

All routes can also return [authentication, validation, rate-limit, and dependency errors](https://docs.acreblitz.com/v2/errors.md#http-error-catalog). Use the [error catalog and examples](https://docs.acreblitz.com/v2/errors.md) to choose a retry or correction. Keep `X-Request-ID` when present.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.