> ## Documentation Index > Fetch the complete documentation index at: https://docs.spott.io/llms.txt > Use this file to discover all available pages before exploring further. # Bulk update vacancy custom attribute values > Update one vacancy custom attribute for multiple vacancies. Provide the attribute definition ID once and one value per vacancy ID (items[].id). All vacancies must be accessible; the batch is atomic. ## OpenAPI ````yaml /api-reference/openapi.json put /custom-attributes/vacancies/values/_bulk openapi: 3.1.0 info: title: Spott API Reference version: '0.1' servers: - url: https://api.gospott.com security: [] tags: [] paths: /custom-attributes/vacancies/values/_bulk: put: tags: - Custom Attributes summary: Bulk update vacancy custom attribute values description: >- Update one vacancy custom attribute for multiple vacancies. Provide the attribute definition ID once and one value per vacancy ID (items[].id). All vacancies must be accessible; the batch is atomic. operationId: bulkUpdateVacancyAttributeValues parameters: [] requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/BulkUpdateVacancyAttributeValuesDto' responses: '204': description: Vacancy custom attribute values updated successfully '400': description: >- Bad request - invalid payload, duplicate vacancy ids, or mismatched attribute value type content: application/json: schema: anyOf: - $ref: '#/components/schemas/ValidationExceptionDto' - $ref: >- #/components/schemas/CustomAttributesAtLeastOneVacancyRequiredApiErrorDto - $ref: >- #/components/schemas/CustomAttributesTooManyVacanciesApiErrorDto - $ref: >- #/components/schemas/CustomAttributesDuplicateVacancyIdApiErrorDto - $ref: >- #/components/schemas/CustomAttributesMismatchedAttributeViewTypeApiErrorDto '401': description: Unauthorized - invalid or missing authentication content: application/json: schema: $ref: '#/components/schemas/ExceptionBaseDto' '404': description: Vacancy or custom attribute definition not found content: application/json: schema: anyOf: - $ref: '#/components/schemas/GlobalNotFoundApiErrorDto' - $ref: >- #/components/schemas/CustomAttributesAttributeDefinitionNotFoundApiErrorDto - $ref: >- #/components/schemas/CustomAttributesVacancyNotFoundApiErrorDto '409': description: Conflict content: application/json: schema: $ref: '#/components/schemas/GlobalConflictApiErrorDto' '500': description: Error response content: application/json: schema: $ref: '#/components/schemas/InternalServerErrorDto' security: - x-api-key: [] components: schemas: BulkUpdateVacancyAttributeValuesDto: type: object properties: attributeDefinitionId: type: string minLength: 1 items: minItems: 1 maxItems: 100 type: array items: $ref: '#/components/schemas/BulkUpdateVacancyAttributeValueDto' required: - attributeDefinitionId - items ValidationExceptionDto: type: object properties: status: type: number const: 400 category: type: string enum: - SCHEMA_VALIDATION_FAILED message: type: string enum: - Validation failed requestId: type: string errors: type: array items: $ref: '#/components/schemas/ValidationIssueDto' required: - status - category - message - requestId - errors CustomAttributesAtLeastOneVacancyRequiredApiErrorDto: type: object properties: status: type: number const: 400 category: type: string enum: - DOMAIN_VALIDATION_FAILED message: type: string enum: - >- At least one vacancy must be selected for the custom attribute operation. requestId: type: string required: - status - category - message - requestId CustomAttributesTooManyVacanciesApiErrorDto: type: object properties: status: type: number const: 400 category: type: string enum: - OPERATION_LIMIT_EXCEEDED message: type: string enum: - >- Too many vacancies were selected for a single custom attribute bulk operation. requestId: type: string required: - status - category - message - requestId CustomAttributesDuplicateVacancyIdApiErrorDto: type: object properties: status: type: number const: 400 category: type: string enum: - DOMAIN_VALIDATION_FAILED message: type: string enum: - >- Duplicate vacancy identifiers are not allowed in the custom attribute operation. requestId: type: string required: - status - category - message - requestId CustomAttributesMismatchedAttributeViewTypeApiErrorDto: type: object properties: status: type: number const: 400 category: type: string enum: - DOMAIN_VALIDATION_FAILED message: type: string enum: - >- The submitted value type does not match the attribute definition's view type. requestId: type: string code: type: string enum: - MISMATCHED_ATTRIBUTE_VIEW_TYPE required: - status - category - message - requestId - code ExceptionBaseDto: type: object properties: status: type: integer minimum: -9007199254740991 maximum: 9007199254740991 category: $ref: '#/components/schemas/ApiErrorCategoryDto' message: type: string requestId: type: string required: - status - message - requestId GlobalNotFoundApiErrorDto: anyOf: - $ref: '#/components/schemas/ResourceNotFoundApiErrorDto' - $ref: '#/components/schemas/RelatedResourceNotFoundApiErrorDto' CustomAttributesAttributeDefinitionNotFoundApiErrorDto: type: object properties: status: type: number const: 404 category: type: string enum: - RESOURCE_NOT_FOUND message: type: string enum: - The custom attribute definition could not be found. requestId: type: string code: type: string enum: - ATTRIBUTE_DEFINITION_NOT_FOUND required: - status - category - message - requestId - code CustomAttributesVacancyNotFoundApiErrorDto: type: object properties: status: type: number const: 404 category: type: string enum: - RESOURCE_NOT_FOUND message: type: string enum: - The vacancy for the custom attribute operation could not be found. requestId: type: string required: - status - category - message - requestId GlobalConflictApiErrorDto: anyOf: - $ref: '#/components/schemas/ResourceAlreadyExistsApiErrorDto' - $ref: '#/components/schemas/ResourceLockTimeoutApiErrorDto' InternalServerErrorDto: type: object properties: status: type: number const: 500 category: type: string enum: - INTERNAL_ERROR message: type: string enum: - Internal server error requestId: type: string required: - status - category - message - requestId BulkUpdateVacancyAttributeValueDto: type: object properties: id: type: string minLength: 1 value: $ref: '#/components/schemas/SharedCustomAttributeTypeRequestDto' required: - id - value ValidationIssueDto: oneOf: - $ref: '#/components/schemas/ValidationRequiredDto' - $ref: '#/components/schemas/ValidationInvalidEmptyStringDto' - $ref: '#/components/schemas/ValidationUnknownFieldDto' - $ref: '#/components/schemas/ValidationTooSmallDto' - $ref: '#/components/schemas/ValidationTooBigDto' - $ref: '#/components/schemas/ValidationInvalidTypeDto' - $ref: '#/components/schemas/ValidationInvalidValueDto' - $ref: '#/components/schemas/ValidationInvalidEmailDto' - $ref: '#/components/schemas/ValidationInvalidUuidDto' - $ref: '#/components/schemas/ValidationInvalidUrlDto' - $ref: '#/components/schemas/ValidationInvalidDatetimeDto' - $ref: '#/components/schemas/ValidationInvalidDateDto' - $ref: '#/components/schemas/ValidationInvalidTimeDto' - $ref: '#/components/schemas/ValidationInvalidDurationDto' - $ref: '#/components/schemas/ValidationInvalidIpv4Dto' - $ref: '#/components/schemas/ValidationInvalidIpv6Dto' - $ref: '#/components/schemas/ValidationInvalidJsonStringDto' - $ref: '#/components/schemas/ValidationInvalidJwtDto' - $ref: '#/components/schemas/ValidationInvalidRegexDto' - $ref: '#/components/schemas/ValidationInvalidPhoneNumberDto' - $ref: '#/components/schemas/ValidationInvalidDomainDto' - $ref: '#/components/schemas/ValidationInvalidHttpsUrlDto' - $ref: '#/components/schemas/ValidationInvalidTimezoneDto' - $ref: '#/components/schemas/ValidationPaginationOffsetExceededDto' ApiErrorCategoryDto: type: string enum: - MALFORMED_REQUEST - SCHEMA_VALIDATION_FAILED - DOMAIN_VALIDATION_FAILED - OPERATION_LIMIT_EXCEEDED - AUTHENTICATION_REQUIRED - AUTHENTICATION_FAILED - SECURITY_CHALLENGE_REQUIRED - SECURITY_CHALLENGE_FAILED - PERMISSION_DENIED - ENTITLEMENT_REQUIRED - PROVIDER_AUTHENTICATION_REQUIRED - PROVIDER_AUTHENTICATION_FAILED - CONFIGURATION_REQUIRED - RESOURCE_NOT_FOUND - RESOURCE_ALREADY_EXISTS - RESOURCE_EXPIRED - RESOURCE_BUSY - RESOURCE_STATE_CONFLICT - QUOTA_EXCEEDED - RATE_LIMITED - UNSUPPORTED_OPERATION - UPSTREAM_REJECTED - TIMEOUT - TEMPORARILY_UNAVAILABLE - INTERNAL_ERROR ResourceNotFoundApiErrorDto: type: object properties: status: type: number const: 404 category: type: string enum: - RESOURCE_NOT_FOUND message: type: string enum: - Resource not found requestId: type: string required: - status - category - message - requestId RelatedResourceNotFoundApiErrorDto: type: object properties: status: type: number const: 404 category: type: string enum: - RESOURCE_NOT_FOUND message: type: string enum: - Related resource not found requestId: type: string required: - status - category - message - requestId ResourceAlreadyExistsApiErrorDto: type: object properties: status: type: number const: 409 category: type: string enum: - RESOURCE_ALREADY_EXISTS message: type: string enum: - Resource already exists requestId: type: string required: - status - category - message - requestId ResourceLockTimeoutApiErrorDto: type: object properties: status: type: number const: 409 category: type: string enum: - RESOURCE_BUSY message: type: string enum: - >- Lock could not be acquired for this resource, please try again later. requestId: type: string required: - status - category - message - requestId SharedCustomAttributeTypeRequestDto: oneOf: - $ref: '#/components/schemas/CustomTextTypeDto' - $ref: '#/components/schemas/CustomNumberTypeDto' - $ref: '#/components/schemas/CustomCheckboxTypeDto' - $ref: '#/components/schemas/CustomDateTypeDto' - $ref: '#/components/schemas/CustomTimestampTypeDto' - $ref: '#/components/schemas/CustomRatingTypeDto' - $ref: '#/components/schemas/CustomSelectTypeDto' - $ref: '#/components/schemas/CustomMultiSelectTypeRequestDto' - $ref: '#/components/schemas/CustomCurrencyTypeDto' - $ref: '#/components/schemas/CustomDateRangeTypeDto' - $ref: '#/components/schemas/CustomDurationTypeDto' - $ref: '#/components/schemas/CustomUrlTypeDto' - $ref: '#/components/schemas/CustomEntityTypeDto' - $ref: '#/components/schemas/CustomMultiEntityTypeRequestDto' ValidationRequiredDto: type: object properties: code: type: string enum: - REQUIRED path: type: string message: type: string received: {} required: - code - path - message ValidationInvalidEmptyStringDto: type: object properties: code: type: string enum: - INVALID_EMPTY_STRING path: type: string message: type: string received: {} required: - code - path - message ValidationUnknownFieldDto: type: object properties: code: type: string enum: - UNKNOWN_FIELD path: type: string message: type: string received: {} keys: type: array items: type: string required: - code - path - message - keys ValidationTooSmallDto: type: object properties: code: type: string enum: - TOO_SMALL path: type: string message: type: string received: {} minimum: type: number inclusive: type: boolean origin: type: string required: - code - path - message - minimum - inclusive - origin ValidationTooBigDto: type: object properties: code: type: string enum: - TOO_BIG path: type: string message: type: string received: {} maximum: type: number inclusive: type: boolean origin: type: string required: - code - path - message - maximum - inclusive - origin ValidationInvalidTypeDto: type: object properties: code: type: string enum: - INVALID_TYPE path: type: string message: type: string received: {} expected: type: string required: - code - path - message - expected ValidationInvalidValueDto: type: object properties: code: type: string enum: - INVALID_VALUE path: type: string message: type: string received: {} expected: {} required: - code - path - message ValidationInvalidEmailDto: type: object properties: code: type: string enum: - INVALID_EMAIL path: type: string message: type: string received: {} required: - code - path - message ValidationInvalidUuidDto: type: object properties: code: type: string enum: - INVALID_UUID path: type: string message: type: string received: {} required: - code - path - message ValidationInvalidUrlDto: type: object properties: code: type: string enum: - INVALID_URL path: type: string message: type: string received: {} required: - code - path - message ValidationInvalidDatetimeDto: type: object properties: code: type: string enum: - INVALID_DATETIME path: type: string message: type: string received: {} required: - code - path - message ValidationInvalidDateDto: type: object properties: code: type: string enum: - INVALID_DATE path: type: string message: type: string received: {} required: - code - path - message ValidationInvalidTimeDto: type: object properties: code: type: string enum: - INVALID_TIME path: type: string message: type: string received: {} required: - code - path - message ValidationInvalidDurationDto: type: object properties: code: type: string enum: - INVALID_DURATION path: type: string message: type: string received: {} required: - code - path - message ValidationInvalidIpv4Dto: type: object properties: code: type: string enum: - INVALID_IPV4 path: type: string message: type: string received: {} required: - code - path - message ValidationInvalidIpv6Dto: type: object properties: code: type: string enum: - INVALID_IPV6 path: type: string message: type: string received: {} required: - code - path - message ValidationInvalidJsonStringDto: type: object properties: code: type: string enum: - INVALID_JSON_STRING path: type: string message: type: string received: {} required: - code - path - message ValidationInvalidJwtDto: type: object properties: code: type: string enum: - INVALID_JWT path: type: string message: type: string received: {} required: - code - path - message ValidationInvalidRegexDto: type: object properties: code: type: string enum: - INVALID_REGEX path: type: string message: type: string received: {} required: - code - path - message ValidationInvalidPhoneNumberDto: type: object properties: code: type: string enum: - INVALID_PHONE_NUMBER path: type: string message: type: string received: {} required: - code - path - message ValidationInvalidDomainDto: type: object properties: code: type: string enum: - INVALID_DOMAIN path: type: string message: type: string received: {} required: - code - path - message ValidationInvalidHttpsUrlDto: type: object properties: code: type: string enum: - INVALID_HTTPS_URL path: type: string message: type: string received: {} required: - code - path - message ValidationInvalidTimezoneDto: type: object properties: code: type: string enum: - INVALID_TIMEZONE path: type: string message: type: string received: {} required: - code - path - message ValidationPaginationOffsetExceededDto: type: object properties: code: type: string enum: - PAGINATION_OFFSET_EXCEEDED path: type: string message: type: string received: {} maximum: type: number required: - code - path - message - maximum CustomTextTypeDto: type: object properties: viewType: type: string enum: - customText text: type: - string - 'null' required: - viewType - text CustomNumberTypeDto: type: object properties: viewType: type: string enum: - customNumber number: type: - number - 'null' required: - viewType - number CustomCheckboxTypeDto: type: object properties: viewType: type: string enum: - customCheckbox checked: type: - boolean - 'null' required: - viewType - checked CustomDateTypeDto: type: object properties: viewType: type: string enum: - customDate date: anyOf: - $ref: '#/components/schemas/DateISO' - type: 'null' required: - viewType - date CustomTimestampTypeDto: type: object properties: viewType: type: string enum: - customTimestamp timestamp: anyOf: - $ref: '#/components/schemas/DateISO' - type: 'null' required: - viewType - timestamp CustomRatingTypeDto: type: object properties: viewType: type: string enum: - customRating rating: type: - number - 'null' required: - viewType - rating CustomSelectTypeDto: type: object properties: viewType: type: string enum: - customSelect select: type: - string - 'null' required: - viewType - select CustomMultiSelectTypeRequestDto: type: object properties: viewType: type: string enum: - customMultiSelect multiSelect: maxItems: 100 type: array items: type: string required: - viewType - multiSelect CustomCurrencyTypeDto: type: object properties: viewType: type: string enum: - customCurrency monetaryAmount: anyOf: - $ref: '#/components/schemas/MonetaryAmountDto' - type: 'null' required: - viewType - monetaryAmount CustomDateRangeTypeDto: type: object properties: viewType: type: string enum: - customDateRange dateRange: anyOf: - $ref: '#/components/schemas/DateRangeDto' - type: 'null' required: - viewType - dateRange CustomDurationTypeDto: type: object properties: viewType: type: string enum: - customDuration duration: type: - number - 'null' required: - viewType - duration CustomUrlTypeDto: type: object properties: viewType: type: string enum: - customUrl url: type: - string - 'null' required: - viewType - url CustomEntityTypeDto: type: object properties: viewType: type: string enum: - customEntity type: type: string enum: - user id: type: - string - 'null' entity: anyOf: - $ref: '#/components/schemas/UserBadgeDto' - type: 'null' required: - viewType - type - id CustomMultiEntityTypeRequestDto: type: object properties: viewType: type: string enum: - customMultiEntity type: type: string enum: - user ids: maxItems: 100 type: array items: type: string entities: maxItems: 100 type: array items: $ref: '#/components/schemas/UserBadgeDto' required: - viewType - type - ids DateISO: format: date-time anyOf: - type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ - type: string format: date pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$ MonetaryAmountDto: type: object properties: currency: $ref: '#/components/schemas/DmCurrency' amount: type: number required: - currency - amount DateRangeDto: type: object properties: startDate: $ref: '#/components/schemas/DateISO' endDate: anyOf: - $ref: '#/components/schemas/DateISO' - type: 'null' required: - startDate - endDate UserBadgeDto: type: object properties: id: type: string name: type: string avatarUrl: type: - string - 'null' deactivatedAt: anyOf: - $ref: '#/components/schemas/DateISO' - type: 'null' required: - id - name - avatarUrl - deactivatedAt DmCurrency: type: string enum: - AED - AFN - ALL - AMD - ANG - AOA - ARS - AUD - AWG - AZN - BAM - BBD - BDT - BGN - BHD - BIF - BMD - BND - BOB - BRL - BSD - BTC - BTN - BWP - BYN - BZD - CAD - CDF - CHF - CLF - CLP - CNH - CNY - COP - CRC - CUC - CUP - CVE - CZK - DJF - DKK - DOP - DZD - EGP - ERN - ETB - EUR - FJD - FKP - GBP - GEL - GGP - GHS - GIP - GMD - GNF - GTQ - GYD - HKD - HNL - HRK - HTG - HUF - IDR - ILS - IMP - INR - IQD - IRR - ISK - JEP - JMD - JOD - JPY - KES - KGS - KHR - KMF - KPW - KRW - KWD - KYD - KZT - LAK - LBP - LKR - LRD - LSL - LYD - MAD - MDL - MGA - MKD - MMK - MNT - MOP - MRU - MUR - MVR - MWK - MXN - MYR - MZN - NAD - NGN - NIO - NOK - NPR - NZD - OMR - PAB - PEN - PGK - PHP - PKR - PLN - PYG - QAR - RON - RSD - RUB - RWF - SAR - SBD - SCR - SDG - SEK - SGD - SHP - SLE - SLL - SOS - SRD - SSP - STD - STN - SVC - SYP - SZL - THB - TJS - TMT - TND - TOP - TRY - TTD - TWD - TZS - UAH - UGX - USD - UYU - UZS - VEF - VES - VND - VUV - WST - XAF - XAG - XAU - XCD - XCG - XDR - XOF - XPD - XPF - XPT - YER - ZAR - ZMW - ZWG - ZWL securitySchemes: x-api-key: type: apiKey name: x-api-key in: header description: >- API key for authentication. Get your API key from Settings → API Keys in your Spott dashboard. ````