{"openapi":"3.1.0","info":{"title":"Taleez API","description":"

🇫🇷 Documentation de l'API Taleez

🔑 Accès et Clés API

  • Génération des clés : Allez dans les paramètres de votre compte Taleez, rubrique \"API & Webhooks\".
  • Support technique : Pour toute question, contactez tech.support@taleez.com.

⚙️ Types de Clés

  • Clé Publique : Pour accéder aux ressources publiques (ex: liste des jobs). Conçue pour un usage côté client (ex: JavaScript).
  • Clé Secrète : Pour accéder à toute l'API. Doit rester confidentielle et utilisée uniquement côté serveur.
Les permissions (scopes) sont configurables pour chaque clé depuis votre compte.

🛡️ Authentification

Chaque requête doit inclure l'un des en-têtes HTTP suivants :

  • X-taleez-api-key: VOTRE_CLÉ_PUBLIQUE

  • X-taleez-api-secret: VOTRE_CLÉ_SECRÈTE

⏱️ Limites et Outils

  • Limite de requêtes : 100 requêtes/minute.
  • Test : Utilisez le bouton \"Test Request\" ou importez la spécification OpenAPI 3.0 dans Postman.
  • Webhooks : Activez les webhooks pour des notifications en temps réel.

🇬🇧 Taleez API documentation

🔑 API Access & Keys

  • Get your keys: Go to your Taleez account settings, in the \"API & Webhooks\" menu.
  • Support: For any questions, contact tech.support@taleez.com.

⚙️ Key Types

  • Public Key: To access public resources (e.g., jobs list). Designed for client-side use (e.g., JavaScript).
  • Secret Key: To access all API endpoints. Must be kept confidential and used server-side only.
Scopes for each key are configurable in your account settings.

🛡️ Authentication

Each request must include one of the following HTTP headers:

  • X-taleez-api-key: YOUR_PUBLIC_KEY

  • X-taleez-api-secret: YOUR_SECRET_KEY

⏱️ Limites & Tools

  • Rate limit: 100 requests/minute.
  • Testing: Use the \"Test Request\" button or import the OpenAPI 3.0 specification into Postman.
  • Webhooks: You can activate webhooks for real-time notifications.
","version":"0.82.0"},"servers":[{"url":"https://api.taleez.com"}],"tags":[{"name":"jobs","description":"Endpoints for job offers"},{"name":"job-properties","description":"Endpoints for job offer properties"},{"name":"candidates","description":"Endpoints for candidates"},{"name":"candidate-properties","description":"Endpoints for candidate properties"},{"name":"documents","description":"Endpoints for documents"},{"name":"events","description":"Endpoints for events"},{"name":"pools","description":"Endpoints for candidate pools"},{"name":"recruiters","description":"Endpoints for recruiters"},{"name":"spontaneous","description":"Endpoints for spontaneous applications"},{"name":"units","description":"Endpoints for units"}],"paths":{"/0/spontaneous/applications":{"post":{"tags":["spontaneous"],"summary":"Create a spontaneous application for the spontaneous form","description":"If candidate does not exist (search by mail) it will be created, otherwise the application will be added to the existing candidate.
Use this endpoint to create a candidate spontaneous application (with answers to the spontaneous form).
Currently, automatic actions (workflow, automatic e-mails and webhooks) are not triggered by this endpoint.

🔑 You can access this if you have the 'spontaneous.application.create' scope activated on your secret key.","operationId":"createSpontaneousApplication","requestBody":{"description":"Application information","content":{"application/json":{"schema":{"$ref":"#/components/schemas/jobApplication"}}},"required":true},"responses":{"400":{"description":"Something's wrong with your request, additional info will be provided in error message"},"200":{"description":"Application has been created","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/createdApplicationResponse"}}}}},"security":[{"secret-key":[]}]}},"/0/pools/{id}/candidates":{"get":{"tags":["pools"],"summary":"Get candidates of a pool","description":"🔑 You can access this if you have the 'pool.candidates.list' scope activated on your secret key.","operationId":"getPoolCandidates","parameters":[{"name":"id","in":"path","description":"Id of the pool","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","description":"Page number.\nStart at '0'","required":false,"schema":{"type":"integer","default":0}},{"name":"pageSize","in":"query","description":"Page size.\nMax size of the list returned. Max value : 1000","required":false,"schema":{"type":"integer","default":100}},{"name":"withProps","in":"query","description":"Include all candidate properties","required":false,"schema":{"type":"boolean","default":false}}],"responses":{"400":{"description":"Something's wrong with your request, additional info will be provided in error message"},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/listResultWithHasMore"}}}},"404":{"description":"Pool cannot be found"}},"security":[{"secret-key":[]}]},"post":{"tags":["pools"],"summary":"Add candidates to a pool","description":"🔑 You can access this if you have the 'pool.candidates.add' scope activated on your secret key.","operationId":"addCandidate","parameters":[{"name":"id","in":"path","description":"Id of the pool","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"description":"Ids of the candidates to add","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listOfIds"}}},"required":true},"responses":{"400":{"description":"Something's wrong with your request, additional info will be provided in error message"},"200":{"description":"Candidates has been added to the pool"}},"security":[{"secret-key":[]}]}},"/0/jobs/{id}/candidates":{"post":{"tags":["jobs"],"summary":"Add candidates to a job","description":"Use this endpoint to link an existing candidates to a job offer. To create a candidate application (with answers to the job questions) to a job offer, use the '/jobs/{jobId}/applications' endpoint.
Currently, automatic actions (workflow, automatic e-mails and webhooks) are not triggered by this way.

🔑 You can access this if you have the 'job.candidates.add' scope activated on your secret key.","operationId":"addCandidate_1","parameters":[{"name":"id","in":"path","description":"Id of the job","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Ids of the candidates to add and location if necessary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listOfIdsWithLocation"}}},"required":true},"responses":{"400":{"description":"Something's wrong with your request, additional info will be provided in error message"},"200":{"description":"Candidates has been added to the job"}},"security":[{"secret-key":[]}]}},"/0/jobs/{id}/applications":{"post":{"tags":["jobs"],"summary":"Create an application for a job","description":"If candidate does not exist (search by mail) it will be created, otherwise the application will be added to the existing candidate.
Use this endpoint to create a candidate application to a job offer (with answers to the job questions). To link an existing candidate to a job offer, use the '/jobs/{jobId}/candidates' or the '/candidates/{candidateId}/jobs' endpoints.
Currently, automatic actions (workflow, automatic e-mails and webhooks) are not triggered by this way.

🔑 You can access this if you have the 'job.application.create' scope activated on your secret key.","operationId":"createApplication","parameters":[{"name":"id","in":"path","description":"Id of the job","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Application information","content":{"application/json":{"schema":{"$ref":"#/components/schemas/jobApplication"}}},"required":true},"responses":{"400":{"description":"Something's wrong with your request, additional info will be provided in error message"},"200":{"description":"Application has been created","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/createdApplicationResponse"}}}}},"security":[{"secret-key":[]}]}},"/0/documents":{"post":{"tags":["documents"],"summary":"Add a document to a candidate - Deprecated, use /0/candidates/{id}/documents endpoint instead","description":"This endpoint is deprecated and will be remove in a future version. Use /0/candidates/{id}/documents endpoint instead.

Use this endpoint to add a document to an existing candidate.
If the document already exists for the candidate (same content), the name is updated and only one document will appear in the candidate card in Taleez.
Supported file formats : pdf, doc, docx, rtf, odt, jpeg, png, pages.","operationId":"create","parameters":[{"name":"candidateId","in":"query","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"cv","in":"query","required":true,"schema":{"type":"boolean"}}],"requestBody":{"description":"The file content","content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"}},"required":["file"]}}}},"responses":{"400":{"description":"Something's wrong with your request, additional info will be provided in error message"},"201":{"description":"Return the id of the created document, or the id of the existing document if document already exists for this candidate","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/createdResourceResult"}}}}},"deprecated":true,"security":[{"secret-key":[]}]}},"/0/documents/tmp":{"post":{"tags":["documents"],"summary":"Upload a temporary document","description":"Use this endpoint to upload a temporary document, not linked to a specific candidate.
The returned id can then be used in an answer in the job application creation request.
Supported file formats : pdf, doc, docx, rtf, odt, jpeg, png, pages.

🔑 You can access this if you have the 'document.create' scope activated on your secret key.","operationId":"uploadTempDoc","requestBody":{"description":"The file content","content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"}},"required":["file"]}}}},"responses":{"400":{"description":"Something's wrong with your request, additional info will be provided in error message"},"201":{"description":"Return the id of the temporary document.","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/createdResourceResult"}}}}},"security":[{"secret-key":[]}]}},"/0/candidates":{"get":{"tags":["candidates"],"summary":"List all candidates in your company","description":"💡 You can filter by any property (ex: source-candidat=linkedin).

🔑 You can access this if you have the 'candidates.list' scope activated on your secret key.","operationId":"list","parameters":[{"name":"page","in":"query","description":"Page number.\nStart at '0'","required":false,"schema":{"type":"integer","default":0}},{"name":"pageSize","in":"query","description":"Page size.\nMax size of the list returned. Max value : 1000","required":false,"schema":{"type":"integer","default":100}},{"name":"mail","in":"query","description":"Filter by mail","required":false,"schema":{"type":"array","items":{"type":"string"},"uniqueItems":true}},{"name":"withProps","in":"query","description":"Include all candidate properties","required":false,"schema":{"type":"boolean","default":false}}],"responses":{"400":{"description":"Something's wrong with your request, additional info will be provided in error message"},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/CandidateList"}}}}},"security":[{"secret-key":[]}]},"post":{"tags":["candidates"],"summary":"Add a candidate","description":"Use this endpoint for sourcing use case, to create a new candidate from his personal information (names, mail...). To create a candidate application (with answers to the job questions) to a job offer, use the '/jobs/{jobId}/applications' endpoint.
Currently, automatic actions (workflow, automatic e-mails and webhooks) are not triggered by this way.

🔑 You can access this if you have the 'candidate.create' scope activated on your secret key.","operationId":"create_1","requestBody":{"description":"Candidate information","content":{"application/json":{"schema":{"$ref":"#/components/schemas/candidateToCreate"}}},"required":true},"responses":{"400":{"description":"Something's wrong with your request, additional info will be provided in error message"},"201":{"description":"Return the id of the created candidate","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/createdResourceResult"}}}}},"security":[{"secret-key":[]}]}},"/0/candidates/{id}":{"get":{"tags":["candidates"],"summary":"Get a candidate","description":"🔑 You can access this if you have the 'candidate.get' scope activated on your secret key.","operationId":"getCandidate","parameters":[{"name":"id","in":"path","description":"Id of the candidate","required":true,"schema":{"type":"string"}}],"responses":{"400":{"description":"Something's wrong with your request, additional info will be provided in error message"},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/candidate"}}}},"404":{"description":"Candidate cannot be found"}},"security":[{"secret-key":[]}]},"post":{"tags":["candidates"],"summary":"Update a candidate","description":"Use this endpoint to update candidate basic information, social links and location. To update candidate properties, use the '/candidates/{id}/properties' endpoint.

🔑 You can access this if you have the 'candidates.update' scope activated on your secret key.","operationId":"update","parameters":[{"name":"id","in":"path","description":"Id of the candidate","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Candidate information","content":{"application/json":{"schema":{"$ref":"#/components/schemas/candidateUpdateRequest"}}},"required":true},"responses":{"400":{"description":"Something's wrong with your request, additional info will be provided in error message"},"200":{"description":"OK"}},"security":[{"secret-key":[]}]}},"/0/candidates/{id}/properties":{"get":{"tags":["candidates"],"summary":"Get candidate property values","description":"🔑 You can access this if you have the 'candidate.properties.list' scope activated on your secret key.","operationId":"getCandidateProperties","parameters":[{"name":"id","in":"path","description":"Id of the candidate","required":true,"schema":{"type":"string"}}],"responses":{"400":{"description":"Something's wrong with your request, additional info will be provided in error message"},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/candidatePropertyValue"}}}}},"404":{"description":"Candidate cannot be found"}},"security":[{"secret-key":[]}]},"post":{"tags":["candidates"],"summary":"Update candidate properties values","description":"🔑 You can access this if you have the 'candidate.properties.update' scope activated on your secret key.","operationId":"updateProperties","parameters":[{"name":"id","in":"path","description":"Id of the candidate","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Candidate properties","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/candidatePropertyParameter"}}}},"required":true},"responses":{"400":{"description":"Something's wrong with your request, additional info will be provided in error message"},"200":{"description":"Properties have been updated"}},"security":[{"secret-key":[]}]}},"/0/candidates/{id}/pools":{"get":{"tags":["candidates"],"summary":"Get candidate pool list","description":"🔑 You can access this if you have the 'candidate.pools.list' scope activated on your secret key.","operationId":"getCandidatePools","parameters":[{"name":"id","in":"path","description":"Id of the candidate","required":true,"schema":{"type":"string"}}],"responses":{"400":{"description":"Something's wrong with your request, additional info will be provided in error message"},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/candidatePool"}}}}},"404":{"description":"Candidate cannot be found"}},"security":[{"secret-key":[]}]},"post":{"tags":["candidates"],"summary":"Add candidate to pools","description":"🔑 You can access this if you have the 'candidate.pools.add' scope activated on your secret key.","operationId":"addToPools","parameters":[{"name":"id","in":"path","description":"Id of the candidate","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Ids of the pools to add the candidate","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listOfIds"}}},"required":true},"responses":{"400":{"description":"Something's wrong with your request, additional info will be provided in error message"},"200":{"description":"Candidate has been added to the pools"}},"security":[{"secret-key":[]}]}},"/0/candidates/{id}/jobs":{"post":{"tags":["candidates"],"summary":"Associate candidate to jobs","description":"Use this endpoint to link an existing candidate to job offers. To create a candidate application (with answers to the job questions) to a job offer, use the '/jobs/{jobId}/applications' endpoint.
Currently, automatic actions (workflow, automatic e-mails and webhooks) are not triggered by this way.

🔑 You can access this if you have the 'candidate.jobs.add' scope activated on your secret key.","operationId":"addToJobs","parameters":[{"name":"id","in":"path","description":"Id of the candidate","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Ids of the jobs to add the candidate","content":{"application/json":{"schema":{"$ref":"#/components/schemas/listOfIds"}}},"required":true},"responses":{"400":{"description":"Something's wrong with your request, additional info will be provided in error message"},"200":{"description":"Candidate has been associated to the jobs"}},"security":[{"secret-key":[]}]}},"/0/candidates/{id}/documents":{"get":{"tags":["candidates"],"summary":"Get candidate document list","description":"🔑 You can access this if you have the 'candidate.documents.list' scope activated on your secret key.","operationId":"getCandidateDocs","parameters":[{"name":"id","in":"path","description":"Id of the candidate","required":true,"schema":{"type":"string"}}],"responses":{"400":{"description":"Something's wrong with your request, additional info will be provided in error message"},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/doc"}}}}},"404":{"description":"Candidate cannot be found"}},"security":[{"secret-key":[]}]},"post":{"tags":["candidates"],"summary":"Add a document to a candidate","description":"Use this endpoint to add a document to a candidate.
If the document already exists for the candidate (same content), the name is updated and only one document will appear in the candidate card in Taleez.
Supported file formats : pdf, doc, docx, rtf, odt, jpeg, png, pages.

🔑 You can access this if you have the 'candidate.documents.add' scope activated on your secret key.","operationId":"addADocument","parameters":[{"name":"id","in":"path","description":"Id of the candidate","required":true,"schema":{"type":"string"}},{"name":"cv","in":"query","required":false,"schema":{"type":"boolean"}}],"requestBody":{"description":"The file content","content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"}},"required":["file"]}}}},"responses":{"400":{"description":"Something's wrong with your request, additional info will be provided in error message"},"201":{"description":"Return the id of the created document, or the id of the existing document if document already exists for this candidate","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/createdResourceResult"}}}}},"security":[{"secret-key":[]}]}},"/0/units":{"get":{"tags":["units"],"summary":"List all units (entities) in your company","description":"🔑 You can access this if you have the 'units.list' scope activated on your secret key.","operationId":"list_1","parameters":[{"name":"page","in":"query","description":"Page number.\nStart at '0'","required":false,"schema":{"type":"integer","default":0}},{"name":"pageSize","in":"query","description":"Page size.\nMax size of the list returned. Max value : 1000","required":false,"schema":{"type":"integer","default":100}}],"responses":{"400":{"description":"Something's wrong with your request, additional info will be provided in error message"},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/UnitList"}}}}},"security":[{"secret-key":[]}]}},"/0/spontaneous/questions":{"get":{"tags":["spontaneous"],"summary":"Get questions of the spontaneous form","description":"🔑 You can access this if you have the 'spontaneous.questions.list' scope activated on your public/secret key.","operationId":"getSpontaneousQuestions","responses":{"400":{"description":"Something's wrong with your request, additional info will be provided in error message"},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/jobQuestion"}}}}}},"security":[{"secret-key":[]},{"public-key":[]}]}},"/0/recruiters":{"get":{"tags":["recruiters"],"summary":"List all recruiters in your company","description":"🔑 You can access this if you have the 'recruiters.list' scope activated on your secret key.","operationId":"list_2","parameters":[{"name":"page","in":"query","description":"Page number.\nStart at '0'","required":false,"schema":{"type":"integer","default":0}},{"name":"pageSize","in":"query","description":"Page size.\nMax size of the list returned. Max value : 1000","required":false,"schema":{"type":"integer","default":100}}],"responses":{"400":{"description":"Something's wrong with your request, additional info will be provided in error message"},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/RecruiterList"}}}}},"security":[{"secret-key":[]}]}},"/0/pools":{"get":{"tags":["pools"],"summary":"List all pools in your company","description":"🔑 You can access this if you have the 'pools.list' scope activated on your secret key.","operationId":"list_3","parameters":[{"name":"page","in":"query","description":"Page number.\nStart at '0'","required":false,"schema":{"type":"integer","default":0}},{"name":"pageSize","in":"query","description":"Page size.\nMax size of the list returned. Max value : 1000","required":false,"schema":{"type":"integer","default":100}}],"responses":{"400":{"description":"Something's wrong with your request, additional info will be provided in error message"},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/PoolList"}}}}},"security":[{"secret-key":[]}]}},"/0/jobs":{"get":{"tags":["jobs"],"summary":"List all jobs in your company","description":"💡 You can use same filter parameter more than once to make a logical OR (Works with : status, contract, city, companyLabel, tag)

💡 You can also filter by any job property (ex: profil=administration).

🔑 You can access this if you have the 'jobs.list' scope activated on your public/secret key.","operationId":"list_4","parameters":[{"name":"page","in":"query","description":"Page number.\nStart at '0'","required":false,"schema":{"type":"integer","default":0}},{"name":"pageSize","in":"query","description":"Page size.\nMax size of the list returned. Max value : 1000","required":false,"schema":{"type":"integer","default":100}},{"name":"unitId","in":"query","description":"Filter on job unit. Can be used with others filters.","required":false,"schema":{"type":"array","items":{"type":"integer","format":"int64"},"uniqueItems":true}},{"name":"status","in":"query","description":"Filter on job status. Can be used with others filters.","required":false,"schema":{"type":"array","items":{"type":"string","enum":["DRAFT","PUBLISHED","DONE","SUSPENDED"]}}},{"name":"contract","in":"query","description":"Filter on job contract. Can be used with others filters.","required":false,"schema":{"type":"array","items":{"type":"string","enum":["CDI","CDD","INTERIM","FREELANCE","INTERNSHIP","APPRENTICESHIP","STUDENT","VIE","FRANCHISE","STATUTE","VACATAIRE","LIBERAL","CDI_CHANTIER","INTERMITTENT","SEASON","OTHER","VOLUNTEER","CEE","CIVIL_SERVANT","CONTRACTUEL","LONG_TERM_ASSIGNMENT","SHORT_TERM_ASSIGNMENT"]}}},{"name":"city","in":"query","description":"Filter on job city. Can be used with others filters.","required":false,"schema":{"type":"array","items":{"type":"string"},"uniqueItems":true}},{"name":"companyLabel","in":"query","description":"Filter on job company label (strict search). Can be used with others filters.","required":false,"schema":{"type":"array","items":{"type":"string"},"uniqueItems":true}},{"name":"tag","in":"query","description":"Filter on job tag. Can be used with others filters.","required":false,"schema":{"type":"array","items":{"type":"string"},"uniqueItems":true}},{"name":"visibility","in":"query","description":"Filter on job visibility. Ignored if visibilityToken attribute doesn't match secret token. Can be used with others filters.","required":false,"schema":{"type":"array","items":{"type":"string","enum":["PUBLIC","INTERNAL","INTERNAL_AND_PUBLIC","PRIVATE"]}}},{"name":"visibilityToken","in":"query","description":"Secret token for restricted jobs.","required":false,"schema":{"type":"string"}},{"name":"withDetails","in":"query","description":"Include all details (job, profile and company descriptions)","required":false,"schema":{"type":"boolean","default":false}},{"name":"withProps","in":"query","description":"Include all job properties","required":false,"schema":{"type":"boolean","default":false}},{"name":"sort","in":"query","description":"Sort the list by one or multiple params. Ex : sort=dateCreation.desc,label.asc","required":false,"schema":{"type":"string","enum":["id","dateCreation","dateFirstPublish","dateLastPublish","label","currentStatus","contract","companyLabel"]}}],"responses":{"400":{"description":"Something's wrong with your request, additional info will be provided in error message"},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/JobList"}}}}},"security":[{"secret-key":[]},{"public-key":[]}]}},"/0/jobs/{id}":{"get":{"tags":["jobs"],"summary":"Get details of a job","description":"🔑 You can access this if you have the 'job.get' scope activated on your public/secret key.","operationId":"getJob","parameters":[{"name":"id","in":"path","description":"Id of the job","required":true,"schema":{"type":"string"}},{"name":"visibilityToken","in":"query","description":"Secret token for restricted jobs.","required":false,"schema":{"type":"string"}}],"responses":{"400":{"description":"Something's wrong with your request, additional info will be provided in error message"},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/job"}}}},"404":{"description":"Job cannot be found"}},"security":[{"secret-key":[]},{"public-key":[]}]}},"/0/jobs/{id}/steps":{"get":{"tags":["jobs"],"summary":"Get job steps list","description":"🔑 You can access this if you have the 'job.steps.list' scope activated on your secret key.","operationId":"getJobSteps","parameters":[{"name":"id","in":"path","description":"Id of the job","required":true,"schema":{"type":"string"}}],"responses":{"400":{"description":"Something's wrong with your request, additional info will be provided in error message"},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/jobStep"}}}}},"404":{"description":"Job cannot be found"}},"security":[{"secret-key":[]}]}},"/0/jobs/{id}/statuses":{"get":{"tags":["jobs"],"summary":"Get status history of a job","description":"🔑 You can access this if you have the 'job.statuses.list' scope activated on your secret key.","operationId":"getJobStatuses","parameters":[{"name":"id","in":"path","description":"Id of the job","required":true,"schema":{"type":"string"}}],"responses":{"400":{"description":"Something's wrong with your request, additional info will be provided in error message"},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/jobStatus"}}}}},"404":{"description":"Job cannot be found"}},"security":[{"secret-key":[]}]}},"/0/jobs/{id}/questions":{"get":{"tags":["jobs"],"summary":"Get questions of a job","description":"🔑 You can access this if you have the 'job.questions.list' scope activated on your public/secret key.","operationId":"getJobQuestions","parameters":[{"name":"id","in":"path","description":"Id of the job","required":true,"schema":{"type":"string"}}],"responses":{"400":{"description":"Something's wrong with your request, additional info will be provided in error message"},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/jobQuestion"}}}}},"404":{"description":"Job cannot be found"}},"security":[{"secret-key":[]},{"public-key":[]}]}},"/0/jobs/filters":{"get":{"tags":["jobs"],"summary":"Count all jobs and count jobs by filter values (with at least one job)","description":"🔑 You can access this if you have the 'jobs.filtered-counts' scope activated on your public/secret key.","operationId":"filters","responses":{"400":{"description":"Something's wrong with your request, additional info will be provided in error message"},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/jobFilters"}}}}},"security":[{"secret-key":[]},{"public-key":[]}]}},"/0/job-properties":{"get":{"tags":["job-properties"],"summary":"List available job properties in your company","description":"🔑 You can access this if you have the 'job.properties.list' scope activated on your secret key.","operationId":"listProperties","parameters":[{"name":"page","in":"query","description":"Page number.\nStart at '0'","required":false,"schema":{"type":"integer","default":0}},{"name":"pageSize","in":"query","description":"Page size.\nMax size of the list returned. Max value : 1000","required":false,"schema":{"type":"integer","default":100}}],"responses":{"400":{"description":"Something's wrong with your request, additional info will be provided in error message"},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/JobPropertyList"}}}}},"security":[{"secret-key":[]}]}},"/0/job-properties/{id}":{"get":{"tags":["job-properties"],"summary":"Get details of a job property","description":"🔑 You can access this if you have the 'job.property.get' scope activated on your secret key.","operationId":"getProperty","parameters":[{"name":"id","in":"path","description":"Id of the property","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"400":{"description":"Something's wrong with your request, additional info will be provided in error message"},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/job-property-details"}}}}},"security":[{"secret-key":[]}]}},"/0/events":{"get":{"tags":["events"],"summary":"List all events in your company","description":"💡 You can sort your events by startDateTime or endDateTime.

🔑 You can access this if you have the 'events.list' scope activated on your secret key.","operationId":"list_5","parameters":[{"name":"page","in":"query","description":"Page number.\nStart at '0'","required":false,"schema":{"type":"integer","default":0}},{"name":"pageSize","in":"query","description":"Page size.\nMax size of the list returned. Max value : 1000","required":false,"schema":{"type":"integer","default":100}},{"name":"sort","in":"query","description":"Sort the list by one or multiple params. Ex : sort=startDateTime.desc,endDateTime.asc","required":false,"schema":{"type":"string","enum":["id","startDateTime","endDateTime"]}}],"responses":{"400":{"description":"Something's wrong with your request, additional info will be provided in error message"},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/EventsList"}}}}},"security":[{"secret-key":[]}]}},"/0/candidates/{id}/events":{"get":{"tags":["candidates"],"summary":"Get candidate event list","description":"🔑 You can access this if you have the 'candidate.events.list' scope activated on your secret key.","operationId":"getCandidateEvents","parameters":[{"name":"id","in":"path","description":"Id of the candidate","required":true,"schema":{"type":"string"}}],"responses":{"400":{"description":"Something's wrong with your request, additional info will be provided in error message"},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/event"}}}}},"404":{"description":"Candidate cannot be found"}},"security":[{"secret-key":[]}]}},"/0/candidates/{id}/applications":{"get":{"tags":["candidates"],"summary":"Get candidate applications list (can be : spontaneous, application to a job, association to a job)","description":"🔑 You can access this if you have the 'candidate.applications.list' scope activated on your secret key.","operationId":"getCandidateApplications","parameters":[{"name":"id","in":"path","description":"Id of the candidate","required":true,"schema":{"type":"string"}}],"responses":{"400":{"description":"Something's wrong with your request, additional info will be provided in error message"},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/candidateApplication"}}}}},"404":{"description":"Candidate cannot be found"}},"security":[{"secret-key":[]}]}},"/0/candidate-properties":{"get":{"tags":["candidate-properties"],"summary":"List available candidate properties in your company","description":"🔑 You can access this if you have the 'candidate-properties.list' scope activated on your secret key.","operationId":"listProperties_1","parameters":[{"name":"page","in":"query","description":"Page number.\nStart at '0'","required":false,"schema":{"type":"integer","default":0}},{"name":"pageSize","in":"query","description":"Page size.\nMax size of the list returned. Max value : 1000","required":false,"schema":{"type":"integer","default":100}},{"name":"withDisabled","in":"query","description":"Include properties that have been disabled in account settings","required":false,"schema":{"type":"boolean","default":false}}],"responses":{"400":{"description":"Something's wrong with your request, additional info will be provided in error message"},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/PropertyList"}}}}},"security":[{"secret-key":[]}]}},"/0/candidate-properties/{id}":{"get":{"tags":["candidate-properties"],"summary":"Get details of a candidate property","description":"🔑 You can access this if you have the 'candidate-property.get' scope activated on your secret key.","operationId":"getProperty_1","parameters":[{"name":"id","in":"path","description":"Id of the property","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"400":{"description":"Something's wrong with your request, additional info will be provided in error message"},"200":{"description":"OK","content":{"application/json;charset=UTF-8":{"schema":{"$ref":"#/components/schemas/candidate-property-details"}}}}},"security":[{"secret-key":[]}]}}},"components":{"schemas":{"StarValue":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"Question choice id","example":46577},"value":{"type":"integer","format":"int32","description":"Rating value, between 0 and 5","example":3}}},"answer":{"type":"object","properties":{"questionId":{"type":"integer","format":"int64","description":"Job question id","example":654167},"value":{"type":"string","description":"Answer value for question types : INPUT, TEXTAREA, NUMBER, DATE and DOC. For DOC it must contains document original name (ex: my_cv.pdf)","example":"My answer"},"choices":{"type":"array","description":"Answer value(s) for question types : CHECKBOX, SELECTMUL, RADIO, SELECT","example":[5487,9873],"items":{"type":"integer","format":"int64"}},"starValues":{"type":"array","description":"Answer value for question type STAR","items":{"$ref":"#/components/schemas/StarValue"}},"docTempId":{"type":"string","description":"Temporary document id. Supported file formats : pdf, doc, docx, rtf, odt, jpeg, png, pages. For DOC questions : docTempId OR docData must be provided","example":"31ccd003-77e7-46af-9c88-07b71f54a90a"},"docData":{"type":"string","description":"Document content encoded in Base64. Supported file formats : pdf, doc, docx, rtf, odt, jpeg, png, pages. For DOC questions : docTempId OR docData must be provided","example":"JVBERi0xLjUKJcOkw7zDtsO..."},"socialLinks":{"$ref":"#/components/schemas/socialLinks","description":"Candidate social links. Used for question type SOCIALS. Link is ignored if not valid."}},"required":["choices","docData","docTempId","questionId","socialLinks","starValues","value"]},"jobApplication":{"type":"object","properties":{"firstName":{"type":"string","description":"Candidate first name","example":"Paul"},"lastName":{"type":"string","description":"Candidate last name","example":"Lefebvre"},"email":{"type":"string","description":"Candidate e-mail","example":"p.lefebvre@provider.com"},"phone":{"type":"string","description":"Candidate phone (formats : 0611223344, +33611223344, 00336112233). Ignored if not valid.","example":"0611223344"},"initialReferrer":{"type":"string","description":"Application initial referer. Default : 'API Taleez'","example":"My web site"},"bypassRequiredQuestions":{"type":"boolean","default":false,"description":"True to allow required questions to do not have answer","example":false},"locationId":{"type":"integer","format":"int64","description":"Id of the location if necessary","example":817},"answers":{"type":"array","description":"Application answers to the job questions","items":{"$ref":"#/components/schemas/answer"}}},"required":["firstName","lastName"]},"socialLinks":{"type":"object","properties":{"linkedin":{"type":"string"},"viadeo":{"type":"string"},"twitter":{"type":"string"},"github":{"type":"string"},"behance":{"type":"string"},"other":{"type":"string"},"website":{"type":"string"},"dribble":{"type":"string"},"skype":{"type":"string"}}},"createdApplicationResponse":{"type":"object","properties":{"candidateId":{"type":"integer","format":"int64","description":"Id of the candidate (newly created or not)","example":12785},"applicationId":{"type":"integer","format":"int64","description":"Id of the newly created application","example":45789}}},"listOfIds":{"type":"object","properties":{"ids":{"type":"array","description":"Ids of resources","example":[12785,25987],"items":{"type":"integer","format":"int64"}}}},"listOfIdsWithLocation":{"type":"object","properties":{"ids":{"type":"array","description":"Ids of resources","example":[12785,25987],"items":{"type":"integer","format":"int64"}},"locationId":{"type":"integer","format":"int64","description":"Id of the location if necessary","example":98547}}},"createdResourceResult":{"type":"object","properties":{"id":{"type":"string","description":"Id of the newly created resource","example":12785}}},"candidateLocationRequest":{"type":"object","properties":{"country":{"type":"string","description":"Country (ISO 3166-1 two-letter code)","enum":["AD","AE","AF","AG","AL","AM","AO","AR","AT","AU","AZ","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BN","BO","BR","BS","BT","BW","BY","BZ","CA","CD","CF","CG","CH","CI","CL","CM","CN","CO","CR","CU","CV","CY","CZ","DE","DJ","DK","DM","DO","DZ","EC","EE","EG","ER","ES","ET","FI","FJ","FM","FR","GA","GB","GD","GE","GH","GM","GN","GQ","GR","GT","GW","GY","HN","HR","HT","HU","ID","IE","IL","IN","IQ","IR","IS","IT","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MA","MC","MD","ME","MG","MH","MK","ML","MM","MN","MR","MT","MU","MV","MW","MX","MY","MZ","NA","NE","NG","NI","NL","NO","NP","NR","NZ","OM","PA","PE","PG","PH","PK","PL","PS","PT","PW","PY","QA","RO","RS","RU","RW","SA","SB","SC","SD","SE","SG","SI","SK","SL","SM","SN","SO","SR","SS","ST","SV","SY","SZ","TD","TG","TH","TJ","TL","TM","TN","TO","TR","TT","TV","TZ","UA","UG","US","UY","UZ","VA","VC","VE","VN","VU","WS","YE","ZA","ZM","ZW","CC","CX","HM","NF","HK","MO","TW","FO","GL","AX","BL","GF","GP","MF","MQ","NC","PF","PM","RE","TF","WF","YT","AI","BM","FK","GI","GS","IO","KY","MS","PN","SH","TC","VG","AW","BQ","CW","BV","SJ","CK","NU","TK","AS","GU","MP","PR","UM","VI"],"example":"FR"},"lat":{"type":"string","description":"Latitude","example":43.603824},"lng":{"type":"string","description":"Longitude","example":1.444206},"city":{"type":"string","description":"City","example":"Toulouse"},"postalCode":{"type":"string","description":"Postal code (only saved for location in France)","example":31000},"street":{"type":"string","description":"Street name","example":"Place du Capitole"},"streetNumber":{"type":"string","description":"Street number","example":1}},"required":["city","country","lat","lng"]},"candidateToCreate":{"type":"object","properties":{"firstName":{"type":"string","example":"John"},"lastName":{"type":"string","example":"Doe"},"mail":{"type":"string","description":"Candidate mail. If specified, must be unique in your company.","example":"john.doe@gmail.com"},"phone":{"type":"string","description":"Candidate phone (formats : 0611223344, +33611223344, 00336112233). Ignored if not valid.","example":"0611223344"},"initialReferrer":{"type":"string","default":"API Taleez","description":"Candidate source.","example":"My web site"},"lang":{"type":"string","default":"FR","description":"Candidate lang (lang must be activated in your account)","enum":["FR","EN","ES","IT"],"example":"FR"},"recruiterId":{"type":"integer","format":"int64","description":"Id of the recruiter who add this candidate. If specified, the candidate will appear as added by this recruiter in Taleez.","example":5489},"socialLinks":{"$ref":"#/components/schemas/socialLinks","description":"Candidate social links. Link is ignored if not valid."},"unitId":{"type":"integer","format":"int64","description":"Id of the unit to be associated with the candidate. Only usable (and required) for companies with multiple units and \"candidate segmentation by unit\" setting (for other companies, the value is ignored)","example":5489},"location":{"$ref":"#/components/schemas/candidateLocationRequest","description":"Candidate location. Minimal required informations : city, country, latitude, longitude. Apart from these rules, location consistency and validity are not checked. The information is saved as is."}},"required":["firstName","lastName"]},"candidateUpdateRequest":{"type":"object","properties":{"firstName":{"type":"string","example":"John"},"lastName":{"type":"string","example":"Doe"},"mail":{"type":"string","description":"Candidate mail. If specified, must be unique in your company.","example":"john.doe@gmail.com"},"phone":{"type":"string","description":"Candidate phone (formats : 0611223344, +33611223344, 00336112233). Ignored if not valid.","example":"0611223344"},"socialLinks":{"$ref":"#/components/schemas/socialLinks","description":"Candidate social links. Link is ignored if not valid. Provide an empty JSON object to remove all social links."},"location":{"$ref":"#/components/schemas/candidateLocationRequest","description":"Candidate location. Provide an empty JSON object to remove all location informations.Minimal required informations : city, country, latitude, longitude. Apart from these rules, location consistency and validity are not checked. The information is saved as is."}},"required":["firstName","lastName"]},"candidatePropertyParameter":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"Property id","example":12785},"value":{"type":"string","description":"Used only for property without choice. The value of the property for this candidate. For DATE property the format must be : yyyy-MM-dd","example":"My new value"},"choices":{"type":"array","description":"Used only for property with choices : list of choice ids selected for this candidate. Empty list to remove all selected choices","example":[5487,9873],"items":{"type":"integer","format":"int64"}},"starValues":{"type":"array","description":"Used only for property of type STAR","items":{"$ref":"#/components/schemas/StarValue"}},"documentId":{"type":"integer","format":"int64","description":"Used only for property of type DOC : id of a document which already exist for this candidate to associate for the property. To get candidate documents or add a new document to a candidate, use /0/candidates/{id}/documents endpoints","example":549672},"appendChoices":{"type":"boolean","description":"Used only for property that allow multiple choices (CHECkBOX, SELECTMUL..) : indicate if choice ids specified in 'choices' parameter has to be append to existing selected choices, or replace its. Default is false","example":false}},"required":["id"]},"UnitList":{"type":"object","properties":{"hasMore":{"type":"boolean","description":"Indicates if there are more results to query","example":true},"list":{"type":"array","description":"Result list","items":{"$ref":"#/components/schemas/unit"}}}},"unit":{"type":"object","properties":{"id":{"type":"integer","format":"int64","example":1337},"dateCreation":{"type":"integer","format":"int64","example":1460545188},"internalName":{"type":"string","example":"My subsidiary"},"publicName":{"type":"string","example":"My subsidiary"},"main":{"type":"boolean","description":"true when this unit is the main unit","example":true}}},"jobQuestion":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"Question id","example":35874},"order":{"type":"integer","format":"int32","description":"Question order. Start at 0.","example":2},"label":{"type":"string","description":"Question label","example":"First Name"},"required":{"type":"boolean","description":"True if answer is required","example":true},"type":{"type":"string","description":"Question type","enum":["INPUT","TEXTAREA","NUMBER","DATE","DOC","SOCIALS","RADIO","SELECT","CHECKBOX","SELECTMUL","STAR"],"example":"CHECKBOX"},"choices":{"type":"array","description":"Available choices for answer. Only present for question types : RADIO, SELECT, CHECKBOX, SELECTMUL, STAR","example":[{"id":2365455,"order":0,"label":"Answer A","inCategory":false,"category":false},{"id":2365456,"order":1,"label":"Answer B","inCategory":false,"category":false}],"items":{"$ref":"#/components/schemas/questionChoice"}}}},"questionChoice":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"Choice id","example":54877},"order":{"type":"integer","format":"int32","description":"Choice order. Start at 0.","example":0},"label":{"type":"string","description":"Choice label","example":"Answer A"},"category":{"type":"boolean","description":"True if the choice is a category title and cannot be selectable (only present for SELECT and SELECTMUL question type)","example":false},"inCategory":{"type":"boolean","description":"True if the choice is inside a category, false if it's outside (only present for SELECT and SELECTMUL question type)","example":false}}},"RecruiterList":{"type":"object","properties":{"hasMore":{"type":"boolean","description":"Indicates if there are more results to query","example":true},"list":{"type":"array","description":"Result list","items":{"$ref":"#/components/schemas/recruiter"}}}},"recruiter":{"type":"object","properties":{"id":{"type":"integer","format":"int64","example":1337},"dateCreation":{"type":"integer","format":"int64","example":1460545188},"mail":{"type":"string","example":"john.doe@gmail.com"},"firstName":{"type":"string","example":"John"},"lastName":{"type":"string","example":"Doe"},"phone":{"type":"string","example":"0611223344"},"mailConfirmed":{"type":"boolean","example":true},"disabled":{"type":"boolean","example":false},"role":{"type":"string","enum":["ADMIN,RECRUITER,MANAGER,CONTRIBUTOR,READER"],"example":"ADMIN"},"picture":{"type":"string","example":"https://files.taleez.com/files/4242/pics/2024/1/29/ef95d958-b7f7-4e6e-82c9-18153fed6478.png"},"hardBouncer":{"type":"boolean","description":"This recruiter has been flagged as hard bouncer, we don't send mail to this address anymore","example":false},"companyId":{"type":"integer","format":"int64","example":1256}}},"PoolList":{"type":"object","properties":{"hasMore":{"type":"boolean","description":"Indicates if there are more results to query","example":true},"list":{"type":"array","description":"Result list","items":{"$ref":"#/components/schemas/pool"}}}},"pool":{"type":"object","properties":{"id":{"type":"integer","format":"int64","example":1337},"dateCreation":{"type":"integer","format":"int64","example":1460545188},"name":{"type":"string","example":"Marketing"},"sourcing":{"type":"boolean","deprecated":true,"description":"DEPRECATED, will be removed.","example":true},"recruiterId":{"type":"integer","format":"int64","example":1337}}},"candidate":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"Candidate unique id","example":1234},"dateCreation":{"type":"integer","format":"int64","description":"Timestamp of the candidate creation date","example":1567771321},"firstName":{"type":"string","description":"Candidate first name","example":"John"},"lastName":{"type":"string","description":"Candidate last name","example":"Doe"},"mail":{"type":"string","description":"Candidate mail","example":"john.doe@gmail.com"},"phone":{"type":"string","description":"Candidate phone","example":"0611223344"},"cv":{"type":"string","description":"Candidate CV URL","example":"https://files.taleez.com/files/..."},"lang":{"type":"string","description":"Candidate lang","enum":["FR","EN","ES","IT"],"example":"FR"},"socialLinks":{"$ref":"#/components/schemas/socialLinks","description":"Candidate social links"},"unitId":{"type":"integer","format":"int64","description":"Id of the unit associated with the candidate. Only specified for companies with multiple units and \"candidate segmentation by unit\" setting.","example":5489},"properties":{"type":"array","items":{"$ref":"#/components/schemas/properties","description":"List of non-null candidate properties, has value when TEXT or values otherwise"}},"location":{"$ref":"#/components/schemas/candidateLocation","description":"Candidate place of residence"}}},"candidateLocation":{"type":"object","description":"Candidate place of residence","properties":{"country":{"type":"string","description":"Country (ISO 3166-1 two-letter code)","enum":["AD","AE","AF","AG","AL","AM","AO","AR","AT","AU","AZ","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BN","BO","BR","BS","BT","BW","BY","BZ","CA","CD","CF","CG","CH","CI","CL","CM","CN","CO","CR","CU","CV","CY","CZ","DE","DJ","DK","DM","DO","DZ","EC","EE","EG","ER","ES","ET","FI","FJ","FM","FR","GA","GB","GD","GE","GH","GM","GN","GQ","GR","GT","GW","GY","HN","HR","HT","HU","ID","IE","IL","IN","IQ","IR","IS","IT","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MA","MC","MD","ME","MG","MH","MK","ML","MM","MN","MR","MT","MU","MV","MW","MX","MY","MZ","NA","NE","NG","NI","NL","NO","NP","NR","NZ","OM","PA","PE","PG","PH","PK","PL","PS","PT","PW","PY","QA","RO","RS","RU","RW","SA","SB","SC","SD","SE","SG","SI","SK","SL","SM","SN","SO","SR","SS","ST","SV","SY","SZ","TD","TG","TH","TJ","TL","TM","TN","TO","TR","TT","TV","TZ","UA","UG","US","UY","UZ","VA","VC","VE","VN","VU","WS","YE","ZA","ZM","ZW","CC","CX","HM","NF","HK","MO","TW","FO","GL","AX","BL","GF","GP","MF","MQ","NC","PF","PM","RE","TF","WF","YT","AI","BM","FK","GI","GS","IO","KY","MS","PN","SH","TC","VG","AW","BQ","CW","BV","SJ","CK","NU","TK","AS","GU","MP","PR","UM","VI"],"example":"FR"},"lat":{"type":"number","format":"double","description":"Latitude (for locations with only country or city information, latitude of the center)","example":43.603824},"lng":{"type":"number","format":"double","description":"Longitude (for locations with only country or city information, longitude of the center)","example":1.444206},"city":{"type":"string","description":"City","example":"Toulouse"},"postalCode":{"type":"string","description":"Postal code (only specified for location in France)","example":31000},"street":{"type":"string","description":"Street name","example":"Place du Capitole"},"streetNumber":{"type":"string","description":"Street number","example":1}}},"listResultWithHasMore":{"type":"object","properties":{"hasMore":{"type":"boolean","description":"Indicates if there are more results to query","example":true},"list":{"type":"array","description":"Result list","items":{"$ref":"#/components/schemas/candidate"}}}},"properties":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"Id of the property","example":6845},"internal":{"type":"string","description":"Internal key of the property","example":"Source candidat"},"apiKey":{"type":"string","description":"API key of the property","example":"source-candidat"},"value":{"type":"string","description":"Value filled when TEXT type","example":"Linkedin"},"values":{"type":"array","description":"List of API keys of choice when not TEXT type","example":["Linkedin","Pôle Emploi"],"items":{"type":"string"},"uniqueItems":true}}},"extraLocations":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"Id of the location","example":1548},"officeId":{"type":"integer","format":"int64","description":"Office id of the location","example":1548},"officeName":{"type":"string","description":"Office name of the location","example":"Headquarters"},"country":{"type":"string","description":"Job country code (ISO 3166-1 two-letter code)","enum":["AD","AE","AF","AG","AL","AM","AO","AR","AT","AU","AZ","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BN","BO","BR","BS","BT","BW","BY","BZ","CA","CD","CF","CG","CH","CI","CL","CM","CN","CO","CR","CU","CV","CY","CZ","DE","DJ","DK","DM","DO","DZ","EC","EE","EG","ER","ES","ET","FI","FJ","FM","FR","GA","GB","GD","GE","GH","GM","GN","GQ","GR","GT","GW","GY","HN","HR","HT","HU","ID","IE","IL","IN","IQ","IR","IS","IT","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MA","MC","MD","ME","MG","MH","MK","ML","MM","MN","MR","MT","MU","MV","MW","MX","MY","MZ","NA","NE","NG","NI","NL","NO","NP","NR","NZ","OM","PA","PE","PG","PH","PK","PL","PS","PT","PW","PY","QA","RO","RS","RU","RW","SA","SB","SC","SD","SE","SG","SI","SK","SL","SM","SN","SO","SR","SS","ST","SV","SY","SZ","TD","TG","TH","TJ","TL","TM","TN","TO","TR","TT","TV","TZ","UA","UG","US","UY","UZ","VA","VC","VE","VN","VU","WS","YE","ZA","ZM","ZW","CC","CX","HM","NF","HK","MO","TW","FO","GL","AX","BL","GF","GP","MF","MQ","NC","PF","PM","RE","TF","WF","YT","AI","BM","FK","GI","GS","IO","KY","MS","PN","SH","TC","VG","AW","BQ","CW","BV","SJ","CK","NU","TK","AS","GU","MP","PR","UM","VI"],"example":"FR"},"adminAreaLevel1":{"type":"string","description":"Administrative area level 1 of the job location (ex: french regions). Can be null (remote job, job is in DRAFT status, no administrative area leval 1 for this location, ...)","example":"Occitanie"},"adminAreaLevel2":{"type":"string","description":"Administrative area level 2 of the job location (ex: french departments). Can be null (remote job, job is in DRAFT status, no administrative area level 2 for this location, ...)","example":"Haute-Garonne"},"city":{"type":"string","description":"City of the location","example":"Toulouse"},"postalCode":{"type":"string","description":"Postal code of the location.","example":31500},"district":{"type":"string","description":"District (ex : arrondissment of french cities) of the location","example":"4e arrondissement"},"address":{"type":"string","description":"Address (street name and number) of the location","example":3},"lat":{"type":"string","description":"Latitude of the location","example":43.6182606},"lng":{"type":"string","description":"Longitude of the location","example":1.4285272},"token":{"type":"string","description":"Token","example":"1s495e"},"url":{"type":"string","description":"Url (specified only if currentStatus = PUBLISHED)"},"urlApplying":{"type":"string","description":"Url to apply (specified only if currentStatus = PUBLISHED)"}}},"jobproperties":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"Id of the property","example":6845},"internal":{"type":"string","description":"Internal key of the property","example":"Département"},"apiKey":{"type":"string","description":"API key of the property","example":"departement"},"label":{"type":"string","description":"Label of the property","example":"Département"},"value":{"type":"string","description":"Value filled when TEXT type","example":"Direction"},"values":{"type":"array","description":"List of API keys of choice when not TEXT type","example":["r_et_d","marketing"],"items":{"type":"string"}},"labels":{"type":"array","description":"List of labels of choices when not TEXT type","example":["Marketing","Technique"],"items":{"type":"string"}}}},"JobList":{"type":"object","properties":{"hasMore":{"type":"boolean","description":"Indicates if there are more results to query","example":true},"list":{"type":"array","description":"Result list","items":{"$ref":"#/components/schemas/job"}}}},"LocI18nFields":{"type":"object","properties":{"arrondissement":{"type":"string"},"city":{"type":"string"},"department":{"type":"string"},"region":{"type":"string"}}},"LocVm":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"locationType":{"type":"string","enum":["COUNTRY","REGION","DEPARTMENT","CITY","ARRONDISSEMENT","ADDRESS","POI"]},"address":{"type":"string"},"arrondissement":{"type":"string"},"postalCode":{"type":"string"},"cityId":{"type":"integer","format":"int64"},"city":{"type":"string"},"departmentId":{"type":"integer","format":"int64"},"department":{"type":"string"},"departmentCode":{"type":"string"},"regionId":{"type":"integer","format":"int64"},"region":{"type":"string"},"regionCode":{"type":"string"},"country":{"type":"string","enum":["AD","AE","AF","AG","AL","AM","AO","AR","AT","AU","AZ","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BN","BO","BR","BS","BT","BW","BY","BZ","CA","CD","CF","CG","CH","CI","CL","CM","CN","CO","CR","CU","CV","CY","CZ","DE","DJ","DK","DM","DO","DZ","EC","EE","EG","ER","ES","ET","FI","FJ","FM","FR","GA","GB","GD","GE","GH","GM","GN","GQ","GR","GT","GW","GY","HN","HR","HT","HU","ID","IE","IL","IN","IQ","IR","IS","IT","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MA","MC","MD","ME","MG","MH","MK","ML","MM","MN","MR","MT","MU","MV","MW","MX","MY","MZ","NA","NE","NG","NI","NL","NO","NP","NR","NZ","OM","PA","PE","PG","PH","PK","PL","PS","PT","PW","PY","QA","RO","RS","RU","RW","SA","SB","SC","SD","SE","SG","SI","SK","SL","SM","SN","SO","SR","SS","ST","SV","SY","SZ","TD","TG","TH","TJ","TL","TM","TN","TO","TR","TT","TV","TZ","UA","UG","US","UY","UZ","VA","VC","VE","VN","VU","WS","YE","ZA","ZM","ZW","CC","CX","HM","NF","HK","MO","TW","FO","GL","AX","BL","GF","GP","MF","MQ","NC","PF","PM","RE","TF","WF","YT","AI","BM","FK","GI","GS","IO","KY","MS","PN","SH","TC","VG","AW","BQ","CW","BV","SJ","CK","NU","TK","AS","GU","MP","PR","UM","VI"]},"lat":{"type":"number","format":"double"},"lng":{"type":"number","format":"double"},"i18n":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/LocI18nFields"}},"latLng":{"type":"string"},"realCountry":{"type":"string","enum":["AD","AE","AF","AG","AL","AM","AO","AR","AT","AU","AZ","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BN","BO","BR","BS","BT","BW","BY","BZ","CA","CD","CF","CG","CH","CI","CL","CM","CN","CO","CR","CU","CV","CY","CZ","DE","DJ","DK","DM","DO","DZ","EC","EE","EG","ER","ES","ET","FI","FJ","FM","FR","GA","GB","GD","GE","GH","GM","GN","GQ","GR","GT","GW","GY","HN","HR","HT","HU","ID","IE","IL","IN","IQ","IR","IS","IT","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MA","MC","MD","ME","MG","MH","MK","ML","MM","MN","MR","MT","MU","MV","MW","MX","MY","MZ","NA","NE","NG","NI","NL","NO","NP","NR","NZ","OM","PA","PE","PG","PH","PK","PL","PS","PT","PW","PY","QA","RO","RS","RU","RW","SA","SB","SC","SD","SE","SG","SI","SK","SL","SM","SN","SO","SR","SS","ST","SV","SY","SZ","TD","TG","TH","TJ","TL","TM","TN","TO","TR","TT","TV","TZ","UA","UG","US","UY","UZ","VA","VC","VE","VN","VU","WS","YE","ZA","ZM","ZW","CC","CX","HM","NF","HK","MO","TW","FO","GL","AX","BL","GF","GP","MF","MQ","NC","PF","PM","RE","TF","WF","YT","AI","BM","FK","GI","GS","IO","KY","MS","PN","SH","TC","VG","AW","BQ","CW","BV","SJ","CK","NU","TK","AS","GU","MP","PR","UM","VI"]}}},"job":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"Job unique id","example":12785},"token":{"type":"string","description":"Job token","example":"17k7r5e"},"dateCreation":{"type":"integer","format":"int64","description":"Timestamp of the job creation date","example":1567771321},"dateFirstPublish":{"type":"integer","format":"int64","description":"Timestamp of the job first publication date. Can be null if job was never published","example":1567771418},"dateLastPublish":{"type":"integer","format":"int64","description":"Timestamp of the job last publication date. Can be null if job was never published","example":1567771418},"label":{"type":"string","description":"Job label. Can be null if job is in DRAFT status.","example":"Assistant administratif"},"currentStatus":{"type":"string","description":"Job current status","enum":["DRAFT, PUBLISHED, DONE, SUSPENDED"],"example":"DONE"},"contract":{"type":"string","description":"Job contract type. Can be null if job is in DRAFT status.","enum":["CDI","CDD","INTERIM","FREELANCE","INTERNSHIP","APPRENTICESHIP","STUDENT","VIE","FRANCHISE","STATUTE","VACATAIRE","LIBERAL","CDI_CHANTIER","INTERMITTENT","SEASON","OTHER","VOLUNTEER","CEE","CIVIL_SERVANT","CONTRACTUEL","LONG_TERM_ASSIGNMENT","SHORT_TERM_ASSIGNMENT"],"example":"INTERNSHIP"},"contractLength":{"type":"integer","format":"int32","description":"Job contract length, if applicable. Can be null","example":3},"contractLengthTimeUnit":{"type":"string","description":"Contract length time unit, if applicable. Can be null","example":"MONTH"},"fullTime":{"type":"boolean","description":"True if it's a full time job, false otherwise","example":true},"workHours":{"type":"number","format":"float","description":"If job is not full time, number of working hours. Can be null.","example":26},"remote":{"type":"boolean","description":"True if it's a remote position job, false otherwise","example":false},"officeId":{"type":"integer","format":"int64","description":"Id of the office, if exists","example":23547},"officeName":{"type":"string","description":"Name of the office, if exists","example":"Headquarters"},"country":{"type":"string","description":"Job country code (ISO 3166-1 two-letter code)","enum":["AD","AE","AF","AG","AL","AM","AO","AR","AT","AU","AZ","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BN","BO","BR","BS","BT","BW","BY","BZ","CA","CD","CF","CG","CH","CI","CL","CM","CN","CO","CR","CU","CV","CY","CZ","DE","DJ","DK","DM","DO","DZ","EC","EE","EG","ER","ES","ET","FI","FJ","FM","FR","GA","GB","GD","GE","GH","GM","GN","GQ","GR","GT","GW","GY","HN","HR","HT","HU","ID","IE","IL","IN","IQ","IR","IS","IT","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MA","MC","MD","ME","MG","MH","MK","ML","MM","MN","MR","MT","MU","MV","MW","MX","MY","MZ","NA","NE","NG","NI","NL","NO","NP","NR","NZ","OM","PA","PE","PG","PH","PK","PL","PS","PT","PW","PY","QA","RO","RS","RU","RW","SA","SB","SC","SD","SE","SG","SI","SK","SL","SM","SN","SO","SR","SS","ST","SV","SY","SZ","TD","TG","TH","TJ","TL","TM","TN","TO","TR","TT","TV","TZ","UA","UG","US","UY","UZ","VA","VC","VE","VN","VU","WS","YE","ZA","ZM","ZW","CC","CX","HM","NF","HK","MO","TW","FO","GL","AX","BL","GF","GP","MF","MQ","NC","PF","PM","RE","TF","WF","YT","AI","BM","FK","GI","GS","IO","KY","MS","PN","SH","TC","VG","AW","BQ","CW","BV","SJ","CK","NU","TK","AS","GU","MP","PR","UM","VI"],"example":"FR"},"adminAreaLevel1":{"type":"string","description":"Administrative area level 1 of the job location (ex: french regions). Can be null (remote job, job is in DRAFT status, no administrative area leval 1 for this location, ...)","example":"Occitanie"},"adminAreaLevel2":{"type":"string","description":"Administrative area level 2 of the job location (ex: french departments). Can be null (remote job, job is in DRAFT status, no administrative area level 2 for this location, ...)","example":"Haute-Garonne"},"city":{"type":"string","description":"Label of the job city. Can be null if it's a remote job, or if job is in DRAFT status.","example":"Toulouse"},"postalCode":{"type":"string","description":"Postal code of the job location. Can be null if it's a remote job, or if job is in DRAFT status.","example":31500},"district":{"type":"string","description":"District (ex : arrondissement of french cities) of the job location, if exists.","example":"4e arrondissement"},"address":{"type":"string","description":"Address (street name and number) of the job location, if exists.","example":3},"lat":{"type":"string","description":"Latitude of the job city, if exists.","example":43.6182606},"lng":{"type":"string","description":"Longitude of the job city, if exists","example":1.4285272},"recruiterId":{"type":"integer","format":"int64","description":"Unique id of the recruiter who create the job","example":1568},"unitId":{"type":"integer","format":"int64","description":"Unique id of the unit of the job","example":849},"logo":{"type":"string","description":"Url of the job logo. Can be null"},"banner":{"type":"string","description":"Url of the job banner. Can be null"},"companyLabel":{"type":"string","description":"Label of the company. Can be null if job is in DRAFT status.","example":"Entreprise ABC"},"website":{"type":"string","description":"Website of the company. Can be null if job is in DRAFT status."},"tags":{"type":"array","description":"Tags of the jobs","example":["Marketing","Technique"],"items":{"type":"string"}},"url":{"type":"string","description":"Url of the job (specified only if currentStatus = PUBLISHED)"},"urlApplying":{"type":"string","description":"Url to apply (specified only if currentStatus = PUBLISHED)"},"visibility":{"type":"string","description":"Job visibility.","enum":["PUBLIC","INTERNAL","INTERNAL_AND_PUBLIC","PRIVATE"],"example":"PUBLIC"},"jobDescription":{"type":"string","description":"Job description. Can be null/absent if job is in DRAFT status.","example":"Nous vous proposons de rejoindre..."},"profileDescription":{"type":"string","description":"Job profile description. Can be null/absent if job is in DRAFT status.","example":"Nous cherchons un nouveau collaborateur..."},"companyDescription":{"type":"string","description":"Job company description. Can be null/absent if job is in DRAFT status.","example":"Fondée en 1987, l'entreprise..."},"extraLocations":{"type":"array","items":{"$ref":"#/components/schemas/extraLocations","description":"List of extra locations if exist"}},"properties":{"type":"array","items":{"$ref":"#/components/schemas/jobproperties","description":"List of non-null job properties, has value when TEXT or values otherwise"}},"location":{"$ref":"#/components/schemas/LocVm","writeOnly":true}}},"jobStep":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"Step id","example":35874},"name":{"type":"string","description":"Step name","example":"CV selected"},"order":{"type":"integer","format":"int32","description":"Step order. Start at 0.","example":2}}},"jobStatus":{"type":"object","properties":{"date":{"type":"integer","format":"int64","description":"Date when job switch to this status (timestamp)","example":1579978410000},"status":{"type":"string","description":"Job status","enum":["DRAFT, PUBLISHED, SUSPENDED, DONE"],"example":"DONE"}}},"jobFilterItem":{"type":"object","properties":{"value":{},"count":{"type":"integer","format":"int64"}}},"jobFilters":{"type":"object","properties":{"totalJobs":{"type":"integer","format":"int64","description":"Total number of jobs","example":9},"statusFilter":{"type":"array","description":"Number of jobs by status","example":[{"value":"PUBLISHED","count":5},{"value":"DRAFT","count":3},{"value":"SUSPENDED","count":1}],"items":{"$ref":"#/components/schemas/jobFilterItem"}},"contractFilter":{"type":"array","description":"Number of jobs by contract type","example":[{"value":"CDI","count":5},{"value":"CDD","count":4}],"items":{"$ref":"#/components/schemas/jobFilterItem"}},"cityFilter":{"type":"array","description":"Number of jobs by city","example":[{"value":"Toulouse","count":1},{"value":"Lyon","count":5},{"value":"Paris","count":3}],"items":{"$ref":"#/components/schemas/jobFilterItem"}},"tagFilter":{"type":"array","description":"Number of jobs by tag","example":[{"value":"Marketing","count":3},{"value":"Technique","count":5}],"items":{"$ref":"#/components/schemas/jobFilterItem"}},"companyLabelFilter":{"type":"array","description":"Number of jobs by company label","example":[{"value":"MyCompany","count":6},{"value":"MyCompany subsidiary 1","count":5},{"value":"MyCompany subsidiary 2","count":3}],"items":{"$ref":"#/components/schemas/jobFilterItem"}}}},"JobPropertyList":{"type":"object","properties":{"hasMore":{"type":"boolean","description":"Indicates if there are more results to query","example":true},"list":{"type":"array","description":"Result list","items":{"$ref":"#/components/schemas/job-property"}}}},"job-property":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"Property unique id","example":12785},"lang":{"type":"string","description":"Default lang of property","enum":["FR","EN","ES","IT"],"example":"FR"},"internal":{"type":"string","description":"Internal name","example":"Profil"},"name":{"type":"string","description":"Public label","example":"Profil"},"type":{"type":"string","description":"Property type","enum":["INPUT","TEXTAREA","NUMBER","DATE","DOC","SOCIALS","RADIO","SELECT","CHECKBOX","SELECTMUL","STAR"],"example":"SELECT"},"apiKey":{"type":"string","description":"Api key. Used for filtering jobs.","example":"qualif"},"choices":{"type":"array","description":"If property has choices, list of the available choices","items":{"$ref":"#/components/schemas/job-property-choice"}},"i18n":{"type":"object","additionalProperties":{"type":"object","additionalProperties":{"type":"string"}},"description":"List of field translations","example":{"EN":{"internal":"Profile","name":"Profile"}}},"public":{"type":"boolean","description":"True if property should appear for candidates","example":true}}},"job-property-choice":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"Choice unique id","example":78962},"value":{"type":"string","description":"Value","example":"Télétravail possible"},"order":{"type":"integer","format":"int32","description":"Choice order when displayed","example":1},"apiKey":{"type":"string","description":"Api key. Used for filtering jobs.","example":"employe_qualifie"},"i18n":{"type":"object","additionalProperties":{"type":"object","additionalProperties":{"type":"string"}},"description":"List of translations","example":{"EN":{"value":"Remote work allowed"}}}}},"job-property-details":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"Property unique id","example":12785},"lang":{"type":"string","description":"Default lang of property","enum":["FR","EN","ES","IT"],"example":"FR"},"internal":{"type":"string","description":"Internal name","example":"Profil"},"name":{"type":"string","description":"Public label","example":"Profil"},"type":{"type":"string","description":"Property type","enum":["INPUT","TEXTAREA","NUMBER","DATE","DOC","SOCIALS","RADIO","SELECT","CHECKBOX","SELECTMUL","STAR"],"example":"SELECT"},"apiKey":{"type":"string","description":"Api key. Used for filtering jobs.","example":"qualif"},"choices":{"type":"array","description":"If property has choices, list of the available choices","items":{"$ref":"#/components/schemas/job-property-choice"}},"i18n":{"type":"object","additionalProperties":{"type":"object","additionalProperties":{"type":"string"}},"description":"List of field translations","example":{"EN":{"internal":"Profile","name":"Profile"}}},"nbJobs":{"type":"integer","format":"int32","description":"Number of jobs associated with this property (with a value)","example":78},"lastUpdatedByName":{"type":"string","description":"Name of the last user who update this property","example":"David Morel"},"lastUpdatedById":{"type":"integer","format":"int64","description":"Id of the last user who update this property","example":456},"public":{"type":"boolean","description":"True if property should appear for candidates","example":true}}},"EventsList":{"type":"object","properties":{"hasMore":{"type":"boolean","description":"Indicates if there are more results to query","example":true},"list":{"type":"array","description":"Result list","items":{"$ref":"#/components/schemas/event"}}}},"attachedFiles":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"File unique id","example":1234},"name":{"type":"string","description":"File name","example":"How to find us.pdf"},"path":{"type":"string","description":"File url","example":"https://files.taleez.com/upload/How_to_find_us.pdf"}}},"attendees":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"Attendee unique id","example":1234},"recruiterId":{"type":"integer","format":"int64","description":"Unique id of the recruiter if this attendee is a recruiter","example":1234},"candidateId":{"type":"integer","format":"int64","description":"Unique id of the candidate if this attendee is a candidate","example":1234},"externalMail":{"type":"string","description":"E-mail of the attendee if it's an external person","example":"john@doe.com"},"type":{"type":"string","description":"Attendee type","enum":["CANDIDATE","RECRUITER","EXTERNAL"],"example":"CANDIDATE"},"responseStatus":{"type":"string","description":"Event Response Status","enum":["NOT_RESPONDED","CONFIRMED","DECLINED"],"example":"NOT_RESPONDED"}}},"event":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"Event unique id","example":1234},"startDateTime":{"type":"integer","format":"int64","description":"Timestamp of the event start date","example":1567771321},"endDateTime":{"type":"integer","format":"int64","description":"Timestamp of the event end date","example":1567771321},"subject":{"type":"string","description":"Event title","example":"First Interview"},"description":{"type":"string","description":"Event description text","example":"

We will meet to talk about your experience and our company.

"},"location":{"type":"string","description":"Event location","example":"55 rue Riquet,75019 Paris, France"},"meetingUrl":{"type":"string","description":"Video Meeting URL","example":"https://meet.google.com/abc-defg-hij"},"recruiterCreatorId":{"type":"integer","format":"int64","description":"Unique id of the recruiter who created the event","example":1234},"recruiterOrganizerId":{"type":"integer","format":"int64","description":"Unique id of the recruiter who will host the event","example":1234},"smsReminder":{"type":"boolean","description":"true if the attendees will receive a text message to remind them of the event"},"privateEvent":{"type":"boolean","description":"true if the event is private"},"jobId":{"type":"integer","format":"int64","description":"Unique id of the job attached to this event, if exists","example":1234},"spontaneousId":{"type":"integer","format":"int64","description":"Unique id of the spontaneous application workflow attached to this event, if exists","example":1234},"attendees":{"type":"array","description":"Attendees to the event","items":{"$ref":"#/components/schemas/attendees"}},"attachedFiles":{"type":"array","description":"Files attached to the event","items":{"$ref":"#/components/schemas/attachedFiles"}}}},"CandidateList":{"type":"object","properties":{"hasMore":{"type":"boolean","description":"Indicates if there are more results to query","example":true},"list":{"type":"array","description":"Result list","items":{"$ref":"#/components/schemas/candidate"}}}},"SelectedChoiceDTO":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"Choice id","example":46577},"apiKey":{"type":"string","description":"Api key label","example":"1-an-d-experience"},"value":{"type":"integer","format":"int64","description":"Rating value, between 1 and 5 (only specified for property of type STAR)","example":3}}},"candidatePropertyValue":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"Property id","example":12785},"internal":{"type":"string","description":"Property internal name","example":"Expérience"},"apiKey":{"type":"string","description":"Property api key","example":"experience"},"type":{"type":"string","description":"Property type","enum":["INPUT","TEXTAREA","NUMBER","DATE","DOC","SOCIALS","RADIO","SELECT","CHECKBOX","SELECTMUL","STAR"],"example":"SELECT"},"value":{"type":"string","description":"Value for a property without choice.","example":"This is the value"},"choices":{"type":"array","description":"Selected values for a property with choices","items":{"$ref":"#/components/schemas/SelectedChoiceDTO"}},"document":{"$ref":"#/components/schemas/doc","description":"Document associated to the property (only for property of type DOC)"}},"required":["id"]},"doc":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"Document id","example":46577},"date":{"type":"integer","format":"int64","description":"Creation date (timestamp)","example":1579978410000},"name":{"type":"string","description":"Document name","example":"MyCv.pdf"},"path":{"type":"string","description":"Document URL","example":"https://files.taleez.com/..."},"size":{"type":"integer","format":"int32","description":"Document size in bytes","example":125000}}},"candidatePool":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"Pool id","example":2545},"name":{"type":"string","description":"Pool name","example":"Marketing"},"date":{"type":"integer","format":"int64","description":"Date when candidate has been added to the pool (timestamp)","example":1579978410000},"referer":{"type":"string","description":"Referer. Can be Taleez, API Taleez, Workflow or external website if added via browser extension","example":"Linkedin"},"recruiterId":{"type":"integer","format":"int64","description":"Recruiter id who add the candidate to the pool. Not specified if candidate has been associated via the API.","example":8442}}},"candidateApplication":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"Application id","example":2545},"type":{"type":"string","description":"Application type","enum":["SPONTANEOUS","ASSOCIATED_TO_SPONTANEOUS","APPLICATION_TO_A_JOB","ASSOCIATED_TO_A_JOB"],"example":"APPLICATION_TO_A_JOB"},"date":{"type":"integer","format":"int64","description":"Application date (timestamp)","example":1579978410000},"referer":{"type":"string","description":"Application referer (source)","example":"Pole Emploi"},"jobId":{"type":"integer","format":"int64","description":"Job id (specified if application type is ASSOCIATED_TO_A_JOB or APPLICATION_TO_A_JOB)","example":2545},"recruiterId":{"type":"integer","format":"int64","description":"Recruiter id who associate candidate with the job or spontaneous. Can only be present if application type is ASSOCIATED_TO_A_JOB or ASSOCIATED_TO_SPONTANEOUS, but not specified if candidate has been associated via the API.","example":8442},"currentStepId":{"type":"integer","format":"int64","description":"Application current step id, or last step if application has been rejected/processed","example":54781},"currentStepName":{"type":"string","description":"Application current step name, or last step if application has been rejected/processed","example":"CV sélectionné"},"rejected":{"type":"boolean","description":"true if application has been rejected"},"dateRejected":{"type":"integer","format":"int64","description":"Application rejected date if any (timestamp)","example":1579978410000},"dateProcessed":{"type":"integer","format":"int64","description":"Application processed date if any (timestamp). Can only be present if application type is ASSOCIATED_TO_SPONTANEOUS or SPONTANEOUS.","example":1579978410000},"dateHired":{"type":"integer","format":"int64","description":"Application hired date if any (timestamp)","example":1579978410000},"steps":{"type":"array","description":"Application historic steps","items":{"$ref":"#/components/schemas/step"}}}},"step":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"Id of the job step","example":6845},"date":{"type":"integer","format":"int64","description":"When the application has been switched in this step","example":1579978410000},"recruiterId":{"type":"integer","format":"int64","description":"Id of the recruiter who switch the step","example":12345}}},"PropertyList":{"type":"object","properties":{"hasMore":{"type":"boolean","description":"Indicates if there are more results to query","example":true},"list":{"type":"array","description":"Result list","items":{"$ref":"#/components/schemas/candidate-property"}}}},"candidate-property":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"Property unique id","example":12785},"lang":{"type":"string","description":"Default lang of property","enum":["FR","EN","ES","IT"],"example":"FR"},"internal":{"type":"string","description":"Internal name","example":"Expérience"},"name":{"type":"string","description":"Public label","example":"Votre expérience"},"apiKey":{"type":"string","description":"Api key","example":"experience"},"type":{"type":"string","description":"Property type","enum":["INPUT","TEXTAREA","NUMBER","DATE","DOC","SOCIALS","RADIO","SELECT","CHECKBOX","SELECTMUL","STAR"],"example":"SELECT"},"disabled":{"type":"boolean","description":"Status of property","example":false},"choices":{"type":"array","description":"If property has choices, list of the available choices","items":{"$ref":"#/components/schemas/choice"}},"i18n":{"type":"object","additionalProperties":{"type":"object","additionalProperties":{"type":"string"}},"description":"List of field translations","example":{"EN":{"internal":"Experience","name":"Your experience level"}}}}},"choice":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"Choice unique id","example":78962},"value":{"type":"string","description":"Value","example":"1 an d'expérience"},"apiKey":{"type":"string","description":"Api key","example":"1-an-d-experience"},"order":{"type":"integer","format":"int32","description":"Choice order when displayed","example":1},"category":{"type":"boolean","description":"For property type SELECT and SELECTMUL, true value indicate that this choice is a category (and can not be selected as a value)","example":false},"i18n":{"type":"object","additionalProperties":{"type":"object","additionalProperties":{"type":"string"}},"description":"List of translations","example":{"EN":{"value":"1 year of experience"}}}}},"candidate-property-details":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"Property unique id","example":12785},"lang":{"type":"string","description":"Default lang of property","enum":["FR","EN","ES","IT"],"example":"FR"},"internal":{"type":"string","description":"Internal name","example":"Expérience"},"name":{"type":"string","description":"Public label","example":"Votre expérience"},"apiKey":{"type":"string","description":"Api key","example":"experience"},"type":{"type":"string","description":"Property type","enum":["INPUT","TEXTAREA","NUMBER","DATE","DOC","SOCIALS","RADIO","SELECT","CHECKBOX","SELECTMUL","STAR"],"example":"SELECT"},"disabled":{"type":"boolean","description":"Status of property","example":false},"choices":{"type":"array","description":"If property has choices, list of the available choices","items":{"$ref":"#/components/schemas/choice"}},"i18n":{"type":"object","additionalProperties":{"type":"object","additionalProperties":{"type":"string"}},"description":"List of field translations","example":{"EN":{"internal":"Experience","name":"Your experience level"}}},"locked":{"type":"boolean","description":"True if it's a default property created by Taleez (so name and choices are not updatable)","example":true},"adminOnly":{"type":"boolean","description":"True if property values is only visible for Admin","example":false},"hasChoices":{"type":"boolean","description":"True if property has choices (like SELECT, RADIO, ...), false otherwise (like INPUT, DATE, DOC, ...)","example":true},"multiChoiceAllowed":{"type":"boolean","description":"True if property can have several choices selected for a candidate (like CHECKBOX, SELECTMUL,...), false otherwise (like SELECT, RADIO, ...)","example":false},"nbCandidate":{"type":"integer","format":"int32","description":"Number of candidate associated with this property (with a value)","example":78},"lastUpdatedByName":{"type":"string","description":"Name of the last user who update this property","example":"David Morel"},"lastUpdatedById":{"type":"integer","format":"int64","description":"Id of the last user who update this property","example":456}}}},"securitySchemes":{"public-key":{"type":"apiKey","name":"X-taleez-api-key","in":"header"},"secret-key":{"type":"apiKey","name":"X-taleez-api-secret","in":"header"}}}}