openapi-directory/api/circuitsandbox.net.json

Building & bundling https://github.com/APIs-guru/openapi-directory for easy use from JS

{"openapi":"3.0.0","info":{"description":"Circuit REST API to interact with the Circuit system.\n\n[Learn more about the Circuit Development Community](https://www.circuit.com/web/developers/home)","title":"REST API Version 2","version":"2.9.119","x-apisguru-categories":["messaging"],"x-logo":{"backgroundColor":"#FFFFFF","url":"https://pbs.twimg.com/profile_images/927933988269903874/4jU82-IJ_400x400.jpg"},"x-origin":[{"format":"swagger","url":"https://circuitsandbox.net/rest/v2/swagger","version":"2.0"}],"x-preferred":true,"x-providerName":"circuitsandbox.net"},"paths":{"/conversations":{"get":{"description":"Gets a list of conversations and communities the authenticated user participates in.","operationId":"getConversations","parameters":[{"description":"The modification time of the conversation in UTC format. During the query the conversations before (<i>default</i>) or after this timestamp are returned. In case no timestamp is specified the current server time in UTC is used, i.e. the last 25 modified conversations are returned","in":"query","name":"modTime","required":false,"schema":{"type":"string","format":"date-time"}},{"description":"The direction of the search based on the modification time. Valid values are either BEFORE (default) or AFTER","in":"query","name":"direction","required":false,"schema":{"type":"string","maxLength":2048,"enum":["BEFORE","AFTER"],"default":"BEFORE"}},{"description":"The maximum number of returned results (default 25). The maximum allowed value is 100.","in":"query","name":"results","required":false,"schema":{"type":"number","format":"int32","minimum":1,"maximum":100,"default":25}}],"responses":{"200":{"description":"The matching conversations","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Conversation"},"type":"array"}},"application/xml":{"schema":{"items":{"$ref":"#/components/schemas/Conversation"},"type":"array"}}}},"400":{"description":"The request cannot be fulfilled due to bad syntax: <ul><li>a field constraint is violated</li></ul>"},"401":{"description":"The authentication was not successful"},"500":{"description":"The server encountered an internal error and the operation could not be completed."},"503":{"description":"The server is currently unable to receive requests."}},"security":[{"oauth":["ALL","READ_CONVERSATIONS"]}],"summary":"Gets a list of conversations","tags":["Conversation Queries"]}},"/conversations/community":{"get":{"description":"Gets a list of communities. This endpoint can be used to explore the communities the authenticated user could join.","operationId":"getCommunityConversations","parameters":[{"description":"Defines the type of sorting for the community conversations (default is alphabetical)","in":"query","name":"sort","required":false,"schema":{"type":"string","maxLength":2048,"enum":["ALPHABETICALLY","RECENT_ACTIVITY","POPULARITY"],"default":"ALPHABETICALLY"}},{"description":"Defines the ordering of the conversations (default is ascending)","in":"query","name":"order","required":false,"schema":{"type":"string","maxLength":2048,"enum":["ASCENDING","DESCENDING"],"default":"ASCENDING"}},{"description":"If set to false only conversations are returned where the user is no member of, otherwise all community conversations are returned","in":"query","name":"includeOwn","required":false,"schema":{"type":"boolean","default":false}},{"description":"The index of the conversation that is the first one that has to be returned. E.g. if a request starts with startIndex 40 and results 20 the conversations 40 to 60 are returned","in":"query","name":"startIndex","required":false,"schema":{"type":"number","format":"int32","minimum":0,"maximum":255,"default":0}},{"description":"The maximum number of returned results (default 25). The maximum allowed value is 100.","in":"query","name":"results","required":false,"schema":{"type":"number","format":"int32","minimum":1,"maximum":100,"default":25}}],"responses":{"200":{"description":"The matching conversations","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Conversation"},"type":"array"}},"application/xml":{"schema":{"items":{"$ref":"#/components/schemas/Conversation"},"type":"array"}}}},"400":{"description":"The request cannot be fulfilled due to bad syntax: <ul>a field constraint is violated</ul>"},"401":{"description":"The authentication was not successful"},"500":{"description":"The server encountered an internal error and the operation could not be completed."},"503":{"description":"The server is currently unable to receive requests."}},"security":[{"oauth":["ALL","READ_CONVERSATIONS"]}],"summary":"Gets a list of communities","tags":["Conversation Queries"]},"post":{"description":"Creates a community. Communities are open conversations that anyone in a Circuit domain (tenant) can join without having to be added by another user.","operationId":"createCommunityConversation","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"participants":{"description":"list of participants that will be part of this conversation, specified by the Circuit user ID or the unique email address. At least one participant needs to be added","type":"array","items":{"maxLength":2048,"type":"string"}},"description":{"description":"An optional description for the community conversation","type":"string","maxLength":2048},"topic":{"description":"An optional topic of the conversation. If not set the Circuit client will render the names of the participants as topic of the conversation (the first 4 names will be used)","type":"string","maxLength":2048}},"required":["topic"]}}}},"responses":{"200":{"description":"The conversation was created successfully and can be accessed via the conversation ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Conversation"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Conversation"}}}},"400":{"description":"The request cannot be fulfilled due to bad syntax: <ul><li>the userIds passed as parameter are not provided in the correct format</li><li> or an valid email address</li><li>or one or more of the user do not exist</li><li>a field constraint is violated</li></ul>"},"401":{"description":"The authentication was not successful"},"500":{"description":"The server encountered an internal error and the operation could not be completed."},"503":{"description":"The server is currently unable to receive requests."}},"security":[{"oauth":["ALL","WRITE_CONVERSATIONS","MANAGE_CONVERSATIONS"]}],"summary":"Creates a community conversation","tags":["Conversation Creation"]}},"/conversations/community/{convId}":{"put":{"description":"Updates the information of the given community.","operationId":"updateConversationCommunity","parameters":[{"description":"The ID of the conversation which should be updated","in":"path","name":"convId","required":true,"schema":{"type":"string","maxLength":2048}}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"description":{"description":"An optional description for the community conversation","type":"string","maxLength":2048},"topic":{"description":"An optional topic of the conversation. If not set the Circuit client will render the names of the participants as topic of the conversation (the first 4 names will be used)","type":"string","maxLength":2048}}}}}},"responses":{"200":{"description":"Gets the updated conversation object with the new topic / description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Conversation"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Conversation"}}}},"400":{"description":"The request cannot be fulfilled due to bad syntax: <ul><li>the conversation does not exist</li><li>the conversation is not of type COMMUNITY</li><li>a field constraint is violated</li></ul>"},"401":{"description":"The authentication was not successful"},"500":{"description":"The server encountered an internal error and the operation could not be completed."},"503":{"description":"The server is currently unable to receive requests."}},"security":[{"oauth":["ALL","WRITE_CONVERSATIONS","MANAGE_CONVERSATIONS"]}],"summary":"Updates the information of a community","tags":["Conversation Management"]}},"/conversations/community/{convId}/join":{"post":{"description":"Adds the authenticated user to the given community (i.e., allows the user to join this community). Contrary to the operation of adding a new participant, this operation can only be performed by a user who is not yet a member of the community.","operationId":"joinCommunityConversation","parameters":[{"description":"The ID of the conversation which the user will join","in":"path","name":"convId","required":true,"schema":{"type":"string","maxLength":2048}}],"responses":{"200":{"description":"Gets the conversation object to which the participants was added","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Conversation"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Conversation"}}}},"400":{"description":"The request cannot be fulfilled due to bad syntax: <ul><li>the userIds passed as parameter are not provided in the correct format</li><li> or an valid email address</li><li>or one or more of the user do not exist</li><li>the conversation does not exist</li><li>the conversation is not of type COMMUNITY</li><li>a field constraint is violated</li></ul>"},"401":{"description":"The authentication was not successful"},"500":{"description":"The server encountered an internal error and the operation could not be completed."},"503":{"description":"The server is currently unable to receive requests."}},"security":[{"oauth":["ALL","WRITE_CONVERSATIONS","MANAGE_CONVERSATIONS"]}],"summary":"Adds the authenticated user to a community","tags":["Conversation Management"]}},"/conversations/community/{convId}/participants":{"delete":{"description":"Removes one or more participants from the given community. The last participant of a community cannot be removed. This operation can only be performed by a user who is already a member of the community.","operationId":"removeParticipantCommunity","parameters":[{"description":"The ID of the conversation from which the participant have to be removed","in":"path","name":"convId","required":true,"schema":{"type":"string","maxLength":2048}},{"description":"The IDs or the unique email addresses of the Circuit users that have to be removed","in":"query","name":"participants","required":true,"explode":true,"schema":{"type":"array","items":{"maxLength":6500,"type":"string"}}}],"responses":{"200":{"description":"Gets the conversation object from which the participants were removed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Conversation"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Conversation"}}}},"400":{"description":"The request cannot be fulfilled due to bad syntax: <ul></li>the userIds passed as parameter are not provided in the correct format</li><li> or an valid email address</li><li>or one or more of the user do not exist</li><li>the conversation does not exist</li><li>the conversation is not of type COMMUNITY</li><li>a field constraint is violated</li></ul>"},"401":{"description":"The authentication was not successful"},"500":{"description":"The server encountered an internal error and the operation could not be completed."},"503":{"description":"The server is currently unable to receive requests."}},"security":[{"oauth":["ALL","WRITE_CONVERSATIONS","MANAGE_CONVERSATIONS"]}],"summary":"Removes participants from a community","tags":["Conversation Management"]},"post":{"description":"Adds one or more participants to the given community. This operation can only be performed by a user who is already a member of the community.","operationId":"addParticipantCommunity","parameters":[{"description":"The ID of the conversation to which the participant has to be added.","in":"path","name":"convId","required":true,"schema":{"type":"string","maxLength":2048}}],"requestBody":{"$ref":"#/components/requestBodies/addParticipantCommunity"},"responses":{"200":{"description":"Gets the conversation object to which the participants were added.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Conversation"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Conversation"}}}},"400":{"description":"The request cannot be fulfilled due to bad syntax: <ul><li>the userIds passed as parameter are not provided in the correct format</li><li> or an valid email address</li><li>or one or more of the user do not exist</li><li>the conversation does not exist</li><li>the conversation is not of type COMMUNITY</li><li>a field constraint is violated</li></ul>"},"401":{"description":"The authentication was not successful"},"500":{"description":"The server encountered an internal error and the operation could not be completed."},"503":{"description":"The server is currently unable to receive requests."}},"security":[{"oauth":["ALL","WRITE_CONVERSATIONS","MANAGE_CONVERSATIONS"]}],"summary":"Adds participants to a community","tags":["Conversation Management"]}},"/conversations/direct":{"get":{"description":"Checks if a 1-to-1 conversation between the authenticated user and the user with the provided userId exists.","operationId":"getDirectConversation","parameters":[{"description":"The participant that will be part of this conversation together with the creator, specified by the Circuit user ID or the unique email address","in":"query","name":"participant","required":true,"schema":{"type":"string","maxLength":2048}}],"responses":{"200":{"description":"The conversation was found and can be accessed via the conversation ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Conversation"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Conversation"}}}},"400":{"description":"The request cannot be fulfilled due to bad syntax: <ul><li>the data format of the passed user does not match either a UUID (user primary key)</li><li> or an valid email address</li><li>or the user does not exist</li><li>or the user is the same who initiates the request</li></ul>"},"401":{"description":"The authentication was not successful"},"500":{"description":"The server encountered an internal error and the operation could not be completed."},"503":{"description":"The server is currently unable to receive requests."}},"security":[{"oauth":["ALL","READ_CONVERSATIONS"]}],"summary":"Checks for a 1-to-1 conversation","tags":["Conversation Queries"]},"post":{"description":"Creates a 1-to-1 conversation between the authenticated user and the user with the provided userId. In case there is already an existing 1-to-1 conversation between these users, the endpoint returns the existing conversation.","operationId":"createDirectConversation","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"participant":{"description":"The participant that will be part of this conversation together with the creator, specified by the Circuit user ID or the unique email address","type":"string","maxLength":2048}},"required":["participant"]}}}},"responses":{"200":{"description":"The conversation was created successfully and can be accessed via the conversation ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Conversation"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Conversation"}}}},"400":{"description":"The request cannot be fulfilled due to bad syntax: <ul><li>the data format of the passed user does not match either a UUID (user primary key)</li><li> or an valid email address</li><li>or the user does not exist</li><li>or the user is the same who initiates the request</li></ul>"},"401":{"description":"The authentication was not successful"},"409":{"description":"A conversation already exists. The response contains this conversation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Conversation"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Conversation"}}}},"500":{"description":"The server encountered an internal error and the operation could not be completed."},"503":{"description":"The server is currently unable to receive requests."}},"security":[{"oauth":["ALL","WRITE_CONVERSATIONS","MANAGE_CONVERSATIONS"]}],"summary":"Creates a 1-to-1 conversation","tags":["Conversation Creation"]}},"/conversations/favorite":{"get":{"description":"Gets the conversationIds which are marked as favorites.","operationId":"getFavoriteConversations","responses":{"200":{"description":"A list of marked conversations or an empty response.","content":{"*/*":{"schema":{"items":{"$ref":"#/components/schemas/String"},"type":"array"}}}},"400":{"description":"The request cannot be fulfilled due to bad syntax: <ul><li>the conversation does not exist</li><li>the user is no participant of the conversation</li><li>a field constraint is violated</li></ul>"},"401":{"description":"The authentication was not successful"},"500":{"description":"The server encountered an internal error and the operation could not be completed."},"503":{"description":"The server is currently unable to receive requests."}},"security":[{"oauth":["ALL","READ_CONVERSATIONS"]}],"summary":"Gets favorite conversations","tags":["Conversation Queries"]}},"/conversations/group":{"post":{"description":"Creates a group conversation between three or more users. The authenticated user is directly added to this conversation.","operationId":"createGroupConversation","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"participants":{"description":"A list of participants that will be part of this conversation, specified by the Circuit user ID or the unique email address. At least one participant needs to be added","type":"array","items":{"maxLength":2048,"type":"string"}},"topic":{"description":"An optional topic of the conversation. If not set the Circuit client will render the names of the participants as topic of the conversation (the first 4 names will be used)","type":"string","maxLength":2048}},"required":["participants"]}}}},"responses":{"200":{"description":"The conversation was created successfully and can be accessed via the conversation ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Conversation"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Conversation"}}}},"400":{"description":"The request cannot be fulfilled due to bad syntax: <ul><li>the userIds passed as parameter are not provided in the correct format</li><li> or an valid email address</li><li>or one or more of the user do not exist</li><li>a field constraint is violated</li></ul>"},"401":{"description":"The authentication was not successful"},"500":{"description":"The server encountered an internal error and the operation could not be completed."},"503":{"description":"The server is currently unable to receive requests."}},"security":[{"oauth":["ALL","WRITE_CONVERSATIONS","MANAGE_CONVERSATIONS"]}],"summary":"Creates a group conversation","tags":["Conversation Creation"]}},"/conversations/group/{convId}":{"put":{"description":"Updates the information of the given group conversation.","operationId":"updateConversationGroup","parameters":[{"description":"The ID of the conversation which should be updated","in":"path","name":"convId","required":true,"schema":{"type":"string","maxLength":2048}}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"topic":{"description":"An optional topic of the conversation. If not set the Circuit client will render the names of the participants as topic of the conversation (the first 4 names will be used)","type":"string","maxLength":2048}}}}}},"responses":{"200":{"description":"Gets the updated conversation object with the new topic","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Conversation"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Conversation"}}}},"400":{"description":"The request cannot be fulfilled due to bad syntax: <ul><li>the conversation does not exist</li><li>the conversation is not of type GROUP</li><li>a field constraint is violated</li></ul>"},"401":{"description":"The authentication was not successful"},"500":{"description":"The server encountered an internal error and the operation could not be completed."},"503":{"description":"The server is currently unable to receive requests."}},"security":[{"oauth":["ALL","WRITE_CONVERSATIONS","MANAGE_CONVERSATIONS"]}],"summary":"Updates the information of a group conversation","tags":["Conversation Management"]}},"/conversations/group/{convId}/participants":{"delete":{"description":"Removes one or more participants from the given group conversation. The last participant of a group conversation cannot be removed. This operation can only be performed on behalf of a user who is already a member of the conversation.","operationId":"removeParticipantGroup","parameters":[{"description":"The ID of the conversation from which the participant have to be removed","in":"path","name":"convId","required":true,"schema":{"type":"string","maxLength":2048}},{"description":"The IDs or the unique email addresses of the Circuit users that have to be removed","in":"query","name":"participants","required":true,"explode":true,"schema":{"type":"array","items":{"maxLength":6500,"type":"string"}}}],"responses":{"200":{"description":"Gets the conversation object from which the participants were removed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Conversation"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Conversation"}}}},"400":{"description":"The request cannot be fulfilled due to bad syntax: <ul><li>the userIds passed as parameter are not provided in the correct format</li><li> or an valid email address</li><li>or one or more of the user do not exist</li><li>the conversation does not exist</li><li>the conversation is not of type GROUP</li><li>a field constraint is violated</li></ul>"},"401":{"description":"The authentication was not successful"},"500":{"description":"The server encountered an internal error and the operation could not be completed."},"503":{"description":"The server is currently unable to receive requests."}},"security":[{"oauth":["ALL","WRITE_CONVERSATIONS","MANAGE_CONVERSATIONS"]}],"summary":"Removes participants from a group conversation","tags":["Conversation Management"]},"post":{"description":"Adds one or more participants to the given group conversation. This operation can only be performed by a user who is already a member of the conversation.","operationId":"addParticipantGroup","parameters":[{"description":"The ID of the conversation to which the participant has to be added.","in":"path","name":"convId","required":true,"schema":{"type":"string","maxLength":2048}}],"requestBody":{"$ref":"#/components/requestBodies/addParticipantCommunity"},"responses":{"200":{"description":"Gets the conversation object to which the participants were added.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Conversation"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Conversation"}}}},"400":{"description":"The request cannot be fulfilled due to bad syntax: <ul><li>the userIds passed as parameter are not provided in the correct format</li><li> or an valid email address</li><li>or one or more of the user do not exist</li><li>the conversation does not exist</li><li>the conversation is not of type GROUP</li><li>a field constraint is violated</li></ul>"},"401":{"description":"The authentication was not successful"},"500":{"description":"The server encountered an internal error and the operation could not be completed."},"503":{"description":"The server is currently unable to receive requests."}},"security":[{"oauth":["ALL","WRITE_CONVERSATIONS","MANAGE_CONVERSATIONS"]}],"summary":"Adds participants to a group conversation","tags":["Conversation Management"]}},"/conversations/messages/flag":{"get":{"description":"Gets a list of all the messages the authenticated user has flagged. This endpoint should be used carefully in case where the authenticated user has a lot of flagged messages.","operationId":"getFlagItemConv","responses":{"200":{"description":"Gets the list of flagged items","content":{"*/*":{"schema":{"items":{"$ref":"#/components/schemas/ConversationItem"},"type":"array"}}}},"401":{"description":"The authentication was not successful"},"500":{"description":"The server encountered an internal error and the operation could not be completed."},"503":{"description":"The server is currently unable to receive requests."}},"security":[{"oauth":["ALL","READ_CONVERSATIONS"]}],"summary":"Gets a list of the flagged messages","tags":["Messaging (Advanced)"]}},"/conversations/messages/{itemId}":{"get":{"description":"Returns a text item for a given item id","operationId":"getSingleConversationtem","parameters":[{"description":"The ID of the item that will be returned","in":"path","name":"itemId","required":true,"schema":{"type":"string","maxLength":2048}}],"responses":{"200":{"description":"The item was successful returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationItem"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ConversationItem"}}}},"400":{"description":"The item with the given id was not found"},"401":{"description":"The authentication was not successful"},"500":{"description":"The server encountered an internal error and the operation could not be completed."},"503":{"description":"The server is currently unable to receive requests."}},"security":[{"oauth":["ALL","READ_CONVERSATIONS"]}],"summary":"Returns a text item","tags":["Messaging (Basic)"]}},"/conversations/resolveinvitetoken":{"get":{"description":"Resolves an invite token to a conversation","operationId":"resolveInvitationToken","parameters":[{"description":"The invite token to resolve","in":"query","name":"token","required":true,"schema":{"type":"string","maxLength":2048}}],"responses":{"200":{"description":"Returns the conversation object that belongs to the invite token if you are member of the conversation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Conversation"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Conversation"}}}},"400":{"description":"In case no invitation token was send"},"401":{"description":"The authentication was not successful"},"404":{"description":"If the token does not exist or you are not member of the conversation "},"500":{"description":"The server encountered an internal error and the operation could not be completed."},"503":{"description":"The server is currently unable to receive requests."}},"security":[{"oauth":["ALL","READ_CONVERSATIONS"]}],"summary":"Resolves an invite token to a conversation","tags":["Conversation Management"]}},"/conversations/search":{"get":{"description":"Performs a search for conversation content. A maximum of 100 conversations is returned. If you hit this limit you should refine the search term.","operationId":"searchConversations","parameters":[{"description":"The search term","in":"query","name":"term","required":true,"schema":{"type":"string","maxLength":2048}},{"description":"Optional parameter to specify if a deep or normal search is executed. In a deep search all matching item IDs inside every conversation are returned (up to a maximum of 100). For a normal search only the conversation IDs are returned. Default is a normal search (without item IDs).","in":"query","name":"includeItemIds","required":false,"schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"A list of conversations and items that match the term","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationSearchResult"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ConversationSearchResult"}}}},"400":{"description":"The request cannot be fulfilled due to bad syntax: <ul><li>the user is no participant of the conversation</li><li>a field constraint is violated</li></ul>"},"401":{"description":"The authentication was not successful"},"500":{"description":"The server encountered an internal error and the operation could not be completed."},"503":{"description":"The server is currently unable to receive requests."}},"security":[{"oauth":["ALL","WRITE_CONVERSATIONS"]}],"summary":"Performs a conversation search","tags":["Conversation Queries"]}},"/conversations/{convId}":{"get":{"description":"Gets a conversation based on the given ID.","operationId":"getConversationbyId","parameters":[{"description":"The ID of the conversation which should be updated","in":"path","name":"convId","required":true,"schema":{"type":"string","maxLength":2048}}],"responses":{"200":{"description":"Gets the conversation object","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Conversation"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Conversation"}}}},"400":{"description":"The request cannot be fulfilled due to bad syntax: <ul><li>the conversation does not exist</li><li>a field constraint is violated</li></ul>"},"401":{"description":"The authentication was not successful"},"500":{"description":"The server encountered an internal error and the operation could not be completed."},"503":{"description":"The server is currently unable to receive requests."}},"security":[{"oauth":["ALL","READ_CONVERSATIONS"]}],"summary":"Gets a conversation","tags":["Conversation Queries"]}},"/conversations/{convId}/conversationdetails":{"get":{"description":"Gets the conference details of the given conversation. Conference details include the URL, which is used to join the conference through a web or mobile application, as well as the dial-in phone numbers and conference PIN, which are used to join the conference by phone.","operationId":"getJoinDetails","parameters":[{"description":"The ID of the conversation for which the join details should be returned","in":"path","name":"convId","required":true,"schema":{"type":"string","maxLength":2048}}],"responses":{"200":{"description":"The join details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationDetails"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ConversationDetails"}}}},"400":{"description":"The request cannot be fulfilled due to bad syntax: <ul><li>the conversation does not exist</li></ul>"},"401":{"description":"The authentication was not successful"},"500":{"description":"The server encountered an internal error and the operation could not be completed."},"503":{"description":"The server is currently unable to receive requests."}},"security":[{"oauth":["ALL","READ_CONVERSATIONS"]}],"summary":"Gets the conference details of a conversation","tags":["Conversation Management"]}},"/conversations/{convId}/favorite":{"delete":{"description":"Removes a conversation from favorites. Favorites can be displayed in a separate side tab inside of the Circuit client to have a better overview of important conversations.","operationId":"deleteFavorite","parameters":[{"description":"The ID of the conversation which will be unmarked as favorite","in":"path","name":"convId","required":true,"schema":{"type":"string","maxLength":2048}}],"responses":{"200":{"description":"The conversation was successfully unmarked"},"400":{"description":"The request cannot be fulfilled due to bad syntax: <ul><li>the conversation does not exist</li><li>the user is no participant of the conversation</li><li>a field constraint is violated</li><li>the conversation was not marked before</li></ul>"},"401":{"description":"The authentication was not successful"},"500":{"description":"The server encountered an internal error and the operation could not be completed."},"503":{"description":"The server is currently unable to receive requests."}},"security":[{"oauth":["ALL","WRITE_CONVERSATIONS"]}],"summary":"Removes a conversation from favorites","tags":["Messaging (Advanced)"]},"post":{"description":"Adds a conversation to the favorites. Favorites can be displayed in a separate side tab inside of the Circuit client to have a better overview of important conversations.","operationId":"addFavorite","parameters":[{"description":"The ID of the conversation which will be marked as favorite","in":"path","name":"convId","required":true,"schema":{"type":"string","maxLength":2048}}],"responses":{"200":{"description":"The conversation was successfully marked"},"400":{"description":"The request cannot be fulfilled due to bad syntax: <ul><li>the conversation does not exist</li><li>the user is no participant of the conversation</li><li>a field constraint is violated</li></ul>"},"401":{"description":"The authentication was not successful"},"500":{"description":"The server encountered an internal error and the operation could not be completed."},"503":{"description":"The server is currently unable to receive requests."}},"security":[{"oauth":["ALL","WRITE_CONVERSATIONS"]}],"summary":"Adds a conversation to the favorites","tags":["Messaging (Advanced)"]}},"/conversations/{convId}/items":{"get":{"description":"Gets a list of conversation items.","operationId":"getConversationItems","parameters":[{"description":"The ID of the conversation to which the items belong","in":"path","name":"convId","required":true,"schema":{"type":"string","maxLength":2048}},{"description":"The modification time of the item in UTC format. During the query the items before (default) or after this timestamps are returned. In case no timestamp is specified the current server time in UTC is used, i.e. the last 25 modified items are returned","in":"query","name":"modTime","required":false,"schema":{"type":"string","format":"date-time"}},{"description":"The direction of the search based on the modification time. Valid values are either BEFORE (default) or AFTER","in":"query","name":"direction","required":false,"schema":{"type":"string","maxLength":2048,"enum":["BEFORE","AFTER"],"default":"BEFORE"}},{"description":"The maximum number of returned results (default 25). The maximum allowed value is 100.","in":"query","name":"results","required":false,"schema":{"type":"number","format":"int32","minimum":1,"maximum":100,"default":25}}],"responses":{"200":{"description":"The matching conversation items","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ConversationItem"},"type":"array"}},"application/xml":{"schema":{"items":{"$ref":"#/components/schemas/ConversationItem"},"type":"array"}}}},"400":{"description":"The request cannot be fulfilled due to bad syntax: <ul><li>a field constraint is violated</li></ul>"},"401":{"description":"The authentication was not successful"},"500":{"description":"The server encountered an internal error and the operation could not be completed."},"503":{"description":"The server is currently unable to receive requests."}},"security":[{"oauth":["ALL","WRITE_CONVERSATIONS"]}],"summary":"Gets a list of conversation items","tags":["Messaging (Basic)"]}},"/conversations/{convId}/label":{"post":{"description":"Adds a label to a conversation, you can search and organize your conversations based on these labels","operationId":"assignLabel","parameters":[{"description":"The ID of the conversation to which the label is added","in":"path","name":"convId","required":true,"schema":{"type":"string","maxLength":2048}}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"label":{"description":"The actual label ","type":"string","maxLength":2048}},"required":["label"]}}}},"responses":{"200":{"description":"The label was successfully added","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Label"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Label"}}}},"400":{"description":"The request cannot be fulfilled due to bad syntax: <ul><li>a field constraint is violated</li><li>you reached the maximum of 250 labels</li></ul>"},"401":{"description":"The authentication was not successful"},"500":{"description":"The server encountered an internal error and the operation could not be completed."},"503":{"description":"The server is currently unable to receive requests."}},"security":[{"oauth":["ALL","WRITE_CONVERSATIONS","ORGANIZE_CONVERSATIONS"]}],"summary":"Adds a label to a conversation","tags":["Conversation Management"]}},"/conversations/{convId}/label/{labelId}":{"delete":{"description":"Removes a label from a conversation, you can search and organize your conversations based on these labels","operationId":"unassignLabel","parameters":[{"description":"The ID of the conversation from which the label is removed","in":"path","name":"convId","required":true,"schema":{"type":"string","maxLength":2048}},{"description":"not available","in":"path","name":"labelId","required":true,"schema":{"type":"string","maxLength":2048}}],"responses":{"200":{"description":"The label was successfully removed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Label"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Label"}}}},"400":{"description":"The request cannot be fulfilled due to bad syntax: <ul><li>a field constraint is violated</li><li>the label was not assigned to the conversation</li></ul>"},"401":{"description":"The authentication was not successful"},"500":{"description":"The server encountered an internal error and the operation could not be completed."},"503":{"description":"The server is currently unable to receive requests."}},"security":[{"oauth":["ALL","WRITE_CONVERSATIONS"]}],"summary":"Removes a label from a conversation","tags":["Conversation Management"]}},"/conversations/{convId}/messages":{"post":{"description":"Adds a message to the given conversation. This operation can be only performed on behalf of a user who is already a member of the conversation.","operationId":"addTextItem","parameters":[{"description":"The ID of the conversation to which the new item has to be added","in":"path","name":"convId","required":true,"schema":{"type":"string","maxLength":2048}}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"content":{"description":"The actual content of the item, is mandatory unless an attachment is added","type":"string","maxLength":16384},"attachments":{"description":"A comma separated list of attachment IDs from the file API.","type":"array","items":{"maxLength":16000,"type":"string"}},"subject":{"description":"The subject (headline) of the new text item","type":"string","maxLength":255},"formMetaData":{"description":"not available","type":"string","maxLength":32768}}}}}},"responses":{"200":{"description":"Gets the new text item object","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationItem"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ConversationItem"}}}},"400":{"description":"The request cannot be fulfilled due to bad syntax: <ul><li>the conversation does not exist</li><li>the user is no participant of the conversation</li><li>a field constraint is violated</li></ul>"},"401":{"description":"The authentication was not successful"},"500":{"description":"The server encountered an internal error and the operation could not be completed."},"503":{"description":"The server is currently unable to receive requests."}},"security":[{"oauth":["ALL","WRITE_CONVERSATIONS","CREATE_CONVERSATIONS_CONTENT"]}],"summary":"Adds a message to a conversation","tags":["Messaging (Basic)"]}},"/conversations/{convId}/messages/flag":{"get":{"description":"Gets a list of all the flagged messages in the given conversation.","operationId":"getFlagItem","parameters":[{"description":"The ID of the conversation to which the item belongs","in":"path","name":"convId","required":true,"schema":{"type":"string","maxLength":2048}}],"responses":{"200":{"description":"Gets the list of flagged items","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ConversationItem"},"type":"array"}},"application/xml":{"schema":{"items":{"$ref":"#/components/schemas/ConversationItem"},"type":"array"}}}},"400":{"description":"The request cannot be fulfilled due to bad syntax: <ul><li>the conversation does not exist</li><li>a field constraint is violated</li></ul>"},"401":{"description":"The authentication was not successful"},"500":{"description":"The server encountered an internal error and the operation could not be completed."},"503":{"description":"The server is currently unable to receive requests."}},"security":[{"oauth":["ALL","READ_CONVERSATIONS","ORGANIZE_CONVERSATIONS"]}],"summary":"Gets a list of the flagged messages of a conversation","tags":["Messaging (Advanced)"]}},"/conversations/{convId}/messages/{itemId}":{"delete":{"description":"Marks a message in the given conversation as deleted. Deleted messages are still part of the conversation, but their content is no more visible. This operation can only be performed on behalf of the message's creator.","operationId":"deleteTextItem","parameters":[{"description":"The ID of the conversation to which the item belongs","in":"path","name":"convId","required":true,"schema":{"type":"string","maxLength":2048}},{"description":"The ID of the item that will be deleted","in":"path","name":"itemId","required":true,"schema":{"type":"string","maxLength":2048}}],"responses":{"200":{"description":"Gets the deleted text item object","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationItem"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ConversationItem"}}}},"400":{"description":"The request cannot be fulfilled due to bad syntax: <ul><li>the conversation does not exist</li><li>the item does not exist</li><li>the user is no participant of the conversation</li><li>a field constraint is violated</li></ul>"},"401":{"description":"The authentication was not successful"},"500":{"description":"The server encountered an internal error and the operation could not be completed."},"503":{"description":"The server is currently unable to receive requests."}},"security":[{"oauth":["ALL","WRITE_CONVERSATIONS","DELETE_CONVERSATIONS_CONTENT"]}],"summary":"Deletes a message from a conversation","tags":["Messaging (Basic)"]},"post":{"description":"Adds a message to the existing item. The added message will be a child item of the message with the given itemId.","operationId":"addTextItemWithParent","parameters":[{"description":"The ID of the conversation to which the new item has to be added","in":"path","name":"convId","required":true,"schema":{"type":"string","maxLength":2048}},{"description":"The ID of the item to which the new one has to be added as child","in":"path","name":"itemId","required":true,"schema":{"type":"string","maxLength":2048}}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"content":{"description":"The actual content of the item","type":"string","maxLength":16384},"attachments":{"description":"not available","type":"array","items":{"maxLength":4096,"type":"string"}},"subject":{"description":"The subject (headline) of the new text item","type":"string","maxLength":255},"formMetaData":{"description":"not available","type":"string","maxLength":32768}}}}}},"responses":{"200":{"description":"Gets the new text item object","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationItem"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ConversationItem"}}}},"400":{"description":"The request cannot be fulfilled due to bad syntax: <ul><li>the conversation does not exist</li><li>the parent item does not exist</li><li>the user is no participant of the conversation</li><li>a field constraint is violated</li></ul>"},"401":{"description":"The authentication was not successful"},"500":{"description":"The server encountered an internal error and the operation could not be completed."},"503":{"description":"The server is currently unable to receive requests."}},"security":[{"oauth":["ALL","WRITE_CONVERSATIONS"]}],"summary":"Adds a message to an item","tags":["Messaging (Basic)"]},"put":{"description":"Updates the content or subject of the existing message. Only the creator of the message is allowed to perform this operation.","operationId":"updateTextItem","parameters":[{"description":"The ID of the conversation to which the item belongs","in":"path","name":"convId","required":true,"schema":{"type":"string","maxLength":2048}},{"description":"The ID of the item to update","in":"path","name":"itemId","required":true,"schema":{"type":"string","maxLength":2048}}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"content":{"description":"The actual content of the item","type":"string","maxLength":16384},"attachments":{"description":"not available","type":"array","items":{"maxLength":16000,"type":"string"}},"subject":{"description":"The subject (headline) of the new text item","type":"string","maxLength":255},"formMetaData":{"description":"not available","type":"string","maxLength":32768}}}}}},"responses":{"200":{"description":"Gets the modified text item object","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationItem"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ConversationItem"}}}},"400":{"description":"The request cannot be fulfilled due to bad syntax: <ul><li>the conversation does not exist</li><li>the user is no participant of the conversation</li><li>a field constraint is violated</li></ul>"},"401":{"description":"The authentication was not successful"},"500":{"description":"The server encountered an internal error and the operation could not be completed."},"503":{"description":"The server is currently unable to receive requests."}},"security":[{"oauth":["ALL","WRITE_CONVERSATIONS","UPDATE_CONVERSATION_CONTENT"]}],"summary":"Updates a message","tags":["Messaging (Basic)"]}},"/conversations/{convId}/messages/{itemId}/flag":{"delete":{"description":"Removes the flag from a given message that is posted to the given conversation.","operationId":"unFlagItem","parameters":[{"description":"The ID of the conversation to which the item belongs","in":"path","name":"convId","required":true,"schema":{"type":"string","maxLength":2048}},{"description":"The ID of the item that will be flagged","in":"path","name":"itemId","required":true,"schema":{"type":"string","maxLength":2048}}],"responses":{"200":{"description":"The flagged state of item was successfully removed"},"400":{"description":"The request cannot be fulfilled due to bad syntax: <ul><li>the conversation does not exist</li><li>the item does not exist</li><li>the user is no participant of the conversation</li><li>a field constraint is violated</li></ul>"},"401":{"description":"The authentication was not successful"},"500":{"description":"The server encountered an internal error and the operation could not be completed."},"503":{"description":"The server is currently unable to receive requests."}},"security":[{"oauth":["ALL","WRITE_CONVERSATIONS","ORGANIZE_CONVERSATIONS"]}],"summary":"Removes the flag from a message","tags":["Messaging (Advanced)"]},"post":{"description":"Adds a flag to the given message in the given conversation.","operationId":"flagItem","parameters":[{"description":"The ID of the conversation to which the item belongs","in":"path","name":"convId","required":true,"schema":{"type":"string","maxLength":2048}},{"description":"The ID of the item that will be flagged","in":"path","name":"itemId","required":true,"schema":{"type":"string","maxLength":2048}}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"itemCreationTime":{"description":"The time when the item was created","type":"string","maxLength":2048},"parentId":{"description":"The ID of the item's parent","type":"string","maxLength":2048}}}}}},"responses":{"200":{"description":"The item was successful flagged"},"400":{"description":"The request cannot be fulfilled due to bad syntax: <ul><li>the conversation does not exist</li><li>the item does not exist</li><li>the user is no participant of the conversation</li><li>a field constraint is violated</li></ul>"},"401":{"description":"The authentication was not successful"},"500":{"description":"The server encountered an internal error and the operation could not be completed."},"503":{"description":"The server is currently unable to receive requests."}},"security":[{"oauth":["ALL","WRITE_CONVERSATIONS","ORGANIZE_CONVERSATIONS"]}],"summary":"Adds a flag to a message in a conversation","tags":["Messaging (Advanced)"]}},"/conversations/{convId}/messages/{itemId}/like":{"delete":{"description":"Removes a \"like\" from the given message in the given conversation","operationId":"unlikeItem","parameters":[{"description":"The ID of the conversation to which the item belongs","in":"path","name":"convId","required":true,"schema":{"type":"string","maxLength":2048}},{"description":"The ID of the item that will be unliked","in":"path","name":"itemId","required":true,"schema":{"type":"string","maxLength":2048}}],"responses":{"200":{"description":"The item was successful unliked"},"400":{"description":"The request cannot be fulfilled due to bad syntax: <ul><li>the conversation does not exist</li><li>the item does not exist</li><li>the user is no participant of the conversation</li><li>a field constraint is violated</li></ul>"},"401":{"description":"The authentication was not successful"},"500":{"description":"The server encountered an internal error and the operation could not be completed."},"503":{"description":"The server is currently unable to receive requests."}},"security":[{"oauth":["ALL",