put/curriculum/{curriculumId}/futurejob

Allows to edit the future Job section of a given curriculum for the authenticated user. In the future Job section the candidate can provide information about his availability and motivations to change job and his preferences for the new Job, for example, workDay, contractType, wage amount, etc.

Try it!

Request

Resource URL

https://api.infojobs.net/api/4/curriculum/{curriculumId}/futurejob

Security

User Role: role_candidate
Scope: candidate_edit_curriculum_future_job

Parameters

Name	Description
curriculumId String Required	Identifier of the curriculum to edit. This curriculum must belongs to the authenticated user. Example values: 70628530-6d45-483a-8327-d8c81b

Name

Description

curriculumId

String

Required

Identifier of the curriculum to edit. This curriculum must belongs to the authenticated user.

Example values: 70628530-6d45-483a-8327-d8c81b

Body Request Fields

Its structure is specified in the example below.

{
    "employmentStatus": "no-busco-trabajo-pero-estoy-dispuesto-a-escuchar-ofertas",
    "motivationToChange": "Cambio de residencia a otra provincia" ,
    "futureJobGoals" : "Enriquecimiento profesional y personal",
    "yearsOfExperience": "2-anos",
    "lastJobSearch": "bolsa-de-empleo-online",
    "lastJobSearchDetails": "InfoJobs",
    "preferredPosition":"Analista programador",
    "subcategories":["hardware-redes-seguridad"],
    "contractTypes":["autonomo"],
    "workDay":"completa",
    "availabilityToChangeHomeAddress":"buena",
    "availabilityToTravel":"mala",
    "preferredDestinations":["madrid"],
    "salaryPeriod": "bruto-ano",
    "salaryMin":"27.000",
    "preferredSalary":"33.000",
    "working": "true"    
}

Field Name	Description
employmentStatus String Required	The employment status of the authenticated user. The operation /dictionary/employment-status returns all available values. Example values: estoy-buscando-trabajo-activamente Maximum length: 100
motivationToChange String Optional	Description with the motivations to change job. Example values: Mejorar profesionalmente. Incentivo economico. IMPORTANT: Please note in compliance with JSON format you must not send carriage returns within the value field, but replace them with "\n" instead. Maximum length: 1500
futureJobGoals String Optional	Description with the goals for the new job. Example values: Seguir desarrollandome y conseguir conocimientos nuevos. IMPORTANT: Please note in compliance with JSON format you must not send carriage returns within the value field, but replace them with "\n" instead. Maximum length: 1500
yearsOfExperience String Required	The number of years of experience the candidate has. The operation /dictionary/candidate-experience returns all available values. Example values: solo-practicas-becario Maximum length: 100
lastJobSearch String Optional	Describes how the candidate found the last job. The operation /dictionary/last-job-search returns all available values. Example values: bolsa-de-empleo-online Maximum length: 100
lastJobSearchDetails String Optional*	Detailed explanation of how the candidate found his last work. This field is optional or requiered depending on the value informed in the field lastJobSearch. For otros* and bolsa-de-empleo-online is required otherwise optional. Example values: Encontré mi actual trabajo a través de InfoJobs. IMPORTANT: Please note in compliance with JSON format you must not send carriage returns within the value field, but replace them with "\n" instead. Maximum length: 150
preferredPosition String Required	Job position preferred by the candidate in his future job. Example values: Administrativo recepcionista IMPORTANT: Please note in compliance with JSON format you must not send carriage returns within the value field, but replace them with "\n" instead. Minimum length: 4 Maximum length: 300
subcategories Array(String) Required	The subcategories under which the candidate's future job should fall into. It's possible to inform multiple subcategories. The operation /dictionary/subcategory returns all available values. Example values:electronica-automatica-industrial
contractTypes Array(String) Optional	The contract type preferred by the candidate in his future job. It's possible to inform multiple values. The operation /dictionary/contract-type returns all available values. Example values: indefinido
workDay String Optional	The work day preferred by the candidate in his future job. The operation /dictionary/workday returns all available values. Example values: parcial-tarde Maximum length: 100
availabilityToChangeHomeAddress String Required	The candidate availability to change home address, for example, change to another region. The operation /dictionary/availability returns all available values. Example values: depende-de-las-condiciones Maximum length: 100
availabilityToTravel String Required	The candidate availability to travel. The operation /dictionary/availability returns all available values. Example values: buena Maximum length: 100
preferredDestinations Array(String) Optional	The preferred destinations in case of change of home address. It's possible to inform multiple values. The operation /dictionary/region returns all available values. Note: The preferredDestinations might contain values even if the availabilityToTravel or availabilityToChangeHomeAddress has been set to bad. Example values: cualquiera
salaryPeriod String Optional	The Salary pay period without taxes. The operation /dictionary/salary-period returns all available values. Example values: bruto-mes Maximum length: 100
SalaryMin String Optional	The minimum salary accepted by the candidate in his future job. The operation /dictionary/salary-quantity returns all available values. Example values: 21.000 Maximum length: 100
preferredSalary String Optional	The salary desired by the candidate in his future job. The operation /dictionary/salary-quantity returns all available values. Example values: 24.000 Maximum length: 100
working Boolean Required	If this field is informed with true it means the candidate is currently working. Example values: true

Field Name

Description

employmentStatus

String

Required

The employment status of the authenticated user. The operation /dictionary/employment-status returns all available values.

Example values: estoy-buscando-trabajo-activamente

Maximum length: 100

motivationToChange

String

Optional

Description with the motivations to change job.

Example values: Mejorar profesionalmente. Incentivo economico.

IMPORTANT: Please note in compliance with JSON format you must not send carriage returns within the value field, but replace them with "\n" instead.

Maximum length: 1500

futureJobGoals

String

Optional

Description with the goals for the new job.

Example values: Seguir desarrollandome y conseguir conocimientos nuevos.

IMPORTANT: Please note in compliance with JSON format you must not send carriage returns within the value field, but replace them with "\n" instead.

Maximum length: 1500

yearsOfExperience

String

Required

The number of years of experience the candidate has. The operation /dictionary/candidate-experience returns all available values.

Example values: solo-practicas-becario

Maximum length: 100

lastJobSearch

String

Optional

Describes how the candidate found the last job. The operation /dictionary/last-job-search returns all available values.

Example values: bolsa-de-empleo-online

Maximum length: 100

lastJobSearchDetails

String

Optional*

Detailed explanation of how the candidate found his last work.

*This field is optional or requiered depending on the value informed in the field lastJobSearch. For otros and bolsa-de-empleo-online is required otherwise optional.

Example values: Encontré mi actual trabajo a través de InfoJobs.

IMPORTANT: Please note in compliance with JSON format you must not send carriage returns within the value field, but replace them with "\n" instead.

Maximum length: 150

preferredPosition

String

Required

Job position preferred by the candidate in his future job.

Example values: Administrativo recepcionista

IMPORTANT: Please note in compliance with JSON format you must not send carriage returns within the value field, but replace them with "\n" instead.

Minimum length: 4
Maximum length: 300

subcategories

Array(String)

Required

The subcategories under which the candidate's future job should fall into. It's possible to inform multiple subcategories. The operation /dictionary/subcategory returns all available values.

Example values:electronica-automatica-industrial

contractTypes

Array(String)

Optional

The contract type preferred by the candidate in his future job. It's possible to inform multiple values. The operation /dictionary/contract-type returns all available values.

Example values: indefinido

workDay

String

Optional

The work day preferred by the candidate in his future job. The operation /dictionary/workday returns all available values.

Example values: parcial-tarde

Maximum length: 100

availabilityToChangeHomeAddress

String

Required

The candidate availability to change home address, for example, change to another region. The operation /dictionary/availability returns all available values.

Example values: depende-de-las-condiciones

Maximum length: 100

availabilityToTravel

String

Required

The candidate availability to travel. The operation /dictionary/availability returns all available values.

Example values: buena

Maximum length: 100

preferredDestinations

Array(String)

Optional

The preferred destinations in case of change of home address. It's possible to inform multiple values. The operation /dictionary/region returns all available values.

Note: The preferredDestinations might contain values even if the availabilityToTravel or availabilityToChangeHomeAddress has been set to bad.

Example values: cualquiera

salaryPeriod

String

Optional

The Salary pay period without taxes. The operation /dictionary/salary-period returns all available values.

Example values: bruto-mes

Maximum length: 100

SalaryMin

String

Optional

The minimum salary accepted by the candidate in his future job. The operation /dictionary/salary-quantity returns all available values.

Example values: 21.000

Maximum length: 100

preferredSalary

String

Optional

The salary desired by the candidate in his future job. The operation /dictionary/salary-quantity returns all available values.

Example values: 24.000

Maximum length: 100

working

Boolean

Required

If this field is informed with true it means the candidate is currently working.

Example values: true

Response

Response fields

Name	Description
curriculumId String Required	Identifier of the curriculum to edit. This curriculum must belongs to the authenticated user. Example values: 70628530-6d45-483a-8327-d8c81b

Name

Description

curriculumId

String

Required

Identifier of the curriculum to edit. This curriculum must belongs to the authenticated user.

Example values: 70628530-6d45-483a-8327-d8c81b

Response

Response fields

Fields related to the Futurejob Entity
Name	Description
employmentStatus String Required	The employment status of the authenticated user. The operation /dictionary/employment-status returns all available values. Maximum length: 100
motivationToChange String Optional	Description with the motivations to change job. * This field will only be displayed when it has a value. Maximum length: 1500
futureJobGoals String Optional	Description with the goals expected in the new job. * This field will only be displayed when it has a value. Maximum length: 1500
yearsOfExperience String Required	The number of years of experience of the candidate. The operation /dictionary/candidate-experience returns all available values. Maximum length: 100
lastJobSearch String Optional	Describes how the candidates found their last job. The operation /dictionary/last-job-search returns all available values. * This field will only be displayed when it has a value. Maximum length: 100
lastJobSearchDetails String Optional	Detailed explanation of how the candidates found their last job. * This field will only be displayed when it has a value. Maximum length: 150
preferredPosition String Required	Job position preferred by the candidate in his/her future job. Minimum length: 4 Maximum length: 300
subcategories Array(String) Required	The subcategories under which the candidate's future job should fall into. There can be multiple subcategories. The operation /dictionary/subcategory returns all available values.
contractTypes Array(String) Optional	The contract type preferred by the candidate in his future job. There can be multiple values. The operation /dictionary/contract-type returns all available values. * This field will only be displayed when it has a value.
workDay String Optional	The work day preferred by the candidate in his future job. The operation /dictionary/workday returns all available values. * This field will only be displayed when it has a value. Maximum length: 100
availabilityToChangeHomeAddress String Required	The candidate availability to change home address, for example, move to another region. The operation /dictionary/availability returns all available values. Maximum length: 100
availabilityToTravel String Required	The candidate's availability to travel. The operation /dictionary/availability returns all available values.
preferredDestinations Array(String) Optional	The preferred destinations in case of change of home address. There can be multiple values. The operation /dictionary/workday returns all available values. The preferredDestinations might contain values even if the availabilityToTravel or availabilityToChangeHomeAddress has been set to bad. This field will only be displayed when it has a value.
salaryPeriod String Optional	The Salary pay period without taxes. The operation /dictionary/salary-period returns all available values. * This field will only be displayed when it has a value. Maximum length: 100
SalaryMin String Optional	The minimum salary accepted by the candidate in his future job. The operation /dictionary/salary-quantity returns all available values. * This field will only be displayed when it has a value. Maximum length: 100
preferredSalary String Optional	The salary expected by the candidate in his future job. The operation /dictionary/salary-quantity returns all available values. * This field will only be displayed when it has a value. Maximum length: 100
working Boolean Required	If true the candidate is currently working.

Error codes

Code	Description
361	The curriculum was not found or the authenticated user is not the owner.

Error codes

Code	Description
361	The curriculum was not found or the authenticated user is not the owner.
699	The value of the field working is mandatory.
700	The value of employmentStatus is mandatory.
701	The employmentStatus is not valid or is not provided.
702	The value of yearsOfExperience is not a valid or is not provided.
703	The value of lastJobSearch is not a valid.
704	The preferredPosition field is required or exceeds the maximum number of characters allowed.
705	The subcategories field is required.
706	The subcategories field has an invalid value.
707	The value of contractType is not a valid.
708	The availabilityToChangeHomeAddress is not provided or has an invalid value.
709	The availabilityToTravel is not provided or has an invalid value.
710	The value of workday is not a valid.
711	The preferedDestinations has an invalid value.
712	The value of motivationToChange is not valid. Please check the number of characters.
713	The value of futureJobGoals is not valid.
714	The subcategories belong to more than 3 categories.
715	The value of lastJobSearchDetails is not valid. Please check the number of characters.
716	The value of salaryMinis not valid.
717	The value of preferredSalary is not valid.
718	The value of salaryPeriod is not valid.

Examples

This example edits the future job section of the given curriculum.

Request

https://api.infojobs.net/api/4/curriculum/70628530-6d45-483a-8327-d8c81b0a62ab/futurejob

{
    "working": "true",
    "employmentStatus": "no-busco-trabajo-pero-estoy-dispuesto-a-escuchar-ofertas",
    "motivationToChange": "Cambio de residencia a otra provincia" ,
    "futureJobGoals" : "Enriquecimiento profesional y personal",
    "yearsOfExperience": "2-anos",
    "lastJobSearch": "bolsa-de-empleo-online",
    "lastJobSearchDetails": "InfoJobs",
    "preferredPosition":"Analista programador",
    "subcategories":["hardware-redes-seguridad"],
    "contractTypes":["autonomo"],
    "workDay":"completa",
    "availabilityToChangeHomeAddress":"buena",
    "availabilityToTravel":"mala",
    "preferredDestinations":["madrid"],
    "salaryPeriod": "bruto-ano",
    "salaryMin":"27.000",
    "preferredSalary":"33.000"
}

Response

{
    "working": "true",
    "employmentStatus": "no-busco-trabajo-pero-estoy-dispuesto-a-escuchar-ofertas",
    "motivationToChange": "Cambio de residencia a otra provincia" ,
    "futureJobGoals" : "Enriquecimiento profesional y personal",
    "yearsOfExperience": "2-anos",
    "lastJobSearch": "bolsa-de-empleo-online",
    "lastJobSearchDetails": "InfoJobs",
    "preferredPosition":"Analista programador",
    "subcategories":["hardware-redes-seguridad"],
    "contractTypes":["autonomo"],
    "workDay":"completa",
    "availabilityToChangeHomeAddress":"buena",
    "availabilityToTravel":"mala",
    "preferredDestinations":["madrid"],
    "salaryPeriod": "bruto-ano",
    "salaryMin":"27.000",
    "preferredSalary":"33.000"
}

Try it!

InfoJobs

put/curriculum/{curriculumId}/futurejob

Request

Resource URL

Security

Parameters

Body Request Fields

Response

Response fields

Response

Response fields

Error codes

Error codes

Examples

Request

Response

Sections: