Custom Attributes
Delete an option from a project custom attribute
Changed onRemoves one selectable option from an options-type custom attribute definition for project records.
In-use options cascade: if the option is currently selected on any records, those stored values are deleted in the same transaction — across all record types (people, companies, projects, meetings, candidates, placements), not just project records. This matches the behaviour of deleting an option in the Atlas app. The attribute definition itself and its other options are not affected.
Returns 404 if the attribute does not exist for this agency under this entity type, or if the option does not belong to the attribute.
delete/api/v1/projects/custom-attributes/{attributeId}/options/{optionId}
Request
- Base URLhttps://api.recruitwithatlas.com
- AuthHTTP bearer
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Path parameters
attributeIdstring uuid required
Custom attribute ID
Example:123e4567-e89b-12d3-a456-426614174000
optionIdstring uuid required
Custom attribute option ID
Example:7c9e6679-7425-40de-944b-e07fc1f90ae7
Response
Option deleted
Changes
- info
added the optional property
to the response with the status
- info