REST API REFERENCE GUIDE - Oracle

1 1 TALEO BUSINESS EDITION REST API REFERENCE GUIDE AUGUST 15, 2020 Part Number: E57841-03 2 Oracle Corporation World Headquarters 500 Oracle Parkway Redwood Shores, CA 94065 Worldwide Inquiries: Phone: + Fax: + Copyright 2020, Oracle and/or its affiliates. All rights reserved. This document is provided for information purposes only and the contents hereof are subject to change without notice. This document is not warranted to be error-free, nor subject to any other warranties or conditions, whether expressed orally or implied in law, including implied warranties and conditions of merchantability or fitness for a particular purpose.

2 We specifically disclaim any liability with respect to this document and no contractual obligations are formed either directly or indirectly by this document. This document may not be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without our prior written permission. Oracle is a registered trademark of Oracle and/or its affiliates. Other names may be trademarks of their respective owners. 3 CONTENTS ADVISORY .. 7 WELCOME .. 7 Information Confidentiality .. 7 Audience and Background .. 7 Required Knowledge and Skills .. 7 7 QUICK START NOTES .. 8 INTRODUCTION WHY REST .. 10 INTRODUCTION REST FRAMEWORK.

3 10 REST RESOURCES .. 10 METHODS .. 11 URL STRUCTURE .. 11 REQUEST FORMAT & HEADER .. 13 REQUEST MESSAGE BODY .. 13 RESPONSE NOTIFICATIONS & ERROR CODES .. 14 RESPONSE RELATIONSHIP URLS .. 17 ENTITY OVERVIEW .. 20 Primary System Entities (support API searching): .. 20 All API Supported System Entities: .. 20 GETTING STARTED .. 22 Finding Your Instance: .. 22 Requesting Login/Logout: .. 23 To login: .. 24 To logout: .. 24 Discovery of Services: .. 25 Using Search .. 29 Discovery of Metadata .. 29 Discovery of Display Fields (for Picklists) .. 32 Discovery of Status Values (for Individual Record Assignment) .. 34 WEB SERVICE REFERENCE : DISPLAY FIELD ADMINISTRATION.

4 36 Display Field Actions .. 36 Sample Code Display Fields .. 36 WEB SERVICE REFERENCE : COMMENTS MANAGEMENT .. 37 4 Sample Code Comments .. 38 WEB SERVICE REFERENCE : GEO-ORG ADMINISTRATION .. 39 Department Actions .. 39 Division Actions .. 39 Location Actions .. 40 Region Actions .. 41 Sample Code Geo-Org .. 41 WEB SERVICE REFERENCE : ENTITY LINK MANAGEMENT .. 43 Sample Code for Entity Links .. 43 WEB SERVICE REFERENCE : USER ADMINISTRATION .. 43 Sample Code Users .. 50 WEB SERVICE REFERENCE : EMPLOYEE ADMINISTRATION .. 53 Sample Code Employee Record .. 56 WEB SERVICE REFERENCE : EMPLOYEE ROLLING ENTITIES .. 59 Work History Actions .. 60 Education Actions .. 60 Licenses & Certificate Actions.

5 61 References Actions .. 61 Previous Addresses Actions .. 62 Sample Code Employee Rolling Entities .. 62 WEB SERVICE REFERENCE : EMPLOYEE GOALS .. 65 Sample Code Employee Goals .. 66 WEB SERVICE REFERENCE : PERFORMANCE REVIEWS .. 68 Sample Code Performance Reviews .. 69 WEB SERVICE REFERENCE : COMPANY GOALS .. 71 Sample Code Company Goals .. 71 WEB SERVICE REFERENCE : COMPETENCY LIBRARY .. 73 Sample Code Competency 74 WEB SERVICE REFERENCE : EMPLOYEE ONBOARD PACKETS .. 75 Sample Code for Packets .. 76 WEB SERVICE REFERENCE : EMPLOYEE ONBOARD ACTIVITIES (WITH FORMS) .. 77 Sample Code Onboard Activities .. 78 WEB SERVICE REFERENCE : CANDIDATE ADMINISTRATION .. 79 5 Sample Code Candidate Record.

6 81 WEB SERVICE REFERENCE : CANDIDATE ROLLING ENTITIES .. 83 Work History Actions .. 85 Education Actions .. 85 Licenses & Certificate Actions .. 86 References Actions .. 86 Previous Addresses Actions .. 86 Sample Code Candidate Rolling Entities .. 87 WEB SERVICE REFERENCE : CANDIDATE APPLICATIONS .. 89 Candidate Application Actions .. 90 Sample Code Candidate Application .. 91 WEB SERVICE REFERENCE : CANDIDATE OFFERS .. 92 Sample Code Candidate Offers .. 96 WEB SERVICE REFERENCE : OFFER APPROVALS MANAGEMENT .. 97 Sample Code Approvals .. 98 WEB SERVICE REFERENCE : REQUISITION (&TEMPLATE) ADMINISTRATION .. 99 Sample Code Requisitions .. 101 WEB SERVICE REFERENCE : REQUISITION TEMPLATE ADMINISTRATION.

7 104 Sample Code Requisition Templates .. 107 WEB SERVICE REFERENCE : REQUISITION APPROVALS 109 WEB SERVICE REFERENCE : CAREER WEBSITES .. 109 Sample Code Careers Website .. 109 WEB SERVICE REFERENCE : REQUISITION POSTING ADMINISTRATION .. 110 Sample Code Requisition Poster .. 110 WEB SERVICE REFERENCE : QUESTIONS LIBRARY .. 112 The following code provides information for both questions and answers .. 112 WEB SERVICE REFERENCE : CANDIDATE INTERVIEWS ADMINISTRATION .. 113 Sample Code Interviews .. 114 WEB SERVICE REFERENCE : CANDIDATE INTERVIEW FEEDBACK .. 117 Sample Code Interview Feedbacks .. 118 WEB SERVICE REFERENCE : CANDIDATE BACKGROUND CHECKS .. 120 Sample Code Background Checks.

8 121 WEB SERVICE REFERENCE : RECRUITING EXPENSES MANAGEMENT .. 123 Sample Code Expenses .. 123 6 WEB SERVICE REFERENCE : RECRUIT ACCOUNT ADMINISTRATION .. 125 Sample Code Accounts .. 126 WEB SERVICE REFERENCE : CONTACT ADMINISTRATION .. 128 Sample Code Contacts .. 129 WEB SERVICE REFERENCE : CONTACT LOG ADMINISTRATION .. 132 Sample Code Contact Log: .. 134 WEB SERVICE REFERENCE : PARSE RESUME FUNCTIONS .. 135 APPENDIX A ATTACHMENTS .. 136 Get the list of attachment for a specific entity .. 136 Get the a specific attachment entity by Id .. 138 Create an attachment .. 138 Update an 139 Delete an attachment .. 139 Download an attachment .. 139 RESUME Attachment.

9 140 Download an attachment .. 140 Update a candidate resume .. 140 Parse a candidate resume .. 140 Update a candidate resume .. 141 DOCUMENT HISTORY .. 144 7 ADVISORY Please ensure that you are working with the latest version of the TBE REST API GUIDE . The latest version is available on the Oracle Technology Network at WELCOME Information Confidentiality The Taleo Business Edition REST API and its associated documents, including this GUIDE , are provided for Taleo customers and partners solely. This document should not be viewed, reviewed, replicated, referred to, or reproduced by individuals not a current a Taleo Business Edition customer and/or partner.

10 It shall be agreed by the recipient of the document (hereafter referred to as the other party ) that confidential information disclosed by Taleo through its documents shall be retained in confidence by the other party, and its respective employees, affiliates and/or subsidiaries, pursuant to the following terms and conditions: 1. Any information, know-how, data, process, technique, design, drawing, program, formula or test data, work in process, business plan, sales, suppliers, customer, employee, investor or business information contained in a document, whether in written, graphic, or electronic form; or 2. Any document, diagram, or drawing which is either conspicuously marked as Confidential , known or reasonably known by the other party to be confidential, or is of a proprietary nature, and is learned or disclosed in the course of discussions, demonstrations, or other collaboration undertaken between the parties.