Developer Blog
News, tips, and stories about Khoros platform development and integration
Recent Content
Can somebody help me with session keys?
Hello, We'd like to connect one of our group hub with our Power BI report. We'd like to see the list of users synched automatically (it's a hidden group hub, and whoever joins the group grabs a license automatically to our beta software too). So far it seems that Bulk API was not really helpful with that, but Search API would be a great fit. However, this is where we have our problem - it requires a session key, that we don't know how to get. We use SSO on our site (SAML), and I can't seem to find anything useful in the documentation (https://developer.khoros.com/khoroscommunitydevdocs/docs/search-api-overview)... Can somebody help me how to make this work? We're running on Classic currently. Thanks, NoémiAurora Email Templates
Hi everyone, I am new to GraphQL, so please forgive any silly questions here. I've successfully set myself up in Postman, and can retrieve email templates. I understand the documentation here about the process of updating a template, but I am hung up on viewing the HTML within each template so that I might edit that. My end goal, hopefully, is to be able to glean the variable for a post title within say, the Mentions template, and put that into the Subject of the email. So instead of "{User} mentioned you on {Community Title}" I would ideally have a subject that says "{User} mentioned you in the thread {Post Title}" I would also like to edit other pieces of other emails, but looking to cut my teeth on this one. Has anyone had success making a change like this on Aurora, and might be able to point me in the right direction? Thank you!Cannot successfully archive message via API v2
Has anyone been able to successfully archive a message using the Community API v2 POST call documented in the Developer Docs? I've tried several ways and can't seem to get it to work. For example: Using the restadmin directive <#assign response = restadmin("2.0", "/archives/archive", "POST", {"messageId": "32815"}) /> Status: ${response.status}<br /> Message: ${response.message}<br /> Data Keys:<br /> <#list response.data?keys as dataKey> - ${dataKey}<br /> </#list> Using the restBuilder directive <#assign archivePostCall = restBuilder() .method("POST") .path("/archives/archive") .body({"messageId": "32815"}) .admin(true) /> <#assign response = archivePostCall.call() /> Status: ${response.status}<br /> Message: ${response.message}<br /> Data Keys:<br /> <#list response.data?keys as dataKey> - ${dataKey}<br /> </#list> Both attempts above returned the following response: Status: error Message: Error generating JSON response. Data Keys: - getClass - validTemplateModelObject - toSerializedString - isValidTemplateModelObject - hashCode - equals - get - toString - class I tried performing the same operation via Python (as shown below) but the response is either a 400 or 500 error depending on whether or not I explicitly define the "content-type" header as "application/json" in my request. Attempt #1: Python 3.7.6 (tags/v3.7.6:43364a7ae0, Dec 19 2019, 00:42:30) [MSC v.1916 64 bit (AMD64)] on win32 >>> from khoros import Khoros >>> khoros = Khoros() >>> response = khoros.post('/api/2.0/archives/archive', {'messageId': '32815'}, return_json=False) >>> response <Response [400]> >>> response.text '{"status":"error","message":"A possible invalid request has been made. Make sure you are following the API spec and have used the correct URL, are included all required parameters and if a request payload is required you have included one.","data":{"type":"error_data","code":309,"developer_message":"","more_info":""},"metadata":{}}' >>> response.request.url 'https://REDACTED.com/api/2.0/archives/archive' >>> response.request.body '{"messageId": "32815"}' >>> response.request.headers {'User-Agent': 'python-requests/2.23.0', 'Accept-Encoding': 'gzip, deflate', 'Accept': '*/*', 'Connection': 'keep-alive', 'li-api-session-key': 'REDACTED', 'Content-Length': '22'} Attempt #2: >>> response = khoros.post('/api/2.0/archives/archive', {'messageId': '32815'}, headers={'content-type': 'application/json'}, return_json=False) >>> response <Response [500]> >>> response.text '{"status":"error","message":"An unexpected error occurred.","data":{"type":"error_data","code":301,"developer_message":"Can not deserialize instance of java.util.ArrayList out of START_OBJECT token\\n at [Source: org.apache.catalina.connector.CoyoteInputStream@34f637da; line: 1, column: 1]","more_info":""},"metadata":{}}' >>> response.request.headers {'User-Agent': 'python-requests/2.23.0', 'Accept-Encoding': 'gzip, deflate', 'Accept': '*/*', 'Connection': 'keep-alive', 'li-api-session-key': 'REDACTED', 'content-type': 'application/json', 'Content-Length': '22'} I was hoping I could do a network trace of the archival process in the web UI to see what the syntax should be, but it looks like a different UI-specific endpoint and form is used to perform the operation so I couldn't learn anything from it. Any help with this would be greatly appreciated. Thanks!
Featuring a topic in Khoros Classic
Hi all, I'm looking for a way to be able to feature a give topic via the REST API v2. I tried doing this in a test endpoint, <#assign feature_call = restBuilder() .method("PUT") .path("/messages/11577") .body({ "data": { "type": "message", "conversation": { "featured": true } } }) .admin(true) /> but it fails with the following error: { "status":"error", "message":"The following parameters, or the value passed in for them, are not valid: [featured].", "data":{ "type":"error_data", "code":404, "developer_message":"The parameter featured is not allowed in an 'update' call.", "more_info":"" }, "metadata":{} } I couldn't find anything in the REST API v1 either. Is there no way to actually feature a message via the API?Getting a 414 error code when updating messages via API
We have a third party tool where we can update messages in TKBs. I'm using the session key for authentication using a non-SSO user with their username and password to get and refresh the session key. The user has Admin permissions across the entire community (for testing this), their email is verified, I've checked to make sure their account is correctly set up and working and that their permissions are correct. However, when I run the call for certain TKBs, I get this error: {"status":"error","message":"Permission Denied","data":{"type":"error_data","code":414,"developer_message":"","more_info":""},"metadata":{}} But when I run it for other TKBs, I don't get the error. I've looked at both TKBs and I'm scratching my head. Permissions are the same, settings are the same, essentially everything is the same besides which category they're in, but I've checked permissions in all categories/sub-categories and there are no differences. Any idea why this would happen or why I'm getting Permission Denied for a user with Admin permissions in some TKBs but not others?Freezing Kudos on a Topic on Classic
Hi all, Is there a way via either rest v1 or v2 (preferably the latter) to freeze the kudos for a given topic? I see that I can make a topic read only, but don't seen an obvious way to disable kudoing. Not sure if this is possible, but given gaps in the docs, I'm hoping that it's doable but that the field to update is not available with a select * query in the API browser. Thanks!
Featured Places
Release Notes & Updates
Review release notes and updates for all of our products! Select a tag to browse by product or resource type.Help & Support
Find solutions and support for Khoros productsSupport Information
Review general information about Khoros Support
Events & Webinars
Learn more about your Khoros solution with helpful webinars and special events
