FOfountain
customAttributes

partially update one existing customAttribute

Partially update one existing customAttribute

patch/api/serviceworkforce/customAttributes/{identifier}

Request

  • Base URL
    https://services.fountain.com
  • URL
    https://services.fountain.com/api/serviceworkforce/customAttributes/{identifier}
  • Auth
    HTTP bearer

Path parameters

identifierstring uuid required

customAttribute unique identifier

Request body

uuidstring uuid
createdAtstring date-time

Creation timestamp

createdBystring uuid

Creator UUID

lastUpdatedAtstring date-time

Last update timestamp

lastUpdatedBystring uuid

Last updater UUID

lastUpdatedByAudiencestring

Audience of last updater

lastUpdatedByAudienceUuidstring uuid

Audience UUID of last updater

lastUpdatedByImpersonatedBystring uuid

Impersonator UUID

lastUpdatedByCompanyUuidstring uuid

Company UUID of last updater

lastUpdatedByEnterpriseUuidstring uuid

Enterprise UUID of last updater

companyUuidstring uuid

Company UUID

labelstring required
keystring
dataType'string' | 'number' | 'date' | 'boolean' | 'select' | 'address' | 'media' | 'signature' | 'complianceDocument' required
descriptionstring
resourcestring
resourceIdentifierstring uuid
readOnlyboolean

If true, this attribute cannot be modified. Can only be set by system.

hiddenboolean

If true, this attribute won't be shown. Can only be set by system.

protectedboolean

If true, this attribute can only be accessed by users with certain rights.

hireDataKeyIdinteger

The ID of the hire data key

origin'wx' | 'hire'

Which system authored this attribute definition

attributeSectionUuidstring uuid nullable

UUID of the attributeSection this attribute is grouped under on the worker profile Attributes tab. Null, absent or a deleted section means unassigned: the UI renders an unassigned applicant-origin attribute (hireDataKeyId set) under the virtual "Applicant Attributes" section, otherwise under a trailing "Other" group. A hidden attribute never renders, even inside a company section.

generationinteger

Monotonically increasing definition generation. Increments only when the validation rule changes. A value is current against the rule only when its lastCheckedGeneration equals this. Read-only.

Example request

{
  "uuid": "8223636c5-47f4-43cc-963a-1d1d4e22b665",
  "createdAt": "2021-05-05T01:02:03.924Z",
  "createdBy": "1e4e9128-fbb2-4b0a-97fc-f65bb1efee55",
  "lastUpdatedAt": "2021-05-05T04:05:06.924Z",
  "lastUpdatedBy": "7097bb82-61bd-4724-82ac-eab598190e47",
  "lastUpdatedByAudience": "employer",
  "lastUpdatedByAudienceUuid": "68df4316-590a-4081-9f24-9d9311977c9d",
  "lastUpdatedByImpersonatedBy": "3462e1d4-0e27-4798-b4a2-76412ab21892",
  "lastUpdatedByCompanyUuid": "d310aada-b1ad-4e9a-b822-b90c3cdb65bb",
  "lastUpdatedByEnterpriseUuid": "a6420cdc-285a-4f75-8ccc-8edff6d60c0a",
  "companyUuid": "d310aada-b1ad-4e9a-b822-b90c3cdb65bb",
  "label": "Important Attr",
  "key": "can_u_work",
  "dataType": "string",
  "description": "Important Attr",
  "resource": "ComplianceCheckTemplate",
  "resourceIdentifier": "38e7869d-6c42-406f-93e4-5fa687d7f09a",
  "hireDataKeyId": 1,
  "origin": "wx",
  "attributeSectionUuid": "5f7443f4-6ea2-4a87-b19b-b62926ee6bb0"
}

Response

updated customAttribute. Wrapped in a JsonAPI root response.

Example response

{
  "data": {
    "uuid": "8223636c5-47f4-43cc-963a-1d1d4e22b665",
    "createdAt": "2021-05-05T01:02:03.924Z",
    "createdBy": "1e4e9128-fbb2-4b0a-97fc-f65bb1efee55",
    "lastUpdatedAt": "2021-05-05T04:05:06.924Z",
    "lastUpdatedBy": "7097bb82-61bd-4724-82ac-eab598190e47",
    "lastUpdatedByAudience": "employer",
    "lastUpdatedByAudienceUuid": "68df4316-590a-4081-9f24-9d9311977c9d",
    "lastUpdatedByImpersonatedBy": "3462e1d4-0e27-4798-b4a2-76412ab21892",
    "lastUpdatedByCompanyUuid": "d310aada-b1ad-4e9a-b822-b90c3cdb65bb",
    "lastUpdatedByEnterpriseUuid": "a6420cdc-285a-4f75-8ccc-8edff6d60c0a",
    "companyUuid": "d310aada-b1ad-4e9a-b822-b90c3cdb65bb",
    "label": "Important Attr",
    "key": "can_u_work",
    "dataType": "string",
    "description": "Important Attr",
    "resource": "ComplianceCheckTemplate",
    "resourceIdentifier": "38e7869d-6c42-406f-93e4-5fa687d7f09a",
    "hireDataKeyId": 1,
    "origin": "wx",
    "attributeSectionUuid": "5f7443f4-6ea2-4a87-b19b-b62926ee6bb0"
  },
  "meta": {
    "timestamp": "2021-05-05T09:47:58.924Z",
    "verb": "GET",
    "path": "/api/structure/resources/5949cf7c-fec6-4b31-947c-3aceabff58c5",
    "jti": "%cQN3RIGp",
    "rid": "$2d2zkHZ5",
    "count": 1,
    "status": "200",
    "duration": 17,
    "size": 1234
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.