{"openapi":"3.0.0","info":{"description":"Slack Web API (bot token): messaging, conversations, files, canvases, lists, usergroups and agent session code channels. Admin methods live in Slack Admin (slackadmin); user-token methods in Slack User (slackuser).","version":[{"name":"-","value":"-"}]},"servers":[{"description":"Slack Web API (bot token): messaging, conversations, files, canvases, lists, usergroups and agent session code channels. Admin methods live in Slack Admin (slackadmin); user-token methods in Slack User (slackuser).","url":"https://api.apirails.com/slack"}],"paths":{"/agents.sessions.rename":{"post":{"tags":["Agents Sessions"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/agents.sessions.rename","api_endpoint":"https://slack.com/api/agents.sessions.rename"},"summary":"Rename an agent session.","description":"Rename an agent session.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel_id":{"type":"string","description":"ID of the channel containing the agent session. Required for public channels."},"thread_ts":{"type":"string","description":"Timestamp of the thread root message the session is scoped to. Required for thread-based sessions in regular channels and DMs. Must be omitted for session channels."},"title":{"type":"string","description":"New title for the agent session (1-200 characters). For a session channel, this also renames the channel.","required":true}}},"example":{"channel_id":"","thread_ts":"","title":""}}}}}},"/agents.sessions.setStatus":{"post":{"tags":["Agents Sessions"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/agents.sessions.setStatus","api_endpoint":"https://slack.com/api/agents.sessions.setStatus"},"summary":"Set an agent session's lifecycle status, creating the session if needed.","description":"Set an agent session's lifecycle status, creating the session if needed.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel_id":{"type":"string","description":"ID of the channel containing the agent session. Required for public channels."},"icon_emoji":{"type":"string","description":"Emoji to use as the agent's icon. Takes priority over iconurl. Remains in effect until you clear it (pass null) or set a new value. Requires the chat:write.customize scope."},"icon_url":{"type":"string","description":"URL to an image to use as the agent's icon. Remains in effect until you clear it (pass null) or set a new value. Requires the chat:write.customize scope."},"initiator_user_id":{"type":"string","description":"The user who initiated the session. Only used when creating a new session; ignored if the session already exists. Must be a member of the channel."},"status":{"type":"string","description":"The lifecycle status to set. Acceptable values: active processing suspended closed","required":true},"thread_ts":{"type":"string","description":"Timestamp of the thread root message the session is scoped to. Required for thread-based sessions in regular channels and DMs. Must be omitted for session channels."},"title":{"type":"string","description":"Title for the agent session (max 200 characters). Only used when creating a new session; ignored if the session already exists. To rename an existing session, use agents.sessions.rename."},"username":{"type":"string","description":"Display name override for the agent (max 200 characters). Remains in effect until you clear it (pass null) or set a new value. Requires the chat:write.customize scope."}}},"example":{"channel_id":"","icon_emoji":"","icon_url":"","initiator_user_id":"","status":"","thread_ts":"","title":"","username":""}}}}}},"/api.test":{"get":{"tags":["Api"],"parameters":[{"name":"error","in":"query","description":"Error response to return","schema":{"type":"string","example":""}},{"name":"foo","in":"query","description":"example property to return","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/api.test","api_endpoint":"https://slack.com/api/api.test"},"summary":"Checks API calling code. 🚧","description":"Checks API calling code.","security":[{"bearerAuth":[]}]}},"/apps.auth.external.delete":{"post":{"tags":["Apps Auth External"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/apps.auth.external.delete","api_endpoint":"https://slack.com/api/apps.auth.external.delete"},"summary":"Delete external auth tokens only on the Slack side","description":"Delete external auth tokens only on the Slack side","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"app_id":{"type":"string","description":"The id of the app whose tokens you want to delete"},"external_token_id":{"type":"string","description":"The id of the token that you want to delete   "},"provider_key":{"type":"string","description":"The provider key of the provider whose tokens you want to delete"}}},"example":{"app_id":"","external_token_id":"","provider_key":""}}}}}},"/apps.auth.external.get":{"post":{"tags":["Apps Auth External"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/apps.auth.external.get","api_endpoint":"https://slack.com/api/apps.auth.external.get"},"summary":"Get the access token for the provided token ID","description":"Get the access token for the provided token ID","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"external_token_id":{"type":"string","description":"The id of the token you want to get the token for","required":true},"force_refresh":{"type":"boolean","description":"Always refresh existing token before returning even when the token has not expired","enum":[true,false]}}},"example":{"external_token_id":"","force_refresh":""}}}}}},"/apps.connections.open":{"post":{"tags":["Apps Connections"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/apps.connections.open","api_endpoint":"https://slack.com/api/apps.connections.open"},"summary":"Generate a temporary Socket Mode WebSocket URL that your app can connect to in order to receive events and interactive payloads over.","description":"Generate a temporary Socket Mode WebSocket URL that your app can connect to in order to receive events and interactive payloads over.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/apps.datastore.bulkDelete":{"post":{"tags":["Apps Datastore"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/apps.datastore.bulkDelete","api_endpoint":"https://slack.com/api/apps.datastore.bulkDelete"},"summary":"Delete items from a datastore in bulk","description":"Delete items from a datastore in bulk","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"datastore":{"type":"string","description":"name of the datastore","required":true},"ids":{"type":"string","description":"IDs of items to be deleted","required":true}}},"example":{"datastore":"","ids":""}}}}}},"/apps.datastore.bulkGet":{"post":{"tags":["Apps Datastore"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/apps.datastore.bulkGet","api_endpoint":"https://slack.com/api/apps.datastore.bulkGet"},"summary":"Get items from a datastore in bulk","description":"Get items from a datastore in bulk","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"datastore":{"type":"string","description":"name of the datastore","required":true},"ids":{"type":"string","description":"items' ids","required":true}}},"example":{"datastore":"","ids":""}}}}}},"/apps.datastore.bulkPut":{"post":{"tags":["Apps Datastore"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/apps.datastore.bulkPut","api_endpoint":"https://slack.com/api/apps.datastore.bulkPut"},"summary":"Creates or replaces existing items in bulk","description":"Creates or replaces existing items in bulk","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"datastore":{"type":"string","description":"name of the datastore","required":true},"items":{"type":"string","description":"attribute names and values of the items; limit of 25","required":true}}},"example":{"datastore":"","items":""}}}}}},"/apps.datastore.count":{"post":{"tags":["Apps Datastore"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/apps.datastore.count","api_endpoint":"https://slack.com/api/apps.datastore.count"},"summary":"Count the number of items in a datastore that match a query","description":"Count the number of items in a datastore that match a query","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"datastore":{"type":"string","description":"Name of the datastore","required":true},"expression":{"type":"string","description":"A query filter expression"},"expression_attributes":{"type":"string","description":"A map of attributes referenced in expression"},"expression_values":{"type":"string","description":"A map of values referenced in expression"}}},"example":{"datastore":"","expression":"","expression_attributes":"","expression_values":""}}}}}},"/apps.datastore.delete":{"post":{"tags":["Apps Datastore"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/apps.datastore.delete","api_endpoint":"https://slack.com/api/apps.datastore.delete"},"summary":"Delete an item from a datastore","description":"Delete an item from a datastore","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"datastore":{"type":"string","description":"name of the datastore","required":true},"id":{"type":"string","description":"item id","required":true}}},"example":{"datastore":"","id":""}}}}}},"/apps.datastore.get":{"post":{"tags":["Apps Datastore"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/apps.datastore.get","api_endpoint":"https://slack.com/api/apps.datastore.get"},"summary":"Get an item from a datastore","description":"Get an item from a datastore","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"datastore":{"type":"string","description":"name of the datastore","required":true},"id":{"type":"string","description":"item id","required":true}}},"example":{"datastore":"","id":""}}}}}},"/apps.datastore.put":{"post":{"tags":["Apps Datastore"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/apps.datastore.put","api_endpoint":"https://slack.com/api/apps.datastore.put"},"summary":"Creates a new item, or replaces an old item with a new item.","description":"Creates a new item, or replaces an old item with a new item.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"datastore":{"type":"string","description":"name of the datastore","required":true},"item":{"type":"string","description":"attribute names and values of the item","required":true}}},"example":{"datastore":"","item":""}}}}}},"/apps.datastore.query":{"post":{"tags":["Apps Datastore"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/apps.datastore.query","api_endpoint":"https://slack.com/api/apps.datastore.query"},"summary":"Query a datastore for items","description":"Query a datastore for items","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"cursor":{"type":"string","description":"Set cursor to nextcursor returned by the previous call to list items in the next page"},"datastore":{"type":"string","description":"Name of the datastore","required":true},"expression":{"type":"string","description":"A query filter expression"},"expression_attributes":{"type":"string","description":"A map of attributes referenced in expression"},"expression_values":{"type":"string","description":"A map of values referenced in expression"},"limit":{"type":"number","description":"The maximum number of items to evaluate for a given request (not necessarily the number of matching items). If the given request dataset size exceeds 1 MB before reaching the limit, the returned item count will likely be less than the limit. In any case where there are more items available beyond an imposed limit, a nextcursor value will be provided for use in subsequent requests. Default: 100"}}},"example":{"cursor":"","datastore":"","expression":"","expression_attributes":"","expression_values":"","limit":""}}}}}},"/apps.datastore.update":{"post":{"tags":["Apps Datastore"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/apps.datastore.update","api_endpoint":"https://slack.com/api/apps.datastore.update"},"summary":"Edits an existing item's attributes, or adds a new item if it does not already exist.","description":"Edits an existing item's attributes, or adds a new item if it does not already exist.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"datastore":{"type":"string","description":"name of the datastore","required":true},"item":{"type":"string","description":"attribute names and values to be updated","required":true}}},"example":{"datastore":"","item":""}}}}}},"/apps.event.authorizations.list":{"get":{"tags":["Apps Event Authorizations"],"parameters":[{"name":"cursor","in":"query","schema":{"type":"string","example":""}},{"name":"event_context","in":"query","required":true,"schema":{"type":"string","example":""}},{"name":"limit","in":"query","schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/apps.event.authorizations.list","api_endpoint":"https://slack.com/api/apps.event.authorizations.list"},"summary":"Get a list of authorizations for the given event context. Each authorization represents an app installation that the event is visible to. 🚧","description":"Get a list of authorizations for the given event context.","security":[{"bearerAuth":[]}]}},"/apps.icon.set":{"post":{"tags":["Apps Icon"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/apps.icon.set","api_endpoint":"https://slack.com/api/apps.icon.set"},"summary":"Sets the app icon","description":"Sets the app icon","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"url":{"type":"string","description":"URL of a publicly hosted image"}}},"example":{"url":""}}}}}},"/apps.managed.permissions.set":{"post":{"tags":["Apps Managed Permissions"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/apps.managed.permissions.set","api_endpoint":"https://slack.com/api/apps.managed.permissions.set"},"summary":"Set who can interact with a managed app","description":"Set who can interact with a managed app","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"permissions":{"type":"string","description":"Who can interact with the app. Use everyone to allow all members, or app\\owner to restrict access to the app's owner. Acceptable values: everyone appowner","required":true}}},"example":{"permissions":""}}}}}},"/apps.manifest.create":{"post":{"tags":["Apps Manifest"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/apps.manifest.create","api_endpoint":"https://slack.com/api/apps.manifest.create"},"summary":"Create an app from an app manifest.","description":"Create an app from an app manifest.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"manifest":{"type":"string","description":"A JSON app manifest encoded as a string. This manifest must use a valid app manifest schema - read our guide to creating one.","required":true},"team_id":{"type":"string","description":"When called with an org token, which specific team to create app on"}}},"example":{"manifest":"","team_id":""}}}}}},"/apps.manifest.delete":{"post":{"tags":["Apps Manifest"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/apps.manifest.delete","api_endpoint":"https://slack.com/api/apps.manifest.delete"},"summary":"Permanently deletes an app created through app manifests","description":"Permanently deletes an app created through app manifests","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/apps.manifest.export":{"post":{"tags":["Apps Manifest"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/apps.manifest.export","api_endpoint":"https://slack.com/api/apps.manifest.export"},"summary":"Export an app manifest from an existing app","description":"Export an app manifest from an existing app","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/apps.manifest.update":{"post":{"tags":["Apps Manifest"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/apps.manifest.update","api_endpoint":"https://slack.com/api/apps.manifest.update"},"summary":"Update an app from an app manifest","description":"Update an app from an app manifest","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"manifest":{"type":"string","description":"A JSON app manifest encoded as a string. This manifest must use a valid app manifest schema - read our guide to creating one. As this method entirely replaces any previous configuration, manifest must contain both unmodified and modified fields.","required":true}}},"example":{"manifest":""}}}}}},"/apps.manifest.validate":{"post":{"tags":["Apps Manifest"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/apps.manifest.validate","api_endpoint":"https://slack.com/api/apps.manifest.validate"},"summary":"Validate an app manifest","description":"Validate an app manifest","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"manifest":{"type":"string","description":"The manifest to be validated. Will be validated against the app manifest schema - read our guide.","required":true}}},"example":{"manifest":""}}}}}},"/apps.uninstall":{"get":{"tags":["Apps"],"parameters":[{"name":"client_id","in":"query","description":"Issued when you created your application","schema":{"type":"string","example":""}},{"name":"client_secret","in":"query","description":"Issued when you created your application","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/apps.uninstall","api_endpoint":"https://slack.com/api/apps.uninstall"},"summary":"Uninstalls your app from a workspace.","description":"Uninstalls your app from a workspace.","security":[{"bearerAuth":[]}]}},"/apps.user.connection.update":{"post":{"tags":["Apps User Connection"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/apps.user.connection.update","api_endpoint":"https://slack.com/api/apps.user.connection.update"},"summary":"Updates the connection status between a user and an app.","description":"Updates the connection status between a user and an app.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"status":{"type":"string","description":"The status that should be set for the user. Acceptable values: connected disconnected","required":true},"user_id":{"type":"string","description":"The ID of the user for the status update.","required":true}}},"example":{"status":"","user_id":""}}}}}},"/assistant.threads.setStatus":{"post":{"tags":["Assistant Threads"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/assistant.threads.setStatus","api_endpoint":"https://slack.com/api/assistant.threads.setStatus"},"summary":"Set the status for an AI assistant thread.","description":"Set the status for an AI assistant thread.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel_id":{"type":"string","description":"Channel ID containing the assistant thread.","required":true},"icon_emoji":{"type":"string","description":"Emoji to use as the icon for this message. Overrides iconurl."},"icon_url":{"type":"string","description":"Image URL to use as the icon for this message."},"loading_messages":{"type":"string","description":"The list of messages to rotate through as a loading indicator. Maximum of 10 messages."},"status":{"type":"string","description":"Status of the specified bot user, e.g., 'is thinking...'. A two minute timeout applies, which will cause the status to be removed if no message has been sent.","required":true},"thread_ts":{"type":"string","description":"Message timestamp of the thread of where to set the status.","required":true},"username":{"type":"string","description":"The bot's username to display."}}},"example":{"channel_id":"","icon_emoji":"","icon_url":"","loading_messages":"","status":"","thread_ts":"","username":""}}}}}},"/assistant.threads.setSuggestedPrompts":{"post":{"tags":["Assistant Threads"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/assistant.threads.setSuggestedPrompts","api_endpoint":"https://slack.com/api/assistant.threads.setSuggestedPrompts"},"summary":"Set suggested prompts for the given assistant thread","description":"Set suggested prompts for the given assistant thread","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"thread_ts":{"type":"string","description":"Message timestamp of the thread to set suggested prompts for. If not provided, the prompts will be set for the latest message in the channel."},"title":{"type":"string","description":"Title for the list of provided prompts. For example: Suggested Prompts, Related Questions."}}},"example":{"thread_ts":"","title":""}}}}}},"/assistant.threads.setTitle":{"post":{"tags":["Assistant Threads"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/assistant.threads.setTitle","api_endpoint":"https://slack.com/api/assistant.threads.setTitle"},"summary":"Set the title for the given assistant thread","description":"Set the title for the given assistant thread","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"thread_ts":{"type":"string","description":"Message timestamp of the thread to set suggested prompts for.","required":true},"title":{"type":"string","description":"The title to use for the thread.","required":true}}},"example":{"thread_ts":"","title":""}}}}}},"/auth.revoke":{"get":{"tags":["Auth"],"parameters":[{"name":"test","in":"query","description":"Setting this parameter to `1` triggers a _testing mode_ where the specified token will not actually be revoked","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/auth.revoke","api_endpoint":"https://slack.com/api/auth.revoke"},"summary":"Revokes a token.","description":"Revokes a token.","security":[{"bearerAuth":[]}]}},"/auth.teams.list":{"post":{"tags":["Auth Teams"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/auth.teams.list","api_endpoint":"https://slack.com/api/auth.teams.list"},"summary":"Obtain a full list of workspaces your org-wide app has been approved for.","description":"Obtain a full list of workspaces your org-wide app has been approved for.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"cursor":{"type":"string","description":"Set cursor to nextcursor returned by the previous call to list items in the next page."},"include_icon":{"type":"boolean","description":"Whether to return icon paths for each workspace. An icon path represents a URI pointing to the image signifying the workspace. Default: false","enum":[true,false]},"limit":{"type":"number","description":"The maximum number of workspaces to return. Must be a positive integer no larger than 1000. Default: 100"}}},"example":{"cursor":"","include_icon":"","limit":""}}}}}},"/auth.test":{"get":{"tags":["Auth"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/auth.test","api_endpoint":"https://slack.com/api/auth.test"},"summary":"Checks authentication & identity.","description":"Checks authentication & identity.","security":[{"bearerAuth":[]}]}},"/blocks.validate":{"post":{"tags":["Blocks"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/blocks.validate","api_endpoint":"https://slack.com/api/blocks.validate"},"summary":"Validates blocks, messages, and views Block Kit JSON payloads.","description":"Validates blocks, messages, and views Block Kit JSON payloads.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"blocks":{"type":"string","description":"A JSON-encoded array of structured blocks. Provide exactly one of blocks, view, or message."},"message":{"type":"string","description":"A JSON-encoded message payload to validate. Provide exactly one of blocks, view, or message."},"view":{"type":"string","description":"A JSON-encoded view payload to validate. Provide exactly one of blocks, view, or message."}}},"example":{"blocks":"","message":"","view":""}}}}}},"/bookmarks.add":{"post":{"tags":["Bookmarks"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/bookmarks.add","api_endpoint":"https://slack.com/api/bookmarks.add"},"summary":"Add a bookmark to a channel.","description":"Add a bookmark to a channel.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"type":{"type":"string","description":"The type of bookmark to add","required":true},"channel_id":{"type":"string","description":"Channel to add bookmark in","required":true},"emoji":{"type":"string","description":"Emoji tag to apply to the bookmark"},"entity_id":{"type":"string","description":"ID of the entity (message, file, etc.) to bookmark"},"link":{"type":"string","description":"Link to bookmark"},"title":{"type":"string","description":"Title for the bookmark","required":true}}},"example":{"type":"","channel_id":"","emoji":"","entity_id":"","link":"","title":""}}}}}},"/bookmarks.edit":{"post":{"tags":["Bookmarks"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/bookmarks.edit","api_endpoint":"https://slack.com/api/bookmarks.edit"},"summary":"Edit a bookmark.","description":"Edit a bookmark.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"bookmark_id":{"type":"string","description":"Bookmark to update","required":true},"channel_id":{"type":"string","description":"Channel containing the bookmark","required":true},"emoji":{"type":"string","description":"New emoji to apply to the bookmark"},"link":{"type":"string","description":"New link for the bookmark"},"title":{"type":"string","description":"New title for the bookmark"}}},"example":{"bookmark_id":"","channel_id":"","emoji":"","link":"","title":""}}}}}},"/bookmarks.list":{"post":{"tags":["Bookmarks"],"parameters":[{"name":"channel_id","in":"query","description":"Channel to list bookmarks in","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/bookmarks.list","api_endpoint":"https://slack.com/api/bookmarks.list"},"summary":"List bookmarks for a channel.","description":"List bookmarks for a channel.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel_id":{"type":"string","description":"Channel to list bookmarks in","required":true}}},"example":{"channel_id":""}}}}}},"/bookmarks.remove":{"post":{"tags":["Bookmarks"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/bookmarks.remove","api_endpoint":"https://slack.com/api/bookmarks.remove"},"summary":"Remove a bookmark from a channel.","description":"Remove a bookmark from a channel.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"bookmark_id":{"type":"string","description":"Bookmark to remove","required":true},"channel_id":{"type":"string","description":"Channel containing the bookmark","required":true}}},"example":{"bookmark_id":"","channel_id":""}}}}}},"/bots.info":{"get":{"tags":["Bots"],"parameters":[{"name":"bot","in":"query","description":"Bot user to get info on","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/bots.info","api_endpoint":"https://slack.com/api/bots.info"},"summary":"Gets information about a bot user.","description":"Gets information about a bot user.","security":[{"bearerAuth":[]}]}},"/calls.add":{"post":{"tags":["Calls"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/calls.add","api_endpoint":"https://slack.com/api/calls.add"},"summary":"Registers a new Call.","description":"Registers a new Call.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"created_by":{"type":"string","description":"The valid Slack user ID of the user who created this Call"},"date_start":{"type":"number","description":"Call start time in UTC UNIX timestamp format"},"desktop_app_join_url":{"type":"string","description":"When supplied available Slack clients will attempt to directly launch the 3rd-party Call with this URL"},"external_display_id":{"type":"string","description":"An optional human-readable ID supplied by the 3rd-party Call provider"},"external_unique_id":{"type":"string","description":"An ID supplied by the 3rd-party Call provider","required":true},"join_url":{"type":"string","description":"The URL required for a client to join the Call","required":true},"title":{"type":"string","description":"The name of the Call"},"users":{"type":"string","description":"The list of users to register as participants in the Call"}}},"example":{"created_by":"","date_start":"","desktop_app_join_url":"","external_display_id":"","external_unique_id":"","join_url":"","title":"","users":""}}}}}},"/calls.end":{"post":{"tags":["Calls"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/calls.end","api_endpoint":"https://slack.com/api/calls.end"},"summary":"Ends a Call.","description":"Ends a Call.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"duration":{"type":"number","description":"Call duration in seconds"},"id":{"type":"string","description":"`id` returned when registering the call using the [`calls","required":true}}},"example":{"duration":"","id":""}}}}}},"/calls.info":{"post":{"tags":["Calls"],"parameters":[{"name":"id","in":"query","description":"`id` of the Call returned by the [`calls","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/calls.info","api_endpoint":"https://slack.com/api/calls.info"},"summary":"Returns information about a Call.","description":"Returns information about a Call.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"id":{"type":"string","description":"`id` of the Call returned by the [`calls","required":true}}},"example":{"id":""}}}}}},"/calls.participants.add":{"post":{"tags":["Calls Participants"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/calls.participants.add","api_endpoint":"https://slack.com/api/calls.participants.add"},"summary":"Registers new participants added to a Call.","description":"Registers new participants added to a Call.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"id":{"type":"string","description":"`id` returned by the [`calls","required":true},"users":{"type":"string","description":"The list of users to add as participants in the Call","required":true}}},"example":{"id":"","users":""}}}}}},"/calls.participants.remove":{"post":{"tags":["Calls Participants"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/calls.participants.remove","api_endpoint":"https://slack.com/api/calls.participants.remove"},"summary":"Registers participants removed from a Call.","description":"Registers participants removed from a Call.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"id":{"type":"string","description":"`id` returned by the [`calls","required":true},"users":{"type":"string","description":"The list of users to remove as participants in the Call","required":true}}},"example":{"id":"","users":""}}}}}},"/calls.update":{"post":{"tags":["Calls"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/calls.update","api_endpoint":"https://slack.com/api/calls.update"},"summary":"Updates information about a Call.","description":"Updates information about a Call.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"desktop_app_join_url":{"type":"string","description":"When supplied available Slack clients will attempt to directly launch the 3rd-party Call with this URL"},"id":{"type":"string","description":"`id` returned by the [`calls","required":true},"join_url":{"type":"string","description":"The URL required for a client to join the Call"},"title":{"type":"string","description":"The name of the Call"}}},"example":{"desktop_app_join_url":"","id":"","join_url":"","title":""}}}}}},"/canvases.access.delete":{"post":{"tags":["Canvases Access"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/canvases.access.delete","api_endpoint":"https://slack.com/api/canvases.access.delete"},"summary":"Remove access to a canvas for specified entities","description":"Remove access to a canvas for specified entities","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel_ids":{"type":"string","description":"List of channels you wish to update access for"},"user_ids":{"type":"string","description":"List of users you wish to update access for"}}},"example":{"channel_ids":"","user_ids":""}}}}}},"/canvases.access.set":{"post":{"tags":["Canvases Access"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/canvases.access.set","api_endpoint":"https://slack.com/api/canvases.access.set"},"summary":"Sets the access level to a canvas for specified entities","description":"Sets the access level to a canvas for specified entities","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel_ids":{"type":"string","description":"List of channels you wish to update access for. Can only be used if user\\ids is not provided."},"user_ids":{"type":"string","description":"List of users you wish to update access for. Can only be used if channel\\ids is not provided."}}},"example":{"channel_ids":"","user_ids":""}}}}}},"/canvases.create":{"post":{"tags":["Canvases"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/canvases.create","api_endpoint":"https://slack.com/api/canvases.create"},"summary":"Create canvas for a user","description":"Create canvas for a user","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel_id":{"type":"string","description":"Channel ID of the channel the canvas will be tabbed in. This is a required field for free teams."},"title":{"type":"string","description":"Title of the newly created canvas"}}},"example":{"channel_id":"","title":""}}}}}},"/canvases.delete":{"post":{"tags":["Canvases"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/canvases.delete","api_endpoint":"https://slack.com/api/canvases.delete"},"summary":"Deletes a canvas","description":"Deletes a canvas","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/canvases.edit":{"post":{"tags":["Canvases"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/canvases.edit","api_endpoint":"https://slack.com/api/canvases.edit"},"summary":"Update an existing canvas","description":"Update an existing canvas","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"changes":{"type":"string","description":"List of changes to apply on the specified canvas. The markdown content of each change is limited to 1 MiB (1,048,576 characters).","required":true}}},"example":{"changes":""}}}}}},"/canvases.sections.lookup":{"post":{"tags":["Canvases Sections"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/canvases.sections.lookup","api_endpoint":"https://slack.com/api/canvases.sections.lookup"},"summary":"Find sections matching the provided criteria","description":"Find sections matching the provided criteria","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/chat.appendStream":{"post":{"tags":["Chat"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/chat.appendStream","api_endpoint":"https://slack.com/api/chat.appendStream"},"summary":"Append text to an existing streaming conversation","description":"Append text to an existing streaming conversation","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel":{"type":"string","description":"An encoded ID that represents a channel, private group, or DM","required":true},"chunks":{"type":"string","description":"Array of streaming chunks."},"markdown_text":{"type":"string","description":"Accepts message text formatted in markdown. Limit this field to 12,000 characters. This text is what will be appended to the message received so far."}}},"example":{"channel":"","chunks":"","markdown_text":""}}}}}},"/chat.delete":{"post":{"tags":["Chat"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/chat.delete","api_endpoint":"https://slack.com/api/chat.delete"},"summary":"Deletes a message.","description":"Deletes a message.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"as_user":{"type":"boolean","description":"Pass true to delete the message as the authed user with `chat","enum":["write"]},"channel":{"type":"string","description":"Channel containing the message to be deleted"},"ts":{"type":"number","description":"Timestamp of the message to be deleted"}}},"example":{"as_user":"","channel":"","ts":""}}}}}},"/chat.deleteScheduledMessage":{"post":{"tags":["Chat"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/chat.deleteScheduledMessage","api_endpoint":"https://slack.com/api/chat.deleteScheduledMessage"},"summary":"Deletes a pending scheduled message from the queue.","description":"Deletes a pending scheduled message from the queue.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"as_user":{"type":"boolean","description":"Pass true to delete the message as the authed user with `chat","enum":["write"]},"channel":{"type":"string","description":"The channel the scheduled_message is posting to","required":true},"scheduled_message_id":{"type":"string","description":"`scheduled_message_id` returned from call to chat","required":true}}},"example":{"as_user":"","channel":"","scheduled_message_id":""}}}}}},"/chat.getPermalink":{"get":{"tags":["Chat"],"parameters":[{"name":"channel","in":"query","description":"The ID of the conversation or channel containing the message","required":true,"schema":{"type":"string","example":""}},{"name":"message_ts","in":"query","description":"A message's `ts` value uniquely identifying it within a channel","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/chat.getPermalink","api_endpoint":"https://slack.com/api/chat.getPermalink"},"summary":"Retrieve a permalink URL for a specific extant message","description":"Retrieve a permalink URL for a specific extant message.","security":[{"bearerAuth":[]}]}},"/chat.meMessage":{"post":{"tags":["Chat"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/chat.meMessage","api_endpoint":"https://slack.com/api/chat.meMessage"},"summary":"Share a me message into a channel.","description":"Share a me message into a channel.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"text":{"type":"string","description":"Text of the message to send"},"channel":{"type":"string","description":"Channel to send message to"}}},"example":{"text":"","channel":""}}}}}},"/chat.postEphemeral":{"post":{"tags":["Chat"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/chat.postEphemeral","api_endpoint":"https://slack.com/api/chat.postEphemeral"},"summary":"Sends an ephemeral message to a user in a channel.","description":"Sends an ephemeral message to a user in a channel.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"text":{"type":"string","description":"How this field works and whether it is required depends on other fields you use in your API call"},"as_user":{"type":"boolean","description":"Pass true to post the message as the authed user","enum":[true,false]},"attachments":{"type":"string","description":"A JSON-based array of structured attachments presented as a URL-encoded string"},"blocks":{"type":"string","description":"A JSON-based array of structured blocks presented as a URL-encoded string"},"channel":{"type":"string","description":"Channel private group or IM channel to send message to","required":true},"icon_emoji":{"type":"string","description":"Emoji to use as the icon for this message"},"icon_url":{"type":"string","description":"URL to an image to use as the icon for this message"},"link_names":{"type":"boolean","description":"Find and link channel names and usernames","enum":[true,false]},"parse":{"type":"string","description":"Change how messages are treated"},"thread_ts":{"type":"string","description":"Provide another message's `ts` value to post this message in a thread"},"user":{"type":"string","description":"`id` of the user who will receive the ephemeral message","required":true},"username":{"type":"string","description":"Set your bot's user name"}}},"example":{"text":"","as_user":"","attachments":"","blocks":"","channel":"","icon_emoji":"","icon_url":"","link_names":"","parse":"","thread_ts":"","user":"","username":""}}}}}},"/chat.postMessage":{"post":{"tags":["Chat"],"parameters":[{"name":"channel","in":"query","description":"Channel to send the message to (ID or name)","required":"true","schema":{"type":"string","example":""}},{"name":"text","in":"query","description":"Message text","required":"true","schema":{"type":"string","example":""}},{"name":"thread_ts","in":"query","description":"Timestamp of the parent message to reply in a thread","schema":{"type":"string","example":""}},{"name":"reply_broadcast","in":"query","description":"Used in thread replies: also broadcast to the channel","schema":{"type":"boolean","example":""}},{"name":"unfurl_links","in":"query","description":"Pass true to enable unfurling of primarily text content","schema":{"type":"boolean","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/chat.postMessage","api_endpoint":"https://slack.com/api/chat.postMessage"},"summary":"Sends a message to a channel.","description":"Sends a message to a channel.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"text":{"type":"string","description":"How this field works and whether it is required depends on other fields you use in your API call"},"as_user":{"type":"string","description":"Pass true to post the message as the authed user instead of as a bot"},"attachments":{"type":"string","description":"A JSON-based array of structured attachments presented as a URL-encoded string"},"blocks":{"type":"string","description":"A JSON-based array of structured blocks presented as a URL-encoded string"},"channel":{"type":"string","description":"Channel private group or IM channel to send message to","required":true},"icon_emoji":{"type":"string","description":"Emoji to use as the icon for this message"},"icon_url":{"type":"string","description":"URL to an image to use as the icon for this message"},"link_names":{"type":"boolean","description":"Find and link channel names and usernames","enum":[true,false]},"mrkdwn":{"type":"boolean","description":"Disable Slack markup parsing by setting to `false`","enum":[true,false]},"parse":{"type":"string","description":"Change how messages are treated"},"reply_broadcast":{"type":"boolean","description":"Used in conjunction with `thread_ts` and indicates whether reply should be made visible to everyone in the channel or conversation","enum":[true,false]},"thread_ts":{"type":"string","description":"Provide another message's `ts` value to make this message a reply"},"unfurl_links":{"type":"boolean","description":"Pass true to enable unfurling of primarily text-based content","enum":[true,false]},"unfurl_media":{"type":"boolean","description":"Pass false to disable unfurling of media content","enum":[true,false]},"username":{"type":"string","description":"Set your bot's user name"}}},"example":{"text":"","as_user":"","attachments":"","blocks":"","channel":"","icon_emoji":"","icon_url":"","link_names":"","mrkdwn":"","parse":"","reply_broadcast":"","thread_ts":"","unfurl_links":"","unfurl_media":"","username":""}}}}}},"/chat.scheduleMessage":{"post":{"tags":["Chat"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/chat.scheduleMessage","api_endpoint":"https://slack.com/api/chat.scheduleMessage"},"summary":"Schedules a message to be sent to a channel.","description":"Schedules a message to be sent to a channel.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"text":{"type":"string","description":"How this field works and whether it is required depends on other fields you use in your API call"},"as_user":{"type":"boolean","description":"Pass true to post the message as the authed user instead of as a bot","enum":[true,false]},"attachments":{"type":"string","description":"A JSON-based array of structured attachments presented as a URL-encoded string"},"blocks":{"type":"string","description":"A JSON-based array of structured blocks presented as a URL-encoded string"},"channel":{"type":"string","description":"Channel private group or DM channel to send message to"},"link_names":{"type":"boolean","description":"Find and link channel names and usernames","enum":[true,false]},"parse":{"type":"string","description":"Change how messages are treated"},"post_at":{"type":"string","description":"Unix EPOCH timestamp of time in future to send the message"},"reply_broadcast":{"type":"boolean","description":"Used in conjunction with `thread_ts` and indicates whether reply should be made visible to everyone in the channel or conversation","enum":[true,false]},"thread_ts":{"type":"number","description":"Provide another message's `ts` value to make this message a reply"},"unfurl_links":{"type":"boolean","description":"Pass true to enable unfurling of primarily text-based content","enum":[true,false]},"unfurl_media":{"type":"boolean","description":"Pass false to disable unfurling of media content","enum":[true,false]}}},"example":{"text":"","as_user":"","attachments":"","blocks":"","channel":"","link_names":"","parse":"","post_at":"","reply_broadcast":"","thread_ts":"","unfurl_links":"","unfurl_media":""}}}}}},"/chat.scheduledMessages.list":{"get":{"tags":["Chat ScheduledMessages"],"parameters":[{"name":"channel","in":"query","description":"The channel of the scheduled messages","schema":{"type":"string","example":""}},{"name":"cursor","in":"query","description":"For pagination purposes this is the `cursor` value returned from a previous call to `chat","schema":{"type":"string","example":""}},{"name":"latest","in":"query","description":"A UNIX timestamp of the latest value in the time range","schema":{"type":"number","example":""}},{"name":"limit","in":"query","description":"Maximum number of original entries to return","schema":{"type":"number","example":""}},{"name":"oldest","in":"query","description":"A UNIX timestamp of the oldest value in the time range","schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/chat.scheduledMessages.list","api_endpoint":"https://slack.com/api/chat.scheduledMessages.list"},"summary":"Returns a list of scheduled messages.","description":"Returns a list of scheduled messages.","security":[{"bearerAuth":[]}]}},"/chat.startStream":{"post":{"tags":["Chat"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/chat.startStream","api_endpoint":"https://slack.com/api/chat.startStream"},"summary":"Start a new streaming conversation","description":"Start a new streaming conversation","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel":{"type":"string","description":"An encoded ID that represents a channel, thread, or DM.","required":true},"chunks":{"type":"string","description":"Array of streaming chunks. Can include markdown text chunk objects, task update chunk objects, plan update chunks, or blocks chunks."},"icon_emoji":{"type":"string","description":"Emoji to use as the icon for this message. Overrides iconurl."},"icon_url":{"type":"string","description":"Image URL to use as the icon for this message."},"markdown_text":{"type":"string","description":"Accepts message text formatted in markdown. Limit this field to 12,000 characters."},"recipient_team_id":{"type":"string","description":"The encoded ID of the team the user receiving the streaming text belongs to. Required when streaming to channels."},"task_display_mode":{"type":"string","description":"Specifies how tasks are displayed in the message. timeline task updates render as individual task cards interleaved with streamed text. plan task updates render together in a plan block. Default: timeline Acceptable values: timeline plan"},"thread_ts":{"type":"string","description":"Provide another message's ts value to reply to. Omit it to stream a top-level message instead of a thread reply; this is only supported in channels where the whole channel is one session, such as Slack Code, and returns invalidthreadts elsewhere. Passing \"0\" is equivalent to omitting it."},"username":{"type":"string","description":"The bot's username to display."}}},"example":{"channel":"","chunks":"","icon_emoji":"","icon_url":"","markdown_text":"","recipient_team_id":"","task_display_mode":"","thread_ts":"","username":""}}}}}},"/chat.stopStream":{"post":{"tags":["Chat"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/chat.stopStream","api_endpoint":"https://slack.com/api/chat.stopStream"},"summary":"Stop a streaming conversation","description":"Stop a streaming conversation","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel":{"type":"string","description":"An encoded ID that represents a channel, private group, or DM","required":true},"chunks":{"type":"string","description":"Array of streaming chunks. Can include markdown text chunk objects, task update chunk objects, plan update chunks, or blocks chunks."},"markdown_text":{"type":"string","description":"Accepts message text formatted in markdown. Limit this field to 12,000 characters."},"session_status":{"type":"string","description":"The session status to set after stopping the stream. Default: active Acceptable values: active processing suspended closed"}}},"example":{"channel":"","chunks":"","markdown_text":"","session_status":""}}}}}},"/chat.unfurl":{"post":{"tags":["Chat"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/chat.unfurl","api_endpoint":"https://slack.com/api/chat.unfurl"},"summary":"Provide custom unfurl behavior for user-posted URLs","description":"Provide custom unfurl behavior for user-posted URLs.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel":{"type":"string","description":"Channel ID of the message","required":true},"ts":{"type":"string","description":"Timestamp of the message to add unfurl behavior to","required":true},"unfurls":{"type":"string","description":"URL-encoded JSON map with keys set to URLs featured in the the message pointing to their unfurl blocks or message attachments"},"user_auth_message":{"type":"string","description":"Provide a simply-formatted string to send as an ephemeral message to the user as invitation to authenticate further and enable full unfurling behavior"},"user_auth_required":{"type":"boolean","description":"Set to `true` or `1` to indicate the user must install your Slack app to trigger unfurls for this domain","enum":[true,false]},"user_auth_url":{"type":"string","description":"Send users to this custom URL where they will complete authentication in your app to fully trigger unfurling"}}},"example":{"channel":"","ts":"","unfurls":"","user_auth_message":"","user_auth_required":"","user_auth_url":""}}}}}},"/chat.update":{"post":{"tags":["Chat"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/chat.update","api_endpoint":"https://slack.com/api/chat.update"},"summary":"Updates a message.","description":"Updates a message.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"text":{"type":"string","description":"New text for the message using the [default formatting rules](/reference/surfaces/formatting)"},"as_user":{"type":"string","description":"Pass true to update the message as the authed user"},"attachments":{"type":"string","description":"A JSON-based array of structured attachments presented as a URL-encoded string"},"blocks":{"type":"string","description":"A JSON-based array of [structured blocks](/block-kit/building) presented as a URL-encoded string"},"channel":{"type":"string","description":"Channel containing the message to be updated","required":true},"link_names":{"type":"string","description":"Find and link channel names and usernames"},"parse":{"type":"string","description":"Change how messages are treated"},"ts":{"type":"string","description":"Timestamp of the message to be updated","required":true}}},"example":{"text":"","as_user":"","attachments":"","blocks":"","channel":"","link_names":"","parse":"","ts":""}}}}}},"/conversations.acceptSharedInvite":{"post":{"tags":["Conversations"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/conversations.acceptSharedInvite","api_endpoint":"https://slack.com/api/conversations.acceptSharedInvite"},"summary":"Accepts an invitation to a Slack Connect channel.","description":"Accepts an invitation to a Slack Connect channel.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel_name":{"type":"string","description":"Name of the channel. If the channel does not exist already in your workspace, this name is the one that the channel will take.","required":true},"free_trial_accepted":{"type":"boolean","description":"Whether you'd like to use your workspace's free trial to begin using Slack Connect.","enum":[true,false]},"is_private":{"type":"boolean","description":"Whether the channel should be private.","enum":[true,false]}}},"example":{"channel_name":"","free_trial_accepted":"","is_private":""}}}}}},"/conversations.approveSharedInvite":{"post":{"tags":["Conversations"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/conversations.approveSharedInvite","api_endpoint":"https://slack.com/api/conversations.approveSharedInvite"},"summary":"Approves an invitation to a Slack Connect channel","description":"Approves an invitation to a Slack Connect channel","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/conversations.archive":{"post":{"tags":["Conversations"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/conversations.archive","api_endpoint":"https://slack.com/api/conversations.archive"},"summary":"Archives a conversation.","description":"Archives a conversation.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel":{"type":"string","description":"ID of conversation to archive"}}},"example":{"channel":""}}}}}},"/conversations.canvases.create":{"post":{"tags":["Conversations Canvases"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/conversations.canvases.create","api_endpoint":"https://slack.com/api/conversations.canvases.create"},"summary":"Create a channel canvas for a channel","description":"Create a channel canvas for a channel","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel_id":{"type":"string","description":"Channel ID of the channel the canvas will be tabbed in.","required":true},"title":{"type":"string","description":"Title of the newly created canvas"}}},"example":{"channel_id":"","title":""}}}}}},"/conversations.close":{"post":{"tags":["Conversations"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/conversations.close","api_endpoint":"https://slack.com/api/conversations.close"},"summary":"Closes a direct message or multi-person direct message.","description":"Closes a direct message or multi-person direct message.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel":{"type":"string","description":"Conversation to close"}}},"example":{"channel":""}}}}}},"/conversations.create":{"post":{"tags":["Conversations"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/conversations.create","api_endpoint":"https://slack.com/api/conversations.create"},"summary":"Initiates a public or private channel-based conversation","description":"Initiates a public or private channel-based conversation.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"is_private":{"type":"boolean","description":"Create a private channel instead of a public one","enum":[true,false]},"name":{"type":"string","description":"Name of the public or private channel to create"}}},"example":{"is_private":"","name":""}}}}}},"/conversations.declineSharedInvite":{"get":{"tags":["Conversations"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/conversations.declineSharedInvite","api_endpoint":"https://slack.com/api/conversations.declineSharedInvite"},"summary":"Declines a Slack Connect channel invite.","description":"Declines a Slack Connect channel invite.","security":[{"bearerAuth":[]}]}},"/conversations.externalInvitePermissions.set":{"post":{"tags":["Conversations ExternalInvitePermissions"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/conversations.externalInvitePermissions.set","api_endpoint":"https://slack.com/api/conversations.externalInvitePermissions.set"},"summary":"Upgrade or downgrade Slack Connect channel permissions between 'can post only' and 'can post and invite'.","description":"Upgrade or downgrade Slack Connect channel permissions between 'can post only' and 'can post and invite'.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"action":{"type":"string","description":"Type of action to be taken: upgrade or downgrade Acceptable values: upgrade downgrade","required":true}}},"example":{"action":""}}}}}},"/conversations.history":{"get":{"tags":["Conversations"],"parameters":[{"name":"channel","in":"query","description":"Conversation ID to fetch history for","schema":{"type":"string","example":""}},{"name":"cursor","in":"query","description":"Paginate through collections of data by setting the `cursor` parameter to a `next_cursor` attribute returned by a previous request's `response_metadata`","schema":{"type":"string","example":""}},{"name":"inclusive","in":"query","description":"Include messages with latest or oldest timestamp in results only when either timestamp is specified","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"latest","in":"query","description":"End of time range of messages to include in results","schema":{"type":"number","example":""}},{"name":"limit","in":"query","description":"The maximum number of items to return","schema":{"type":"number","example":""}},{"name":"oldest","in":"query","description":"Start of time range of messages to include in results","schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/conversations.history","api_endpoint":"https://slack.com/api/conversations.history"},"summary":"Fetches a conversation's history of messages and events.","description":"Fetches a conversation's history of messages and events.","security":[{"bearerAuth":[]}]}},"/conversations.info":{"get":{"tags":["Conversations"],"parameters":[{"name":"channel","in":"query","description":"Conversation ID to learn more about","schema":{"type":"string","example":""}},{"name":"include_locale","in":"query","description":"Set this to `true` to receive the locale for this conversation","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"include_num_members","in":"query","description":"Set to `true` to include the member count for the specified conversation","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/conversations.info","api_endpoint":"https://slack.com/api/conversations.info"},"summary":"Retrieve information about a conversation.","description":"Retrieve information about a conversation.","security":[{"bearerAuth":[]}]}},"/conversations.invite":{"post":{"tags":["Conversations"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/conversations.invite","api_endpoint":"https://slack.com/api/conversations.invite"},"summary":"Invites users to a channel.","description":"Invites users to a channel.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel":{"type":"string","description":"The ID of the public or private channel to invite user(s) to"},"users":{"type":"string","description":"A comma separated list of user IDs"}}},"example":{"channel":"","users":""}}}}}},"/conversations.inviteShared":{"post":{"tags":["Conversations"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/conversations.inviteShared","api_endpoint":"https://slack.com/api/conversations.inviteShared"},"summary":"Invite a user to a shared channel.","description":"Invite a user to a shared channel.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel":{"type":"string","description":"Channel to invite user to","required":true},"emails":{"type":"string","description":"Comma-separated list of email addresses"},"user_ids":{"type":"string","description":"Comma-separated list of user IDs"}}},"example":{"channel":"","emails":"","user_ids":""}}}}}},"/conversations.join":{"post":{"tags":["Conversations"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/conversations.join","api_endpoint":"https://slack.com/api/conversations.join"},"summary":"Joins an existing conversation.","description":"Joins an existing conversation.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel":{"type":"string","description":"ID of conversation to join"}}},"example":{"channel":""}}}}}},"/conversations.kick":{"post":{"tags":["Conversations"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/conversations.kick","api_endpoint":"https://slack.com/api/conversations.kick"},"summary":"Removes a user from a conversation.","description":"Removes a user from a conversation.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel":{"type":"string","description":"ID of conversation to remove user from"},"user":{"type":"string","description":"User ID to be removed"}}},"example":{"channel":"","user":""}}}}}},"/conversations.leave":{"post":{"tags":["Conversations"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/conversations.leave","api_endpoint":"https://slack.com/api/conversations.leave"},"summary":"Leaves a conversation.","description":"Leaves a conversation.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel":{"type":"string","description":"Conversation to leave"}}},"example":{"channel":""}}}}}},"/conversations.list":{"get":{"tags":["Conversations"],"parameters":[{"name":"cursor","in":"query","description":"Paginate through collections of data by setting the `cursor` parameter to a `next_cursor` attribute returned by a previous request's `response_metadata`","schema":{"type":"string","example":""}},{"name":"exclude_archived","in":"query","description":"Set to `true` to exclude archived channels from the list","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"limit","in":"query","description":"The maximum number of items to return","schema":{"type":"number","example":""}},{"name":"types","in":"query","description":"Mix and match channel types by providing a comma-separated list of any combination of `public_channel` `private_channel` `mpim` `im`","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/conversations.list","api_endpoint":"https://slack.com/api/conversations.list"},"summary":"Lists all channels in a Slack team.","description":"Lists all channels in a Slack team.","security":[{"bearerAuth":[]}]}},"/conversations.listConnectInvites":{"post":{"tags":["Conversations"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/conversations.listConnectInvites","api_endpoint":"https://slack.com/api/conversations.listConnectInvites"},"summary":"Lists shared channel invites that have been generated or received but have not been approved by all parties","description":"Lists shared channel invites that have been generated or received but have not been approved by all parties","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"count":{"type":"number","description":"Maximum number of invites to return Default: 100"},"cursor":{"type":"string","description":"Set to nextcursor returned by previous call to list items in subsequent page"},"team_id":{"type":"string","description":"Encoded team id for the workspace to retrieve invites for, required if org token is used"}}},"example":{"count":"","cursor":"","team_id":""}}}}}},"/conversations.mark":{"post":{"tags":["Conversations"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/conversations.mark","api_endpoint":"https://slack.com/api/conversations.mark"},"summary":"Sets the read cursor in a channel.","description":"Sets the read cursor in a channel.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel":{"type":"string","description":"Channel or conversation to set the read cursor for"},"ts":{"type":"number","description":"Unique identifier of message you want marked as most recently seen in this conversation"}}},"example":{"channel":"","ts":""}}}}}},"/conversations.members":{"get":{"tags":["Conversations"],"parameters":[{"name":"channel","in":"query","description":"ID of the conversation to retrieve members for","schema":{"type":"string","example":""}},{"name":"cursor","in":"query","description":"Paginate through collections of data by setting the `cursor` parameter to a `next_cursor` attribute returned by a previous request's `response_metadata`","schema":{"type":"string","example":""}},{"name":"limit","in":"query","description":"The maximum number of items to return","schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/conversations.members","api_endpoint":"https://slack.com/api/conversations.members"},"summary":"Retrieve members of a conversation.","description":"Retrieve members of a conversation.","security":[{"bearerAuth":[]}]}},"/conversations.open":{"post":{"tags":["Conversations"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/conversations.open","api_endpoint":"https://slack.com/api/conversations.open"},"summary":"Opens or resumes a direct message or multi-person direct message.","description":"Opens or resumes a direct message or multi-person direct message.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel":{"type":"string","description":"Resume a conversation by supplying an `im` or `mpim`'s ID"},"return_im":{"type":"boolean","description":"Boolean indicates you want the full IM channel definition in the response","enum":[true,false]},"users":{"type":"string","description":"Comma separated lists of users"}}},"example":{"channel":"","return_im":"","users":""}}}}}},"/conversations.rename":{"post":{"tags":["Conversations"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/conversations.rename","api_endpoint":"https://slack.com/api/conversations.rename"},"summary":"Renames a conversation.","description":"Renames a conversation.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel":{"type":"string","description":"ID of conversation to rename"},"name":{"type":"string","description":"New name for conversation"}}},"example":{"channel":"","name":""}}}}}},"/conversations.replies":{"get":{"tags":["Conversations"],"parameters":[{"name":"channel","in":"query","description":"Conversation ID to fetch thread from","schema":{"type":"string","example":""}},{"name":"cursor","in":"query","description":"Paginate through collections of data by setting the `cursor` parameter to a `next_cursor` attribute returned by a previous request's `response_metadata`","schema":{"type":"string","example":""}},{"name":"inclusive","in":"query","description":"Include messages with latest or oldest timestamp in results only when either timestamp is specified","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"latest","in":"query","description":"End of time range of messages to include in results","schema":{"type":"number","example":""}},{"name":"limit","in":"query","description":"The maximum number of items to return","schema":{"type":"number","example":""}},{"name":"oldest","in":"query","description":"Start of time range of messages to include in results","schema":{"type":"number","example":""}},{"name":"ts","in":"query","description":"Unique identifier of a thread's parent message","schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/conversations.replies","api_endpoint":"https://slack.com/api/conversations.replies"},"summary":"Retrieve a thread of messages posted to a conversation","description":"Retrieve a thread of messages posted to a conversation.","security":[{"bearerAuth":[]}]}},"/conversations.requestSharedInvite.approve":{"post":{"tags":["Conversations RequestSharedInvite"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/conversations.requestSharedInvite.approve","api_endpoint":"https://slack.com/api/conversations.requestSharedInvite.approve"},"summary":"Approves a request to add an external user to a channel and sends them a Slack Connect invite","description":"Approves a request to add an external user to a channel and sends them a Slack Connect invite","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel_id":{"type":"string","description":"Optional channel\\id to which external user will be invited to. Will override the value on the requested invite."},"is_external_limited":{"type":"boolean","description":"Optional boolean on whether the invited team will have post-only permissions in the channel. Will override the value on the requested invite.","enum":[true,false]},"message":{"type":"string","description":"Object describing the text to send along with the invite. If this object is specified, both text and isoverride are required properties. If isoverride is set to true, text will override the original invitation message. Otherwise, text will be appended to the original invitation message. The total length of the message cannot exceed 560 characters. If isoverride is set to false, the length of text and the user specified message on the invite request in total must be less than 560 characters."}}},"example":{"channel_id":"","is_external_limited":"","message":""}}}}}},"/conversations.requestSharedInvite.deny":{"post":{"tags":["Conversations RequestSharedInvite"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/conversations.requestSharedInvite.deny","api_endpoint":"https://slack.com/api/conversations.requestSharedInvite.deny"},"summary":"Denies a request to invite an external user to a channel","description":"Denies a request to invite an external user to a channel","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"message":{"type":"string","description":"Optional message explaining why the request to invite was denied."}}},"example":{"message":""}}}}}},"/conversations.requestSharedInvite.list":{"post":{"tags":["Conversations RequestSharedInvite"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/conversations.requestSharedInvite.list","api_endpoint":"https://slack.com/api/conversations.requestSharedInvite.list"},"summary":"Lists requests to add external users to channels with ability to filter.","description":"Lists requests to add external users to channels with ability to filter.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"cursor":{"type":"string","description":"Paginate through collections of data by setting the cursor parameter to a nextcursor attribute returned by a previous request's responsemetadata. See pagination for more detail."},"include_approved":{"type":"boolean","description":"When true approved invitation requests will be returned, otherwise they will be excluded","enum":[true,false]},"include_denied":{"type":"boolean","description":"When true denied invitation requests will be returned, otherwise they will be excluded","enum":[true,false]},"include_expired":{"type":"boolean","description":"When true expired invitation requests will be returned, otherwise they will be excluded","enum":[true,false]},"invite_ids":{"type":"string","description":"An optional list of invitation ids to look up"},"limit":{"type":"number","description":"The number of items to return. Must be between 1 - 1000 (inclusive). Default: 200"}}},"example":{"cursor":"","include_approved":"","include_denied":"","include_expired":"","invite_ids":"","limit":""}}}}}},"/conversations.setPurpose":{"post":{"tags":["Conversations"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/conversations.setPurpose","api_endpoint":"https://slack.com/api/conversations.setPurpose"},"summary":"Sets the purpose for a conversation.","description":"Sets the purpose for a conversation.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel":{"type":"string","description":"Conversation to set the purpose of"},"purpose":{"type":"string","description":"A new specialer purpose"}}},"example":{"channel":"","purpose":""}}}}}},"/conversations.setTopic":{"post":{"tags":["Conversations"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/conversations.setTopic","api_endpoint":"https://slack.com/api/conversations.setTopic"},"summary":"Sets the topic for a conversation.","description":"Sets the topic for a conversation.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel":{"type":"string","description":"Conversation to set the topic of"},"topic":{"type":"string","description":"The new topic string"}}},"example":{"channel":"","topic":""}}}}}},"/conversations.unarchive":{"post":{"tags":["Conversations"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/conversations.unarchive","api_endpoint":"https://slack.com/api/conversations.unarchive"},"summary":"Reverses conversation archival.","description":"Reverses conversation archival.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel":{"type":"string","description":"ID of conversation to unarchive"}}},"example":{"channel":""}}}}}},"/dialog.open":{"get":{"tags":["Dialog"],"parameters":[{"name":"dialog","in":"query","description":"The dialog definition","required":true,"schema":{"type":"string","example":""}},{"name":"trigger_id","in":"query","description":"Exchange a trigger to post to the user","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/dialog.open","api_endpoint":"https://slack.com/api/dialog.open"},"summary":"Open a dialog with a user","description":"Open a dialog with a user.","security":[{"bearerAuth":[]}]}},"/dnd.info":{"get":{"tags":["Dnd"],"parameters":[{"name":"user","in":"query","description":"User to fetch status for (defaults to current user)","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/dnd.info","api_endpoint":"https://slack.com/api/dnd.info"},"summary":"Retrieves a user's current Do Not Disturb status.","description":"Retrieves a user's current Do Not Disturb status.","security":[{"bearerAuth":[]}]}},"/dnd.teamInfo":{"get":{"tags":["Dnd"],"parameters":[{"name":"users","in":"query","description":"Comma-separated list of users to fetch Do Not Disturb status for","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/dnd.teamInfo","api_endpoint":"https://slack.com/api/dnd.teamInfo"},"summary":"Retrieves the Do Not Disturb status for up to 50 users on a team.","description":"Retrieves the Do Not Disturb status for up to 50 users on a team.","security":[{"bearerAuth":[]}]}},"/emoji.list":{"get":{"tags":["Emoji"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/emoji.list","api_endpoint":"https://slack.com/api/emoji.list"},"summary":"Lists custom emoji for a team.","description":"Lists custom emoji for a team.","security":[{"bearerAuth":[]}]}},"/entity.acknowledgeCommentAction":{"post":{"tags":["Entity"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/entity.acknowledgeCommentAction","api_endpoint":"https://slack.com/api/entity.acknowledgeCommentAction"},"summary":"Acknowledge a comment post, edit, or delete on a Work Object. Apps call this method to confirm they have processed a comment action.","description":"Acknowledge a comment post, edit, or delete on a Work Object. Apps call this method to confirm they have processed a comment action.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"comment":{"type":"string","description":"The full comment data. Required for edit and post actions. See the comment schema for the full list of properties."},"error":{"type":"string","description":"Error message if the action failed in the app. When present, signals that the mutation could not be completed."},"trigger_id":{"type":"string","description":"A reference to the original user action that initiated the comment mutation","required":true}}},"example":{"comment":"","error":"","trigger_id":""}}}}}},"/entity.presentComments":{"post":{"tags":["Entity"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/entity.presentComments","api_endpoint":"https://slack.com/api/entity.presentComments"},"summary":"Provide comments for Work Objects. Apps call this method to send per-user flexpane comment data to the client.","description":"Provide comments for Work Objects. Apps call this method to send per-user flexpane comment data to the client.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"can_post_comment":{"type":"boolean","description":"Indicates whether the user has permissions to post comments","enum":[true,false]},"comments":{"type":"string","description":"Array of comments to present to the user. See the comment schema for the full list of properties.","required":true},"cursor":{"type":"string","description":"App supplied cursor used for pagination, will be sent in the next request for comments"},"delete_action_id":{"type":"string","description":"The block action id that will be sent when a delete request is initiated for a comment."},"trigger_id":{"type":"string","description":"A reference to the original user action that initiated the request","required":true},"user_auth_required":{"type":"boolean","description":"Set to true (or 1) to indicate that the user must authenticate to see the comments data. Default: 0","enum":[true,false]},"user_auth_url":{"type":"string","description":"A custom URL to which users are directed for authentication if required."}}},"example":{"can_post_comment":"","comments":"","cursor":"","delete_action_id":"","trigger_id":"","user_auth_required":"","user_auth_url":""}}}}}},"/entity.presentDetails":{"post":{"tags":["Entity"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/entity.presentDetails","api_endpoint":"https://slack.com/api/entity.presentDetails"},"summary":"Provide custom flexpane behavior for Work Objects. Apps call this method to send per-user flexpane metadata to the client.","description":"Provide custom flexpane behavior for Work Objects. Apps call this method to send per-user flexpane metadata to the client.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"metadata":{"type":"string","description":"URL-encoded JSON object containing flexpane metadata from the app that will be conformed to a Work Object metadata schema, keyed by entity ID."},"trigger_id":{"type":"string","description":"A reference to the original user action that initiated the request.","required":true},"user_auth_required":{"type":"boolean","description":"Set to true (or 1) to indicate that the user must authenticate to view full flexpane data. Default: 0","enum":[true,false]},"user_auth_url":{"type":"string","description":"A custom URL to which users are directed for authentication if required."}}},"example":{"metadata":"","trigger_id":"","user_auth_required":"","user_auth_url":""}}}}}},"/files.comments.delete":{"post":{"tags":["Files Comments"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/files.comments.delete","api_endpoint":"https://slack.com/api/files.comments.delete"},"summary":"Deletes an existing comment on a file.","description":"Deletes an existing comment on a file.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"file":{"type":"string","description":"File to delete a comment from"},"id":{"type":"string","description":"The comment to delete"}}},"example":{"file":"","id":""}}}}}},"/files.completeUploadExternal":{"post":{"tags":["Files"],"parameters":[{"name":"files","in":"query","description":"Array of file ids and their (optional) titles: [{\"id\": \"F...\", \"title\": \"...\"}]","required":"true","schema":{"type":"array","example":""}},{"name":"initial_comment","in":"query","description":"Comment to add to the file","schema":{"type":"string","example":""}},{"name":"channels","in":"query","description":"Comma-separated channel IDs to share the file in (e.g. C0123ABC,C0456DEF)","required":"false","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/files.completeUploadExternal","api_endpoint":"https://slack.com/api/files.completeUploadExternal"},"summary":"Finishes an upload started with files.getUploadURLExternal","description":"Finishes an upload started with files.getUploadURLExternal","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"blocks":{"type":"string","description":"A JSON-based array of structured rich text blocks, presented as a URL-encoded string. If the initialcomment field is provided, the blocks field is ignored"},"channels":{"type":"string","description":"Comma-separated string of channel IDs or user IDs where the file will be shared."},"files":{"type":"string","description":"Array of file ids and their corresponding (optional) titles.","required":true},"icon_emoji":{"type":"string","description":"Emoji to use as the icon for the file share message. Overrides iconurl. Requires the chat:write.customize scope."},"icon_url":{"type":"string","description":"URL to an image to use as the icon for the file share message. Requires the chat:write.customize scope."},"initial_comment":{"type":"string","description":"The message text introducing the file in specified channels."},"thread_ts":{"type":"string","description":"Provide another message's ts value to upload this file as a reply. Never use a reply's ts value; use its parent instead. Also make sure to provide only one channel when using 'thread\\ts'"}}},"example":{"blocks":"","channels":"","files":"","icon_emoji":"","icon_url":"","initial_comment":"","thread_ts":""}}}}}},"/files.delete":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/files.delete","api_endpoint":"https://slack.com/api/files.delete"},"summary":"Deletes a file.","description":"Deletes a file.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"file":{"type":"string","description":"ID of file to delete"}}},"example":{"file":""}}}}}},"/files.getUploadURLExternal":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/files.getUploadURLExternal","api_endpoint":"https://slack.com/api/files.getUploadURLExternal"},"summary":"Gets a URL for an edge external file upload","description":"Gets a URL for an edge external file upload","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"alt_txt":{"type":"string","description":"Description of image for screen-reader."},"filename":{"type":"string","description":"Name of the file being uploaded.","required":true},"length":{"type":"number","description":"Size in bytes of the file being uploaded.","required":true},"snippet_type":{"type":"string","description":"Syntax type of the snippet being uploaded."}}},"example":{"alt_txt":"","filename":"","length":"","snippet_type":""}}}}}},"/files.info":{"get":{"tags":["Files"],"parameters":[{"name":"count","in":"query","schema":{"type":"string","example":""}},{"name":"cursor","in":"query","description":"Parameter for pagination","schema":{"type":"string","example":""}},{"name":"file","in":"query","description":"Specify a file by providing its ID","schema":{"type":"string","example":""}},{"name":"limit","in":"query","description":"The maximum number of items to return","schema":{"type":"number","example":""}},{"name":"page","in":"query","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/files.info","api_endpoint":"https://slack.com/api/files.info"},"summary":"Gets information about a file.","description":"Gets information about a file.","security":[{"bearerAuth":[]}]}},"/files.list":{"get":{"tags":["Files"],"parameters":[{"name":"channel","in":"query","description":"Filter files appearing in a specific channel indicated by its ID","schema":{"type":"string","example":""}},{"name":"count","in":"query","schema":{"type":"string","example":""}},{"name":"page","in":"query","schema":{"type":"string","example":""}},{"name":"show_files_hidden_by_limit","in":"query","description":"Show truncated file info for files hidden due to being too old and the team who owns the file being over the file limit","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"ts_from","in":"query","description":"Filter files created after this timestamp (inclusive)","schema":{"type":"number","example":""}},{"name":"ts_to","in":"query","description":"Filter files created before this timestamp (inclusive)","schema":{"type":"number","example":""}},{"name":"types","in":"query","description":"Filter files by type ([see below](#file_types))","schema":{"type":"string","example":""}},{"name":"user","in":"query","description":"Filter files created by a single user","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/files.list","api_endpoint":"https://slack.com/api/files.list"},"summary":"List for a team in a channel or from a user with applied filters.","description":"List for a team in a channel or from a user with applied filters.","security":[{"bearerAuth":[]}]}},"/files.remote.add":{"post":{"tags":["Files Remote"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/files.remote.add","api_endpoint":"https://slack.com/api/files.remote.add"},"summary":"Adds a file from a remote service","description":"Adds a file from a remote service.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"external_id":{"type":"string","description":"Creator defined GUID for the file"},"external_url":{"type":"string","description":"URL of the remote file"},"filetype":{"type":"string","description":"type of file"},"indexable_file_contents":{"type":"string","description":"A text file (txt pdf doc etc"},"preview_image":{"type":"string","description":"Preview of the document via `multipart/form-data`"},"title":{"type":"string","description":"Title of the file being shared"},"token":{"type":"string","description":"Authentication token"}}},"example":{"external_id":"","external_url":"","filetype":"","indexable_file_contents":"","preview_image":"","title":"","token":""}}}}}},"/files.remote.info":{"get":{"tags":["Files Remote"],"parameters":[{"name":"external_id","in":"query","description":"Creator defined GUID for the file","schema":{"type":"string","example":""}},{"name":"file","in":"query","description":"Specify a file by providing its ID","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/files.remote.info","api_endpoint":"https://slack.com/api/files.remote.info"},"summary":"Retrieve information about a remote file added to Slack","description":"Retrieve information about a remote file added to Slack.","security":[{"bearerAuth":[]}]}},"/files.remote.list":{"get":{"tags":["Files Remote"],"parameters":[{"name":"channel","in":"query","description":"Filter files appearing in a specific channel indicated by its ID","schema":{"type":"string","example":""}},{"name":"cursor","in":"query","description":"Paginate through collections of data by setting the `cursor` parameter to a `next_cursor` attribute returned by a previous request's `response_metadata`","schema":{"type":"string","example":""}},{"name":"limit","in":"query","description":"The maximum number of items to return","schema":{"type":"number","example":""}},{"name":"ts_from","in":"query","description":"Filter files created after this timestamp (inclusive)","schema":{"type":"number","example":""}},{"name":"ts_to","in":"query","description":"Filter files created before this timestamp (inclusive)","schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/files.remote.list","api_endpoint":"https://slack.com/api/files.remote.list"},"summary":"Retrieve a list of remote files added to Slack","description":"Retrieve information about a remote file added to Slack.","security":[{"bearerAuth":[]}]}},"/files.remote.remove":{"post":{"tags":["Files Remote"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/files.remote.remove","api_endpoint":"https://slack.com/api/files.remote.remove"},"summary":"Remove a remote file.","description":"Remove a remote file.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"external_id":{"type":"string","description":"Creator defined GUID for the file"},"file":{"type":"string","description":"Specify a file by providing its ID"},"token":{"type":"string","description":"Authentication token"}}},"example":{"external_id":"","file":"","token":""}}}}}},"/files.remote.share":{"post":{"tags":["Files Remote"],"parameters":[{"name":"channels","in":"query","description":"Comma-separated list of channel IDs where the file will be shared","schema":{"type":"string","example":""}},{"name":"external_id","in":"query","description":"The globally unique identifier (GUID) for the file as set by the app registering the file with Slack","schema":{"type":"string","example":""}},{"name":"file","in":"query","description":"Specify a file registered with Slack by providing its ID","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/files.remote.share","api_endpoint":"https://slack.com/api/files.remote.share"},"summary":"Share a remote file into a channel.","description":"Share a remote file into a channel.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channels":{"type":"string","description":"Comma-separated list of channel IDs where the file will be shared"},"external_id":{"type":"string","description":"The globally unique identifier (GUID) for the file as set by the app registering the file with Slack"},"file":{"type":"string","description":"Specify a file registered with Slack by providing its ID"}}},"example":{"channels":"","external_id":"","file":""}}}}}},"/files.remote.update":{"post":{"tags":["Files Remote"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/files.remote.update","api_endpoint":"https://slack.com/api/files.remote.update"},"summary":"Updates an existing remote file.","description":"Updates an existing remote file.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"external_id":{"type":"string","description":"Creator defined GUID for the file"},"external_url":{"type":"string","description":"URL of the remote file"},"file":{"type":"string","description":"Specify a file by providing its ID"},"filetype":{"type":"string","description":"type of file"},"indexable_file_contents":{"type":"string","description":"File containing contents that can be used to improve searchability for the remote file"},"preview_image":{"type":"string","description":"Preview of the document via `multipart/form-data`"},"title":{"type":"string","description":"Title of the file being shared"},"token":{"type":"string","description":"Authentication token"}}},"example":{"external_id":"","external_url":"","file":"","filetype":"","indexable_file_contents":"","preview_image":"","title":"","token":""}}}}}},"/files.revokePublicURL":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/files.revokePublicURL","api_endpoint":"https://slack.com/api/files.revokePublicURL"},"summary":"Revokes public/external sharing access for a file","description":"Revokes public/external sharing access for a file.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"file":{"type":"string","description":"File to revoke"}}},"example":{"file":""}}}}}},"/files.sharedPublicURL":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/files.sharedPublicURL","api_endpoint":"https://slack.com/api/files.sharedPublicURL"},"summary":"Enables a file for public/external sharing.","description":"Enables a file for public/external sharing.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"file":{"type":"string","description":"File to share"}}},"example":{"file":""}}}}}},"/files.upload":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/files.upload","api_endpoint":"https://slack.com/api/files.upload"},"summary":"Uploads or creates a file.","description":"Uploads or creates a file.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":[],"properties":{"channels":{"type":"string","description":"Comma-separated list of channel names or IDs where the file will be shared"},"content":{"type":"string","description":"File contents via a POST variable"},"file":{"type":"string","description":"File contents via `multipart/form-data`"},"filename":{"type":"string","description":"Filename of file"},"filetype":{"type":"string","description":"A [file type](/types/file#file_types) identifier"},"initial_comment":{"type":"string","description":"The message text introducing the file in specified `channels`"},"thread_ts":{"type":"number","description":"Provide another message's `ts` value to upload this file as a reply"},"title":{"type":"string","description":"Title of file"},"token":{"type":"string","description":"Authentication token"}}},"example":{"channels":"","content":"","file":"","filename":"","filetype":"","initial_comment":"","thread_ts":"","title":"","token":""}}}}}},"/functions.completeError":{"post":{"tags":["Functions"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/functions.completeError","api_endpoint":"https://slack.com/api/functions.completeError"},"summary":"Signal that a function failed to complete","description":"Signal that a function failed to complete","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"error":{"type":"string","description":"A human-readable error message that contains information about why the function failed to complete","required":true},"function_execution_id":{"type":"string","description":"Context identifier that maps to the executed function","required":true}}},"example":{"error":"","function_execution_id":""}}}}}},"/functions.completeSuccess":{"post":{"tags":["Functions"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/functions.completeSuccess","api_endpoint":"https://slack.com/api/functions.completeSuccess"},"summary":"Signal the successful completion of a function","description":"Signal the successful completion of a function","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"function_execution_id":{"type":"string","description":"Context identifier that maps to the executed function","required":true},"outputs":{"type":"string","description":"A JSON-based object that conforms to the output parameters schema for the custom function defined in the manifest","required":true}}},"example":{"function_execution_id":"","outputs":""}}}}}},"/functions.distributions.permissions.add":{"post":{"tags":["Functions Distributions Permissions"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/functions.distributions.permissions.add","api_endpoint":"https://slack.com/api/functions.distributions.permissions.add"},"summary":"Grant users access to a custom slack function if its permission_type is set to named_entities","description":"Grant users access to a custom slack function if its permission_type is set to named_entities","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"function_app_id":{"type":"string","description":"The encoded ID of the app"},"function_callback_id":{"type":"string","description":"The callback ID defined in the function's definition file"},"function_id":{"type":"string","description":"The encoded ID of the function"},"user_ids":{"type":"string","description":"List of encoded user IDs"}}},"example":{"function_app_id":"","function_callback_id":"","function_id":"","user_ids":""}}}}}},"/functions.distributions.permissions.list":{"post":{"tags":["Functions Distributions Permissions"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/functions.distributions.permissions.list","api_endpoint":"https://slack.com/api/functions.distributions.permissions.list"},"summary":"List the access type of a custom slack function and include the users, team or org ids with access if its permission_type is set to named_entities","description":"List the access type of a custom slack function and include the users, team or org ids with access if its permission_type is set to named_entities","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"function_app_id":{"type":"string","description":"The encoded ID of the app"},"function_callback_id":{"type":"string","description":"The callback ID defined in the function's definition file"},"function_id":{"type":"string","description":"The encoded ID of the function"}}},"example":{"function_app_id":"","function_callback_id":"","function_id":""}}}}}},"/functions.distributions.permissions.remove":{"post":{"tags":["Functions Distributions Permissions"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/functions.distributions.permissions.remove","api_endpoint":"https://slack.com/api/functions.distributions.permissions.remove"},"summary":"Revoke user access to a custom slack function if permission_type set to named_entities","description":"Revoke user access to a custom slack function if permission_type set to named_entities","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"function_app_id":{"type":"string","description":"The encoded ID of the app."},"function_callback_id":{"type":"string","description":"The callback ID defined in the function's definition file"},"function_id":{"type":"string","description":"The encoded ID of the function"},"user_ids":{"type":"string","description":"List of encoded user IDs"}}},"example":{"function_app_id":"","function_callback_id":"","function_id":"","user_ids":""}}}}}},"/functions.distributions.permissions.set":{"post":{"tags":["Functions Distributions Permissions"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/functions.distributions.permissions.set","api_endpoint":"https://slack.com/api/functions.distributions.permissions.set"},"summary":"Set the access type of a custom slack function and define the users, team or org ids to be granted access if permission_type is set to named_entities","description":"Set the access type of a custom slack function and define the users, team or org ids to be granted access if permission_type is set to named_entities","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"function_app_id":{"type":"string","description":"The encoded ID of the app"},"function_callback_id":{"type":"string","description":"The callback ID defined in the function's definition file"},"function_id":{"type":"string","description":"The encoded ID of the function"},"org_ids":{"type":"string","description":"List of org IDs to allow for named\\entities permission"},"permission_type":{"type":"string","description":"The type of permission that defines how the function can be distributed Acceptable values: everyone appcollaborators namedentities system"},"team_ids":{"type":"string","description":"List of team IDs to allow for named\\entities permission"},"user_ids":{"type":"string","description":"List of encoded user IDs"}}},"example":{"function_app_id":"","function_callback_id":"","function_id":"","org_ids":"","permission_type":"","team_ids":"","user_ids":""}}}}}},"/functions.workflows.steps.list":{"post":{"tags":["Functions Workflows Steps"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/functions.workflows.steps.list","api_endpoint":"https://slack.com/api/functions.workflows.steps.list"},"summary":"List the steps of a specific function of a workflow's versions","description":"List the steps of a specific function of a workflow's versions","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"function_id":{"type":"string","description":"The ID of the function to query","required":true},"workflow":{"type":"string","description":"The workflow encoded ID or workflow reference"},"workflow_app_id":{"type":"string","description":"The app tied to the workflow reference."},"workflow_id":{"type":"string","description":"The workflow ID, starts with Wf\\"}}},"example":{"function_id":"","workflow":"","workflow_app_id":"","workflow_id":""}}}}}},"/functions.workflows.steps.responses.export":{"post":{"tags":["Functions Workflows Steps Responses"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/functions.workflows.steps.responses.export","api_endpoint":"https://slack.com/api/functions.workflows.steps.responses.export"},"summary":"Download form responses of a workflow","description":"Download form responses of a workflow","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"step_id":{"type":"string","description":"The ID of the OpenForm step to export.","required":true},"workflow":{"type":"string","description":"The workflow encoded ID or workflow reference"},"workflow_app_id":{"type":"string","description":"The app tied to the workflow reference."},"workflow_id":{"type":"string","description":"The workflow ID, starts with Wf\\"}}},"example":{"step_id":"","workflow":"","workflow_app_id":"","workflow_id":""}}}}}},"/migration.exchange":{"get":{"tags":["Migration"],"parameters":[{"name":"team_id","in":"query","description":"Specify team_id starts with `T` in case of Org Token","schema":{"type":"string","example":""}},{"name":"to_old","in":"query","description":"Specify `true` to convert `W` global user IDs to workspace-specific `U` IDs","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"users","in":"query","description":"A comma-separated list of user ids up to 400 per request","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/migration.exchange","api_endpoint":"https://slack.com/api/migration.exchange"},"summary":"For Enterprise Grid workspaces map local user IDs to global user IDs","description":"For Enterprise Grid workspaces map local user IDs to global user IDs.","security":[{"bearerAuth":[]}]}},"/oauth.access":{"get":{"tags":["Oauth"],"parameters":[{"name":"client_id","in":"query","description":"Issued when you created your application","schema":{"type":"string","example":""}},{"name":"client_secret","in":"query","description":"Issued when you created your application","schema":{"type":"string","example":""}},{"name":"code","in":"query","description":"The `code` param returned via the OAuth callback","schema":{"type":"string","example":""}},{"name":"redirect_uri","in":"query","description":"This must match the originally submitted URI (if one was sent)","schema":{"type":"string","example":""}},{"name":"single_channel","in":"query","description":"Request the user to add your app only to a single channel","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/oauth.access","api_endpoint":"https://slack.com/api/oauth.access"},"summary":"Exchanges a temporary OAuth verifier code for an access token (legacy flow).","description":"Exchanges a temporary OAuth verifier code for an access token.","security":[{"bearerAuth":[]}]}},"/oauth.v2.access":{"get":{"tags":["Oauth V2"],"parameters":[{"name":"client_id","in":"query","description":"Issued when you created your application","schema":{"type":"string","example":""}},{"name":"client_secret","in":"query","description":"Issued when you created your application","schema":{"type":"string","example":""}},{"name":"code","in":"query","description":"The `code` param returned via the OAuth callback","required":true,"schema":{"type":"string","example":""}},{"name":"redirect_uri","in":"query","description":"This must match the originally submitted URI (if one was sent)","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/oauth.v2.access","api_endpoint":"https://slack.com/api/oauth.v2.access"},"summary":"Exchanges a temporary OAuth verifier code for an access token.","description":"Exchanges a temporary OAuth verifier code for an access token.","security":[{"bearerAuth":[]}]}},"/oauth.v2.beginShortTokenRotation":{"post":{"tags":["Oauth V2"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/oauth.v2.beginShortTokenRotation","api_endpoint":"https://slack.com/api/oauth.v2.beginShortTokenRotation"},"summary":"Begins rotating the secret on an API token with a short secret.","description":"Begins rotating the secret on an API token with a short secret.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"client_id":{"type":"string","description":"Issued when you created your application. Must be the app the token being rotated was issued to.","required":true},"client_secret":{"type":"string","description":"Issued when you created your application.","required":true}}},"example":{"client_id":"","client_secret":""}}}}}},"/oauth.v2.completeShortTokenRotation":{"post":{"tags":["Oauth V2"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/oauth.v2.completeShortTokenRotation","api_endpoint":"https://slack.com/api/oauth.v2.completeShortTokenRotation"},"summary":"Finishes rotating the secret on an API token with a short secret.","description":"Finishes rotating the secret on an API token with a short secret.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"client_id":{"type":"string","description":"Issued when you created your application. Must be the app the token being rotated was issued to.","required":true},"client_secret":{"type":"string","description":"Issued when you created your application.","required":true},"new_token":{"type":"string","description":"The new xoxp token returned by oauth.v2.beginShortTokenRotation.","required":true}}},"example":{"client_id":"","client_secret":"","new_token":""}}}}}},"/oauth.v2.exchange":{"post":{"tags":["Oauth V2"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/oauth.v2.exchange","api_endpoint":"https://slack.com/api/oauth.v2.exchange"},"summary":"Exchanges a legacy access token for a new expiring access token and refresh token","description":"Exchanges a legacy access token for a new expiring access token and refresh token","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"client_id":{"type":"string","description":"Issued when you created your application.","required":true},"client_secret":{"type":"string","description":"Issued when you created your application.","required":true}}},"example":{"client_id":"","client_secret":""}}}}}},"/oauth.v2.user.access":{"post":{"tags":["Oauth V2 User"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/oauth.v2.user.access","api_endpoint":"https://slack.com/api/oauth.v2.user.access"},"summary":"Exchanges a temporary OAuth verifier code for a user access token.","description":"Exchanges a temporary OAuth verifier code for a user access token.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"assertion":{"type":"string","description":"Identity assertion JWT authorization grant."},"client_id":{"type":"string","description":"Issued when you created your application. If possible, avoid sending clientid and clientsecret as parameters in your request and instead supply the Client ID and Client Secret using the HTTP Basic authentication scheme."},"client_secret":{"type":"string","description":"Issued when you created your application. If possible, avoid sending clientid and clientsecret as parameters in your request and instead supply the Client ID and Client Secret using the HTTP Basic authentication scheme."},"code":{"type":"string","description":"The code param returned via the OAuth callback."},"code_verifier":{"type":"string","description":"The code\\verifier param used to generate the code\\challenge originally. Used for PKCE."},"grant_type":{"type":"string","description":"The granttype param as described in the OAuth spec."},"redirect_uri":{"type":"string","description":"This must match the originally submitted URI (if one was sent)."},"refresh_token":{"type":"string","description":"The refreshtoken param as described in the OAuth spec."}}},"example":{"assertion":"","client_id":"","client_secret":"","code":"","code_verifier":"","grant_type":"","redirect_uri":"","refresh_token":""}}}}}},"/openid.connect.token":{"post":{"tags":["Openid Connect"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/openid.connect.token","api_endpoint":"https://slack.com/api/openid.connect.token"},"summary":"Exchanges a temporary OAuth verifier code for an access token for Sign in with Slack.","description":"Exchanges a temporary OAuth verifier code for an access token for Sign in with Slack.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"client_id":{"type":"string","description":"Issued when you created your application."},"client_secret":{"type":"string","description":"Issued when you created your application."},"code":{"type":"string","description":"The code param returned via the OAuth callback."},"code_verifier":{"type":"string","description":"PKCE code verifier (RFC 7636). Required when the authorization request included a codechallenge."},"grant_type":{"type":"string","description":"The granttype param as described in the OAuth spec. Acceptable values: authorizationcode refreshtoken"},"redirect_uri":{"type":"string","description":"This must match the originally submitted URI (if one was sent)."},"refresh_token":{"type":"string","description":"The refreshtoken param as described in the OAuth spec."}}},"example":{"client_id":"","client_secret":"","code":"","code_verifier":"","grant_type":"","redirect_uri":"","refresh_token":""}}}}}},"/openid.connect.userInfo":{"post":{"tags":["Openid Connect"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/openid.connect.userInfo","api_endpoint":"https://slack.com/api/openid.connect.userInfo"},"summary":"Get the identity of a user who has authorized Sign in with Slack.","description":"Get the identity of a user who has authorized Sign in with Slack.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/pins.add":{"post":{"tags":["Pins"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/pins.add","api_endpoint":"https://slack.com/api/pins.add"},"summary":"Pins an item to a channel.","description":"Pins an item to a channel.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel":{"type":"string","description":"Channel to pin the item in","required":true},"timestamp":{"type":"string","description":"Timestamp of the message to pin"}}},"example":{"channel":"","timestamp":""}}}}}},"/pins.list":{"get":{"tags":["Pins"],"parameters":[{"name":"channel","in":"query","description":"Channel to get pinned items for","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/pins.list","api_endpoint":"https://slack.com/api/pins.list"},"summary":"Lists items pinned to a channel.","description":"Lists items pinned to a channel.","security":[{"bearerAuth":[]}]}},"/pins.remove":{"post":{"tags":["Pins"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/pins.remove","api_endpoint":"https://slack.com/api/pins.remove"},"summary":"Un-pins an item from a channel.","description":"Un-pins an item from a channel.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel":{"type":"string","description":"Channel where the item is pinned to","required":true},"timestamp":{"type":"string","description":"Timestamp of the message to un-pin"}}},"example":{"channel":"","timestamp":""}}}}}},"/reactions.add":{"post":{"tags":["Reactions"],"parameters":[{"name":"channel","in":"query","description":"Channel where the message lives","required":"true","schema":{"type":"string","example":""}},{"name":"timestamp","in":"query","description":"Timestamp of the message to react to","required":"true","schema":{"type":"string","example":""}},{"name":"name","in":"query","description":"Emoji name without colons (e.g. eyes)","required":"true","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/reactions.add","api_endpoint":"https://slack.com/api/reactions.add"},"summary":"Adds a reaction to an item.","description":"Adds a reaction to an item.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel":{"type":"string","description":"Channel where the message to add reaction to was posted","required":true},"name":{"type":"string","description":"Reaction (emoji) name","required":true},"timestamp":{"type":"string","description":"Timestamp of the message to add reaction to","required":true}}},"example":{"channel":"","name":"","timestamp":""}}}}}},"/reactions.get":{"get":{"tags":["Reactions"],"parameters":[{"name":"channel","in":"query","description":"Channel where the message to get reactions for was posted","schema":{"type":"string","example":""}},{"name":"file","in":"query","description":"File to get reactions for","schema":{"type":"string","example":""}},{"name":"file_comment","in":"query","description":"File comment to get reactions for","schema":{"type":"string","example":""}},{"name":"full","in":"query","description":"If true always return the complete reaction list","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"timestamp","in":"query","description":"Timestamp of the message to get reactions for","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/reactions.get","api_endpoint":"https://slack.com/api/reactions.get"},"summary":"Gets reactions for an item.","description":"Gets reactions for an item.","security":[{"bearerAuth":[]}]}},"/reactions.list":{"get":{"tags":["Reactions"],"parameters":[{"name":"count","in":"query","schema":{"type":"number","example":""}},{"name":"cursor","in":"query","description":"Parameter for pagination","schema":{"type":"string","example":""}},{"name":"full","in":"query","description":"If true always return the complete reaction list","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"limit","in":"query","description":"The maximum number of items to return","schema":{"type":"number","example":""}},{"name":"page","in":"query","schema":{"type":"number","example":""}},{"name":"user","in":"query","description":"Show reactions made by this user","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/reactions.list","api_endpoint":"https://slack.com/api/reactions.list"},"summary":"Lists reactions made by a user.","description":"Lists reactions made by a user.","security":[{"bearerAuth":[]}]}},"/reactions.remove":{"post":{"tags":["Reactions"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/reactions.remove","api_endpoint":"https://slack.com/api/reactions.remove"},"summary":"Removes a reaction from an item.","description":"Removes a reaction from an item.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel":{"type":"string","description":"Channel where the message to remove reaction from was posted"},"file":{"type":"string","description":"File to remove reaction from"},"file_comment":{"type":"string","description":"File comment to remove reaction from"},"name":{"type":"string","description":"Reaction (emoji) name","required":true},"timestamp":{"type":"string","description":"Timestamp of the message to remove reaction from"}}},"example":{"channel":"","file":"","file_comment":"","name":"","timestamp":""}}}}}},"/rtm.connect":{"get":{"tags":["Rtm"],"parameters":[{"name":"batch_presence_aware","in":"query","description":"Batch presence deliveries via subscription","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"presence_sub","in":"query","description":"Only deliver presence events when requested by subscription","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/rtm.connect","api_endpoint":"https://slack.com/api/rtm.connect"},"summary":"Starts a Real Time Messaging session.","description":"Starts a Real Time Messaging session.","security":[{"bearerAuth":[]}]}},"/rtm.start":{"get":{"tags":["Rtm"],"parameters":[{"name":"batch_presence_aware","in":"query","description":"Batch presence deliveries via subscription. Enabling changes the shape of presencechange events. See batch presence. Default: false","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"include_locale","in":"query","description":"Set this to true to receive the locale for users and channels. Defaults to false","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"mpim_aware","in":"query","description":"Returns MPIMs to the client in the API response.","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"no_latest","in":"query","description":"Exclude latest timestamps for channels, groups, mpims, and ims. Automatically sets nounreads to 1 Default: 0","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"no_unreads","in":"query","description":"Skip unread counts for each channel (improves performance).","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"presence_sub","in":"query","description":"Only deliver presence events when requested by subscription. See presence subscriptions. Default: true","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"simple_latest","in":"query","description":"Return timestamp only for latest message object of each channel (improves performance).","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/rtm.start","api_endpoint":"https://slack.com/api/rtm.start"},"summary":"Deprecated: Starts a Real Time Messaging session. Use rtm.connect instead.","description":"Deprecated: Starts a Real Time Messaging session. Use rtm.connect instead.","security":[{"bearerAuth":[]}]}},"/slackLists.access.delete":{"post":{"tags":["SlackLists Access"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/slackLists.access.delete","api_endpoint":"https://slack.com/api/slackLists.access.delete"},"summary":"Revoke access to a List for specified entities.","description":"Revoke access to a List for specified entities.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel_ids":{"type":"string","description":"List of channels you wish to update access for. Can only be used if userids is not provided."},"user_ids":{"type":"string","description":"List of users you wish to update access for. Can only be used if channelids is not provided."}}},"example":{"channel_ids":"","user_ids":""}}}}}},"/slackLists.access.set":{"post":{"tags":["SlackLists Access"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/slackLists.access.set","api_endpoint":"https://slack.com/api/slackLists.access.set"},"summary":"Set the access level to a List for specified entities.","description":"Set the access level to a List for specified entities.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel_ids":{"type":"string","description":"List of channels you wish to update access for. Can only be used if userids is not provided."},"user_ids":{"type":"string","description":"List of users you wish to update access for. Can only be used if channelids is not provided."}}},"example":{"channel_ids":"","user_ids":""}}}}}},"/slackLists.create":{"post":{"tags":["SlackLists"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/slackLists.create","api_endpoint":"https://slack.com/api/slackLists.create"},"summary":"Create a List.","description":"Create a List.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"copy_from_list_id":{"type":"string","description":"ID of the List to copy."},"description_blocks":{"type":"string","description":"A rich text description of the List."},"include_copied_list_records":{"type":"boolean","description":"Boolean indicating whether to include records when a List is copied.","enum":[true,false]},"name":{"type":"string","description":"Name of the List.","required":true},"schema":{"type":"string","description":"Column definition for the List."},"todo_mode":{"type":"boolean","description":"Boolean indicating whether the List should be used to track todo tasks.","enum":[true,false]}}},"example":{"copy_from_list_id":"","description_blocks":"","include_copied_list_records":"","name":"","schema":"","todo_mode":""}}}}}},"/slackLists.download.get":{"post":{"tags":["SlackLists Download"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/slackLists.download.get","api_endpoint":"https://slack.com/api/slackLists.download.get"},"summary":"Retrieve List download URL from an export job to download List contents.","description":"Retrieve List download URL from an export job to download List contents.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"include_attachments":{"type":"boolean","description":"Must match the includeattachments passed to slackLists.download.start. The returned downloadurl carries this through so the served export matches what was generated. Only applies when format is json.","enum":[true,false]},"include_threads":{"type":"boolean","description":"Must match the includethreads passed to slackLists.download.start. The returned downloadurl carries this through so the served export matches what was generated. Only applies when format is json.","enum":[true,false]},"job_id":{"type":"string","description":"The ID of the recently started job to export the List.","required":true},"list_id":{"type":"string","description":"ID of the List to export.","required":true}}},"example":{"include_attachments":"","include_threads":"","job_id":"","list_id":""}}}}}},"/slackLists.download.start":{"post":{"tags":["SlackLists Download"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/slackLists.download.start","api_endpoint":"https://slack.com/api/slackLists.download.start"},"summary":"Initiate a job to export List contents.","description":"Initiate a job to export List contents.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"include_archived":{"type":"boolean","description":"include_archived","enum":[true,false]},"include_attachments":{"type":"boolean","description":"Include file attachment metadata and access paths in the export. Only applies when format is json.","enum":[true,false]},"include_threads":{"type":"boolean","description":"Include each item's conversation thread in the export. Only applies when format is json.","enum":[true,false]},"list_id":{"type":"string","description":"ID of the List to export.","required":true}}},"example":{"include_archived":"","include_attachments":"","include_threads":"","list_id":""}}}}}},"/slackLists.items.create":{"post":{"tags":["SlackLists Items"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/slackLists.items.create","api_endpoint":"https://slack.com/api/slackLists.items.create"},"summary":"Add a new item to an existing List.","description":"Add a new item to an existing List.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"initial_fields":{"type":"string","description":"Initial item data."}}},"example":{"initial_fields":""}}}}}},"/slackLists.items.delete":{"post":{"tags":["SlackLists Items"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/slackLists.items.delete","api_endpoint":"https://slack.com/api/slackLists.items.delete"},"summary":"Deletes an item from an existing List.","description":"Deletes an item from an existing List.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"id":{"type":"string","description":"ID of item to delete.","required":true},"list_id":{"type":"string","description":"ID of the List containing the item.","required":true}}},"example":{"id":"","list_id":""}}}}}},"/slackLists.items.deleteMultiple":{"post":{"tags":["SlackLists Items"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/slackLists.items.deleteMultiple","api_endpoint":"https://slack.com/api/slackLists.items.deleteMultiple"},"summary":"Deletes multiple items from an existing List.","description":"Deletes multiple items from an existing List.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"ids":{"type":"string","description":"IDs of items to delete.","required":true},"list_id":{"type":"string","description":"ID of the List containing the items.","required":true}}},"example":{"ids":"","list_id":""}}}}}},"/slackLists.items.info":{"post":{"tags":["SlackLists Items"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/slackLists.items.info","api_endpoint":"https://slack.com/api/slackLists.items.info"},"summary":"Get a row from a List.","description":"Get a row from a List.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"id":{"type":"string","description":"ID of the row to get.","required":true},"include_is_subscribed":{"type":"boolean","description":"Set to true to include issubscribed data for the returned List row. Default: false","enum":[true,false]},"list_id":{"type":"string","description":"ID of the List.","required":true}}},"example":{"id":"","include_is_subscribed":"","list_id":""}}}}}},"/slackLists.items.list":{"post":{"tags":["SlackLists Items"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/slackLists.items.list","api_endpoint":"https://slack.com/api/slackLists.items.list"},"summary":"Get records from a List.","description":"Get records from a List.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"archived":{"type":"boolean","description":"Boolean indicating whether archived items or normal items should be returned.","enum":[true,false]},"cursor":{"type":"string","description":"Next cursor for pagination."},"include_list":{"type":"boolean","description":"Set to true to also return the parent list object, including its title, column schema, and total row count. Defaults to false to keep the response small.","enum":[true,false]},"limit":{"type":"number","description":"The maximum number of records to return."},"list_id":{"type":"string","description":"ID of the List.","required":true}}},"example":{"archived":"","cursor":"","include_list":"","limit":"","list_id":""}}}}}},"/slackLists.items.update":{"post":{"tags":["SlackLists Items"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/slackLists.items.update","api_endpoint":"https://slack.com/api/slackLists.items.update"},"summary":"Updates cells in a List.","description":"Updates cells in a List.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"cells":{"type":"string","description":"Cells to update.","required":true},"list_id":{"type":"string","description":"ID of the List to add or update cells.","required":true}}},"example":{"cells":"","list_id":""}}}}}},"/slackLists.update":{"post":{"tags":["SlackLists"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/slackLists.update","api_endpoint":"https://slack.com/api/slackLists.update"},"summary":"Update a List.","description":"Update a List.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"description_blocks":{"type":"string","description":"A rich text description of the List."},"name":{"type":"string","description":"The updated name of the List."},"todo_mode":{"type":"boolean","description":"Boolean indicating whether the List should be in todo mode.","enum":[true,false]}}},"example":{"description_blocks":"","name":"","todo_mode":""}}}}}},"/team.info":{"get":{"tags":["Team"],"parameters":[{"name":"team","in":"query","description":"Team to get info on if omitted will return information about the current team","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/team.info","api_endpoint":"https://slack.com/api/team.info"},"summary":"Gets information about the current team.","description":"Gets information about the current team.","security":[{"bearerAuth":[]}]}},"/team.profile.get":{"get":{"tags":["Team Profile"],"parameters":[{"name":"visibility","in":"query","description":"Filter by visibility","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/team.profile.get","api_endpoint":"https://slack.com/api/team.profile.get"},"summary":"Retrieve a team's profile.","description":"Retrieve a team's profile.","security":[{"bearerAuth":[]}]}},"/tooling.tokens.rotate":{"post":{"tags":["Tooling Tokens"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/tooling.tokens.rotate","api_endpoint":"https://slack.com/api/tooling.tokens.rotate"},"summary":"Exchanges a refresh token for a new app configuration token.","description":"Exchanges a refresh token for a new app configuration token.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"refresh_token":{"type":"string","description":"The xoxe refresh token that was issued along with the old app configuration token.","required":true}}},"example":{"refresh_token":""}}}}}},"/usergroups.create":{"post":{"tags":["Usergroups"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/usergroups.create","api_endpoint":"https://slack.com/api/usergroups.create"},"summary":"Create a User Group","description":"Create a User Group.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channels":{"type":"string","description":"A comma separated string of encoded channel IDs for which the User Group uses as a default"},"description":{"type":"string","description":"A short description of the User Group"},"handle":{"type":"string","description":"A mention handle"},"include_count":{"type":"boolean","description":"Include the number of users in each User Group","enum":[true,false]},"name":{"type":"string","description":"A name for the User Group","required":true}}},"example":{"channels":"","description":"","handle":"","include_count":"","name":""}}}}}},"/usergroups.disable":{"post":{"tags":["Usergroups"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/usergroups.disable","api_endpoint":"https://slack.com/api/usergroups.disable"},"summary":"Disable an existing User Group","description":"Disable an existing User Group.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"include_count":{"type":"boolean","description":"Include the number of users in the User Group","enum":[true,false]},"usergroup":{"type":"string","description":"The encoded ID of the User Group to disable","required":true}}},"example":{"include_count":"","usergroup":""}}}}}},"/usergroups.enable":{"post":{"tags":["Usergroups"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/usergroups.enable","api_endpoint":"https://slack.com/api/usergroups.enable"},"summary":"Enable a User Group","description":"Enable a User Group.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"include_count":{"type":"boolean","description":"Include the number of users in the User Group","enum":[true,false]},"usergroup":{"type":"string","description":"The encoded ID of the User Group to enable","required":true}}},"example":{"include_count":"","usergroup":""}}}}}},"/usergroups.list":{"get":{"tags":["Usergroups"],"parameters":[{"name":"include_count","in":"query","description":"Include the number of users in each User Group","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"include_disabled","in":"query","description":"Include disabled User Groups","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"include_users","in":"query","description":"Include the list of users for each User Group","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/usergroups.list","api_endpoint":"https://slack.com/api/usergroups.list"},"summary":"List all User Groups for a team","description":"List all User Groups for a team.","security":[{"bearerAuth":[]}]}},"/usergroups.update":{"post":{"tags":["Usergroups"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/usergroups.update","api_endpoint":"https://slack.com/api/usergroups.update"},"summary":"Update an existing User Group","description":"Update an existing User Group.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channels":{"type":"string","description":"A comma separated string of encoded channel IDs for which the User Group uses as a default"},"description":{"type":"string","description":"A short description of the User Group"},"handle":{"type":"string","description":"A mention handle"},"include_count":{"type":"boolean","description":"Include the number of users in the User Group","enum":[true,false]},"name":{"type":"string","description":"A name for the User Group"},"usergroup":{"type":"string","description":"The encoded ID of the User Group to update","required":true}}},"example":{"channels":"","description":"","handle":"","include_count":"","name":"","usergroup":""}}}}}},"/usergroups.users.list":{"get":{"tags":["Usergroups Users"],"parameters":[{"name":"include_disabled","in":"query","description":"Allow results that involve disabled User Groups","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"usergroup","in":"query","description":"The encoded ID of the User Group to update","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/usergroups.users.list","api_endpoint":"https://slack.com/api/usergroups.users.list"},"summary":"List all users in a User Group","description":"List all users in a User Group.","security":[{"bearerAuth":[]}]}},"/usergroups.users.update":{"post":{"tags":["Usergroups Users"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/usergroups.users.update","api_endpoint":"https://slack.com/api/usergroups.users.update"},"summary":"Update the list of users for a User Group","description":"Update the list of users for a User Group.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"include_count":{"type":"boolean","description":"Include the number of users in the User Group","enum":[true,false]},"usergroup":{"type":"string","description":"The encoded ID of the User Group to update","required":true},"users":{"type":"string","description":"A comma separated string of encoded user IDs that represent the entire list of users for the User Group","required":true}}},"example":{"include_count":"","usergroup":"","users":""}}}}}},"/users.conversations":{"get":{"tags":["Users"],"parameters":[{"name":"cursor","in":"query","description":"Paginate through collections of data by setting the `cursor` parameter to a `next_cursor` attribute returned by a previous request's `response_metadata`","schema":{"type":"string","example":""}},{"name":"exclude_archived","in":"query","description":"Set to `true` to exclude archived channels from the list","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"limit","in":"query","description":"The maximum number of items to return","schema":{"type":"number","example":""}},{"name":"types","in":"query","description":"Mix and match channel types by providing a comma-separated list of any combination of `public_channel` `private_channel` `mpim` `im`","schema":{"type":"string","example":""}},{"name":"user","in":"query","description":"Browse conversations by a specific user ID's membership","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/users.conversations","api_endpoint":"https://slack.com/api/users.conversations"},"summary":"List conversations the calling user may access.","description":"List conversations the calling user may access.","security":[{"bearerAuth":[]}]}},"/users.discoverableContacts.lookup":{"post":{"tags":["Users DiscoverableContacts"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/users.discoverableContacts.lookup","api_endpoint":"https://slack.com/api/users.discoverableContacts.lookup"},"summary":"Look up an email address to see if someone is discoverable on Slack","description":"Look up an email address to see if someone is discoverable on Slack","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"email":{"type":"string","description":"email","required":true}}},"example":{"email":""}}}}}},"/users.getPresence":{"get":{"tags":["Users"],"parameters":[{"name":"user","in":"query","description":"User to get presence info on","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/users.getPresence","api_endpoint":"https://slack.com/api/users.getPresence"},"summary":"Gets user presence information.","description":"Gets user presence information.","security":[{"bearerAuth":[]}]}},"/users.info":{"get":{"tags":["Users"],"parameters":[{"name":"include_locale","in":"query","description":"Set this to `true` to receive the locale for this user","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"user","in":"query","description":"User to get info on","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/users.info","api_endpoint":"https://slack.com/api/users.info"},"summary":"Gets information about a user.","description":"Gets information about a user.","security":[{"bearerAuth":[]}]}},"/users.list":{"get":{"tags":["Users"],"parameters":[{"name":"cursor","in":"query","description":"Paginate through collections of data by setting the `cursor` parameter to a `next_cursor` attribute returned by a previous request's `response_metadata`","schema":{"type":"string","example":""}},{"name":"include_locale","in":"query","description":"Set this to `true` to receive the locale for users","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"limit","in":"query","description":"The maximum number of items to return","schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/users.list","api_endpoint":"https://slack.com/api/users.list"},"summary":"Lists all users in a Slack team.","description":"Lists all users in a Slack team.","security":[{"bearerAuth":[]}]}},"/users.lookupByEmail":{"get":{"tags":["Users"],"parameters":[{"name":"email","in":"query","description":"An email address belonging to a user in the workspace","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/users.lookupByEmail","api_endpoint":"https://slack.com/api/users.lookupByEmail"},"summary":"Find a user with an email address.","description":"Find a user with an email address.","security":[{"bearerAuth":[]}]}},"/users.profile.get":{"get":{"tags":["Users Profile"],"parameters":[{"name":"include_labels","in":"query","description":"Include labels for each ID in custom profile fields","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"user","in":"query","description":"User to retrieve profile info for","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/users.profile.get","api_endpoint":"https://slack.com/api/users.profile.get"},"summary":"Retrieves a user's profile information.","description":"Retrieves a user's profile information.","security":[{"bearerAuth":[]}]}},"/users.setActive":{"post":{"tags":["Users"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/users.setActive","api_endpoint":"https://slack.com/api/users.setActive"},"summary":"Marked a user as active. Deprecated and non-functional.","description":"Marked a user as active.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/users.setPresence":{"post":{"tags":["Users"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/users.setPresence","api_endpoint":"https://slack.com/api/users.setPresence"},"summary":"Manually sets user presence.","description":"Manually sets user presence.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"presence":{"type":"string","description":"Either `auto` or `away`","required":true}}},"example":{"presence":""}}}}}},"/views.open":{"get":{"tags":["Views"],"parameters":[{"name":"trigger_id","in":"query","description":"Exchange a trigger to post to the user","required":true,"schema":{"type":"string","example":""}},{"name":"view","in":"query","description":"A [view payload](/reference/surfaces/views)","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/views.open","api_endpoint":"https://slack.com/api/views.open"},"summary":"Open a view for a user.","description":"Open a view for a user.","security":[{"bearerAuth":[]}]}},"/views.publish":{"get":{"tags":["Views"],"parameters":[{"name":"hash","in":"query","description":"A string that represents view state to protect against possible race conditions","schema":{"type":"string","example":""}},{"name":"user_id","in":"query","description":"`id` of the user you want publish a view to","required":true,"schema":{"type":"string","example":""}},{"name":"view","in":"query","description":"A [view payload](/reference/surfaces/views)","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/views.publish","api_endpoint":"https://slack.com/api/views.publish"},"summary":"Publish a static view for a User.","description":"Publish a static view for a User.","security":[{"bearerAuth":[]}]}},"/views.push":{"get":{"tags":["Views"],"parameters":[{"name":"trigger_id","in":"query","description":"Exchange a trigger to post to the user","required":true,"schema":{"type":"string","example":""}},{"name":"view","in":"query","description":"A [view payload](/reference/surfaces/views)","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/views.push","api_endpoint":"https://slack.com/api/views.push"},"summary":"Push a view onto the stack of a root view.","description":"Push a view onto the stack of a root view.","security":[{"bearerAuth":[]}]}},"/views.update":{"get":{"tags":["Views"],"parameters":[{"name":"external_id","in":"query","description":"A unique identifier of the view set by the developer","schema":{"type":"string","example":""}},{"name":"hash","in":"query","description":"A string that represents view state to protect against possible race conditions","schema":{"type":"string","example":""}},{"name":"view","in":"query","description":"A [view object](/reference/surfaces/views)","schema":{"type":"string","example":""}},{"name":"view_id","in":"query","description":"A unique identifier of the view to be updated","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/views.update","api_endpoint":"https://slack.com/api/views.update"},"summary":"Update an existing view.","description":"Update an existing view.","security":[{"bearerAuth":[]}]}},"/workflows.featured.add":{"post":{"tags":["Workflows Featured"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/workflows.featured.add","api_endpoint":"https://slack.com/api/workflows.featured.add"},"summary":"Add featured workflows to a channel.","description":"Add featured workflows to a channel.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel_id":{"type":"string","description":"Channel to add featured workflow in.","required":true},"trigger_ids":{"type":"string","description":"Comma-separated array of trigger IDs to add; max 15","required":true}}},"example":{"channel_id":"","trigger_ids":""}}}}}},"/workflows.featured.list":{"post":{"tags":["Workflows Featured"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/workflows.featured.list","api_endpoint":"https://slack.com/api/workflows.featured.list"},"summary":"List the featured workflows for specified channels.","description":"List the featured workflows for specified channels.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel_ids":{"type":"string","description":"Comma-separated array of channel IDs to list featured workflows for.","required":true}}},"example":{"channel_ids":""}}}}}},"/workflows.featured.remove":{"post":{"tags":["Workflows Featured"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/workflows.featured.remove","api_endpoint":"https://slack.com/api/workflows.featured.remove"},"summary":"Remove featured workflows from a channel.","description":"Remove featured workflows from a channel.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel_id":{"type":"string","description":"Channel to remove featured workflow from.","required":true},"trigger_ids":{"type":"string","description":"Comma-separated array of trigger IDs to remove; max 15","required":true}}},"example":{"channel_id":"","trigger_ids":""}}}}}},"/workflows.featured.set":{"post":{"tags":["Workflows Featured"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/workflows.featured.set","api_endpoint":"https://slack.com/api/workflows.featured.set"},"summary":"Set featured workflows for a channel.","description":"Set featured workflows for a channel.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel_id":{"type":"string","description":"Channel to set featured workflows in.","required":true},"trigger_ids":{"type":"string","description":"Comma-separated array of trigger IDs that will replace any existing featured workflows in the channel; max 15","required":true}}},"example":{"channel_id":"","trigger_ids":""}}}}}},"/workflows.triggers.permissions.add":{"post":{"tags":["Workflows Triggers Permissions"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/workflows.triggers.permissions.add","api_endpoint":"https://slack.com/api/workflows.triggers.permissions.add"},"summary":"Allows users to run a trigger that has its permission type set to named_entities","description":"Allows users to run a trigger that has its permission type set to named_entities","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel_ids":{"type":"string","description":"List of encoded channel IDs"},"org_ids":{"type":"string","description":"List of encoded organization IDs"},"team_ids":{"type":"string","description":"List of encoded workspace IDs"},"trigger_id":{"type":"string","description":"Encoded ID of the trigger","required":true},"user_ids":{"type":"string","description":"List of encoded user IDs"}}},"example":{"channel_ids":"","org_ids":"","team_ids":"","trigger_id":"","user_ids":""}}}}}},"/workflows.triggers.permissions.list":{"post":{"tags":["Workflows Triggers Permissions"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/workflows.triggers.permissions.list","api_endpoint":"https://slack.com/api/workflows.triggers.permissions.list"},"summary":"Returns the permission type of a trigger and if applicable, includes the entities that have been granted access","description":"Returns the permission type of a trigger and if applicable, includes the entities that have been granted access","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"trigger_id":{"type":"string","description":"Encoded ID of the trigger","required":true}}},"example":{"trigger_id":""}}}}}},"/workflows.triggers.permissions.remove":{"post":{"tags":["Workflows Triggers Permissions"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/workflows.triggers.permissions.remove","api_endpoint":"https://slack.com/api/workflows.triggers.permissions.remove"},"summary":"Revoke an entity's access to a trigger that has its permission type set to named_entities","description":"Revoke an entity's access to a trigger that has its permission type set to named_entities","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel_ids":{"type":"string","description":"List of encoded channel IDs"},"org_ids":{"type":"string","description":"List of encoded organization IDs"},"team_ids":{"type":"string","description":"List of encoded workspace IDs"},"trigger_id":{"type":"string","description":"Encoded ID of the trigger","required":true},"user_ids":{"type":"string","description":"List of encoded user IDs"}}},"example":{"channel_ids":"","org_ids":"","team_ids":"","trigger_id":"","user_ids":""}}}}}},"/workflows.triggers.permissions.set":{"post":{"tags":["Workflows Triggers Permissions"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/workflows.triggers.permissions.set","api_endpoint":"https://slack.com/api/workflows.triggers.permissions.set"},"summary":"Set the permission type for who can run a trigger","description":"Set the permission type for who can run a trigger","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel_ids":{"type":"string","description":"List of encoded channel IDs"},"org_ids":{"type":"string","description":"List of encoded organization IDs"},"permission_type":{"type":"string","description":"The type of permission that defines who can run a trigger Acceptable values: everyone appcollaborators namedentities","required":true},"team_ids":{"type":"string","description":"List of encoded workspace IDs"},"trigger_id":{"type":"string","description":"Encoded ID of the trigger","required":true},"user_ids":{"type":"string","description":"List of encoded user IDs"}}},"example":{"channel_ids":"","org_ids":"","permission_type":"","team_ids":"","trigger_id":"","user_ids":""}}}}}},"/agents.conversations.create":{"post":{"tags":["Agents Conversations"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/agents.conversations.create","api_endpoint":"https://slack.com/api/agents.conversations.create"},"summary":"Create an agent session channel","description":"Creates a code channel for an agent session; the calling bot becomes the channel's agent and is auto-invited. Agent session code channel — requires a granular bot token with code_channels:manage; user tokens are rejected.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"is_private":{"type":"boolean","description":"Creates a private channel instead of a public one","enum":[true,false]},"name":{"type":"string","description":"Display name for the code channel (required unless origin_channel_id + origin_message_ts given)","required":true},"origin_channel_id":{"type":"string","description":"Channel where the session started; must accompany origin_message_ts"},"origin_message_ts":{"type":"string","description":"Timestamp of the triggering message; its author is auto-invited"},"session_id":{"type":"string","description":"Opaque session identifier; makes the call idempotent"},"team_id":{"type":"string","description":"Team/workspace ID to create the channel in (required for org tokens without origin)"}}},"example":{"is_private":"","name":"","origin_channel_id":"","origin_message_ts":"","session_id":"","team_id":""}}}}}},"/agents.conversations.archive":{"post":{"tags":["Agents Conversations"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/agents.conversations.archive","api_endpoint":"https://slack.com/api/agents.conversations.archive"},"summary":"Archive an agent session channel","description":"Archives a code channel. Agent session code channel — requires a granular bot token with code_channels:manage; user tokens are rejected.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel_id":{"type":"string","description":"ID of the code channel to archive","required":true},"summary_message_ts":{"type":"string","description":"Timestamp of a message to share back as a thread reply on the origin message"}}},"example":{"channel_id":"","summary_message_ts":""}}}}}},"/agents.conversations.getCanvas":{"post":{"tags":["Agents Conversations"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/agents.conversations.getCanvas","api_endpoint":"https://slack.com/api/agents.conversations.getCanvas"},"summary":"Get an agent session canvas with comments","description":"Returns canvas content as markdown plus up to the 100 most recent comment threads. Agent session code channel — requires a granular bot token with code_channels:manage; user tokens are rejected.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"canvas_id":{"type":"string","description":"Encoded ID of the canvas to fetch","required":true},"channel":{"type":"string","description":"ID of the agent session channel the canvas belongs to","required":true},"content_format":{"type":"string","description":"Render format for canvas content; defaults to markdown"},"include_resolved":{"type":"boolean","description":"Whether resolved comment threads are included; defaults to false","enum":[true,false]}}},"example":{"canvas_id":"","channel":"","content_format":"","include_resolved":""}}}}}},"/agents.conversations.listViews":{"post":{"tags":["Agents Conversations"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/agents.conversations.listViews","api_endpoint":"https://slack.com/api/agents.conversations.listViews"},"summary":"List views in an agent session channel","description":"Lists the views (up to 5) in a code channel across html, diff, block_kit and canvas types. Agent session code channel — requires a granular bot token with code_channels:manage; user tokens are rejected.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel_id":{"type":"string","description":"ID of the code channel whose views should be listed","required":true}}},"example":{"channel_id":""}}}}}},"/agents.conversations.removeView":{"post":{"tags":["Agents Conversations"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/agents.conversations.removeView","api_endpoint":"https://slack.com/api/agents.conversations.removeView"},"summary":"Remove a view from an agent session channel","description":"Removes a view from a code channel; supply exactly one of view_key or view_id. Agent session code channel — requires a granular bot token with code_channels:manage; user tokens are rejected.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel_id":{"type":"string","description":"ID of the code channel the view will be removed from","required":true},"view_id":{"type":"string","description":"Encoded channel tab ID of the view"},"view_key":{"type":"string","description":"Agent-assigned key of the view"}}},"example":{"channel_id":"","view_id":"","view_key":""}}}}}},"/agents.conversations.setCanvasContent":{"post":{"tags":["Agents Conversations"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/agents.conversations.setCanvasContent","api_endpoint":"https://slack.com/api/agents.conversations.setCanvasContent"},"summary":"Replace an agent session canvas content","description":"Replaces canvas content with new markdown; Slack applies only the minimal set of section-level edits. Agent session code channel — requires a granular bot token with code_channels:manage; user tokens are rejected.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"canvas_id":{"type":"string","description":"Encoded ID of the canvas whose content to replace","required":true},"channel":{"type":"string","description":"ID of the agent session channel the canvas is attached to","required":true},"content":{"type":"string","description":"Full new canvas content as markdown","required":true}}},"example":{"canvas_id":"","channel":"","content":""}}}}}},"/agents.conversations.setCommands":{"post":{"tags":["Agents Conversations"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/agents.conversations.setCommands","api_endpoint":"https://slack.com/api/agents.conversations.setCommands"},"summary":"Register commands for an agent session channel","description":"Registers the calling agent's commands for a code channel, replacing its previously registered set (max 10 per channel). Agent session code channel — requires a granular bot token with code_channels:manage; user tokens are rejected.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"channel_id":{"type":"string","description":"ID of the code channel to register commands for","required":true},"commands":{"type":"array","description":"Full set of commands to register; an empty array clears the agent's commands","required":true,"items":{"type":"object","properties":{"description":{"type":"string","description":"What the command does, shown in the UI"},"name":{"type":"string","description":"Command name; must be unique and must not collide with builtin Slack commands"}}}}}},"example":{"channel_id":"","commands":[]}}}}}},"/agents.conversations.setProperties":{"post":{"tags":["Agents Conversations"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/agents.conversations.setProperties","api_endpoint":"https://slack.com/api/agents.conversations.setProperties"},"summary":"Set properties on an agent session channel","description":"Sets properties on a code channel (partial update; title/status are deprecated in favor of agents.sessions methods). Agent session code channel — requires a granular bot token with code_channels:manage; user tokens are rejected.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"agent_resource":{"type":"object","description":"Agent resource properties to set; only provided fields change"},"channel_id":{"type":"string","description":"ID of the code channel to update","required":true},"code_channel":{"type":"object","description":"Code channel properties to set; only provided fields change"},"status":{"type":"string","description":"New session status: active, processing, suspended or closed (being deprecated)"},"title":{"type":"string","description":"New display title for the agent session (being deprecated)"}}},"example":{"agent_resource":{},"channel_id":"","code_channel":{},"status":"","title":""}}}}}},"/agents.conversations.setView":{"post":{"tags":["Agents Conversations"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/agents.conversations.setView","api_endpoint":"https://slack.com/api/agents.conversations.setView"},"summary":"Create or update a view in an agent session channel","description":"Upserts a view (html, diff, block_kit, canvas or pull_request) in a code channel; view_key is the upsert key. Agent session code channel — requires a granular bot token with code_channels:manage; user tokens are rejected.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"type":{"type":"string","description":"Kind of view: html, diff, block_kit, canvas or pull_request (default html)"},"access_level":{"type":"string","description":"For canvas views: channel access level — read, write or comment"},"agent_content_hash":{"type":"string","description":"Hash of the canvas-derived markdown the agent last wrote"},"base_branch":{"type":"string","description":"For diff views: base branch name for display purposes"},"blocks":{"type":"array","description":"Block Kit blocks for the view tab; required when type is block_kit","items":{"type":"object","properties":{"type":{"type":"string","description":"Block type (e.g. section, actions, input)"}}}},"canvas_id":{"type":"string","description":"Encoded ID of the canvas to attach as the view; required when type is canvas"},"channel_id":{"type":"string","description":"ID of the code channel to render the view in","required":true},"content":{"type":"string","description":"View content (full HTML doc for html; raw unified diff for diff); capped at 1,000,000 bytes"},"csp":{"type":"object","description":"CSP domain declarations for the view (resource_domains, connect_domains)"},"head_branch":{"type":"string","description":"For diff views: head branch name for display purposes"},"label":{"type":"string","description":"Deprecated alias for name"},"name":{"type":"string","description":"Display label for the view tab"},"pr_url":{"type":"string","description":"The pull request URL; required when type is pull_request"},"view_key":{"type":"string","description":"Agent-assigned stable identity for the view; required for html/block_kit/canvas"}}},"example":{"type":"","access_level":"","agent_content_hash":"","base_branch":"","blocks":[],"canvas_id":"","channel_id":"","content":"","csp":{},"head_branch":"","label":"","name":"","pr_url":"","view_key":""}}}}}},"/canvases.getContent":{"post":{"tags":["Canvases"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/canvases.getContent","api_endpoint":"https://slack.com/api/canvases.getContent"},"summary":"Get canvas content","description":"Returns the full canvas content in a single content field (markdown by default, or html). Works with bot and user tokens.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"canvas_id":{"type":"string","description":"Encoded ID of the canvas (e.g. F1234ABCD)","required":true},"content_type":{"type":"string","description":"Format for the returned content: markdown (default) or html"}}},"example":{"canvas_id":"","content_type":""}}}}}},"/team.externalTeams.disconnect":{"post":{"tags":["Team ExternalTeams"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/team.externalTeams.disconnect","api_endpoint":"https://slack.com/api/team.externalTeams.disconnect"},"summary":"Disconnect an external organization.","description":"Disconnect an external organization.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/team.externalTeams.list":{"get":{"tags":["Team ExternalTeams"],"parameters":[{"name":"connection_status_filter","in":"query","description":"Status of the connected team. Acceptable values: CONNECTED DISCONNECTED BLOCKED INREVIEW","schema":{"type":"string","example":""}},{"name":"cursor","in":"query","description":"Paginate through collections of data by setting parameter to the teamid attribute returned by a previous request's responsemetadata. If not provided, the first page of the collection is returned. See pagination for more detail.","schema":{"type":"string","example":""}},{"name":"limit","in":"query","description":"The maximum number of items to return per page Default: 20","schema":{"type":"number","example":""}},{"name":"slack_connect_pref_filter","in":"query","description":"Filters connected orgs by Slack Connect pref override(s). Value can be: approvedorgsonly allowscfileuploads profilevisibility awayteamscinvitepermissions acceptscinvites scmpdmtoprivate requirescchannelforscdm externalawarenesscontextbar","schema":{"type":"string","example":""}},{"name":"sort_direction","in":"query","description":"Direction to sort in asc or desc Default: asc Acceptable values: asc desc","schema":{"type":"string","example":""}},{"name":"sort_field","in":"query","description":"Name of the parameter that we are sorting by Default: teamname Acceptable values: teamname lastactivetimestamp connectionstatus","schema":{"type":"string","example":""}},{"name":"workspace_filter","in":"query","description":"Shows connected orgs which are connected on a specified encoded workspace ID","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.slack.dev/reference/methods/team.externalTeams.list","api_endpoint":"https://slack.com/api/team.externalTeams.list"},"summary":"Returns a list of all the external teams connected and details about the connection.","description":"Returns a list of all the external teams connected and details about the connection.","security":[{"bearerAuth":[]}]}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"security":[{"bearerAuth":[]}]}