---
title: "Update the default settings for the agency group"
method: PUT
path: "/agency-group/{agency_group_id}/candidate-settings"
tags: ["Agency Group Candidate Settings"]
---

# Update the default settings for the agency group

`PUT /agency-group/{agency_group_id}/candidate-settings`

## Request

- Base URL: `http://localhost:3010/v1`
- URL: `http://localhost:3010/v1/agency-group/{agency_group_id}/candidate-settings`
- Auth: HTTP basic

Update the default settings for the agency group

## Request body

- AgencyGroupProfileSettingsDef
  - `profile_editable` boolean, required
  - `employment_history_editable` boolean
  - `employment_skills_editable` boolean
  - `professional_registration_editable` boolean
  - `professional_reference_editable` boolean
  - `available_shifts` AvailableShiftsDef[]
    - `position_type_code` string, required
    - `enabled` boolean, required

## Response `200`

The agency group candidate default setting will be returned

- AgencyGroupCandidateDefaultSettingResponseDef
  - `_id` string, required
  - `updated_at` string, date-time, required
  - `created_at` string, date-time, required
  - `__v` integer, required
  - `profile_editable` boolean, required
  - `type` string, required
  - `type_id` string, required
  - `employment_history_editable` boolean, required
  - `employment_skills_editable` boolean, required
  - `professional_registration_editable` boolean, required
  - `professional_reference_editable` boolean, required
  - `available_shifts` AvailableShiftsDef[]
    - `position_type_code` string, required
    - `enabled` boolean, required

## Other responses

- `400`: Validation Error. When context is incorrect.
- `401`: Failed to authenticate the user making the request
- `405`: Method not supported Error. Returned if an unsupported http method is used.
- `406`: Not acceptable, Content type not supported
- `default`: unexpected error

---

[API](https://skmtc.dev/staffshift/apis/staffshift-api-gateway.md) - [All operations](https://skmtc.dev/staffshift/apis/staffshift-api-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/staffshift/apis/staffshift-api-gateway/revisions/1f079f6b65f5?raw)
