{ "opencollection": "1.0.0", "info": { "name": "Authentication Accesstoken Interviews API", "version": "1.0.0" }, "items": [ { "info": { "name": "Interviews", "type": "folder" }, "items": [ { "info": { "name": "List All Interviews", "type": "http" }, "http": { "method": "GET", "url": "https://api-sandbox.rocketlawyer.com/partners/v1/auth/interviews", "params": [ { "name": "partnerEndUserId", "value": "", "type": "query", "description": "The unique identifier of the partner's end user used to filter the list of interviews. If provided, only interviews associated with this end user will be returned.\n" } ] }, "docs": "TThis endpoint retrieves a list of interviews in the requesting partner tenancy. You can optionally filter the results by `partnerEndUserId` to narrow the list to a specific end user. The response includes the interview names, IDs, templates used, current statuses, and storage types.\n" }, { "info": { "name": "Create an Interview", "type": "http" }, "http": { "method": "POST", "url": "https://api-sandbox.rocketlawyer.com/partners/v1/auth/interviews", "body": { "type": "json", "data": "{}" } }, "docs": "This endpoint allows you to create a new interview session.\n\n- Provide a reference to a Binder (`binderId`) or an owner email (`partyEmailAddress`).\n- If a `binderId` is provided, the new interview will be created within the context of this Binder.\n- If `binderId` isn't provided, a new binder will be created.\n- User-entered information will be stored by Rocket Lawyer.\n\n**Service Token**:\n- A service token is provided in the response header, scoped to the `partyId`.\n" }, { "info": { "name": "Retrieve Interview by ID", "type": "http" }, "http": { "method": "GET", "url": "https://api-sandbox.rocketlawyer.com/partners/v1/auth/interviews/:interviewId", "params": [ { "name": "interviewId", "value": "76105b3e-ac8a-4202-8ed2-b991a02b8456", "type": "path", "description": "The unique identifier of an interview." } ] }, "docs": "Retrieves the details of an existing interview identified by the `interviewId`. This endpoint lets you fetch all the information related to a specific interview, including its status and associated data. This endpoint also enables you to resume a previously started interview.\n" }, { "info": { "name": "Update an Interview", "type": "http" }, "http": { "method": "PUT", "url": "https://api-sandbox.rocketlawyer.com/partners/v1/auth/interviews/:interviewId", "params": [ { "name": "interviewId", "value": "76105b3e-ac8a-4202-8ed2-b991a02b8456", "type": "path", "description": "The unique identifier of an interview." } ], "body": { "type": "json", "data": "{}" } }, "docs": "This endpoint updates an existing Interview with data in the Tagged Answer Model (TAM) format. It's important to note that data previously entered for this interview will be lost.\n" }, { "info": { "name": "Delete an Interview", "type": "http" }, "http": { "method": "DELETE", "url": "https://api-sandbox.rocketlawyer.com/partners/v1/auth/interviews/:interviewId", "params": [ { "name": "interviewId", "value": "76105b3e-ac8a-4202-8ed2-b991a02b8456", "type": "path", "description": "The unique identifier of an interview." } ] }, "docs": "Deletes an existing interview resource identified by the `interviewId`. This operation permanently removes the interview and its associated data from the Rocket Lawyer system.\n" }, { "info": { "name": "Complete an Interview", "type": "http" }, "http": { "method": "POST", "url": "https://api-sandbox.rocketlawyer.com/partners/v1/auth/interviews/:interviewId/completions", "params": [ { "name": "interviewId", "value": "76105b3e-ac8a-4202-8ed2-b991a02b8456", "type": "path", "description": "The unique identifier of an interview." } ] }, "docs": "Completes the specified interview for which answers have been supplied. This operation finalizes the interview, ensuring that all provided answers are processed and saved and final document stored at the binder.\n" }, { "info": { "name": "Retrieve a Page", "type": "http" }, "http": { "method": "GET", "url": "https://api-sandbox.rocketlawyer.com/partners/v1/auth/interviews/:interviewId/pages/:pageId", "params": [ { "name": "interviewId", "value": "76105b3e-ac8a-4202-8ed2-b991a02b8456", "type": "path", "description": "The unique identifier of an interview." }, { "name": "pageId", "value": "Pkbbc224f2d2eb", "type": "path", "description": "Either a pageId or a pseudonym for a page. Enter one of the following options:\n- `pageId`: The unique identifier of the requested page.\n- `\"first\"`: Pseudonym for the first page of the Interview.\n- `\"last\"`: Pseudonym for the last answered page by the end user of the Interview.\n" } ] }, "docs": "Retrieves a specific page of the interview identified by `interviewId` and `pageId`.\n\nFor this call, the default format for `currentPageData` is set to `display`, and the default preview format is `text/html`.\n\nIf you are on the first page of the interview, the previous page and the current page of the response object will be the same. Similarly, if you are on the last page of the interview, the current page and the next page will be the same.\n" }, { "info": { "name": "Update an Interview Page's Answers", "type": "http" }, "http": { "method": "PATCH", "url": "https://api-sandbox.rocketlawyer.com/partners/v1/auth/interviews/:interviewId/pages/:pageId", "params": [ { "name": "interviewId", "value": "76105b3e-ac8a-4202-8ed2-b991a02b8456", "type": "path", "description": "The unique identifier of an interview." }, { "name": "pageId", "value": "Pkaab440f2d2eb", "type": "path", "description": "Either a pageId or a pseudonym for a page. Enter one of the following options:\n- `pageId`: The unique identifier of the requested page.\n- `\"first\"`: Pseudonym for the first page of the Interview.\n- `\"last\"`: Pseudonym for the last answered page by the end user of the Interview.\n" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Submit the answers to the questions for a specific page of the interview, identified by `interviewId` and `pageId`.\n\nThis operation can also be used to retrieve the next or previous page preview, and/or get the updated preview of the current page. This is controlled by the `format` key in each page's respective data inside the request's body.\n\nIf you are on the first page of the interview, the previous page and the current page of the response object will be the same. Similarly, if you are on th" }, { "info": { "name": "Retrieve Interview Data", "type": "http" }, "http": { "method": "GET", "url": "https://api-sandbox.rocketlawyer.com/partners/v1/auth/interviews/:interviewId/tagged-answers", "params": [ { "name": "interviewId", "value": "76105b3e-ac8a-4202-8ed2-b991a02b8456", "type": "path", "description": "The unique identifier of an interview." } ] }, "docs": "Retrieves data from a interview in Tagged Answer Model (TAM) format.\n\nThis endpoint allows you to fetch structured data for the interview, which includes the tagged answers aligned with the TAM structure.\n" } ] } ], "bundled": true }