links

Author: lukegalbraithrussell

docs/english/audit-logs.md

@@ -1,6 +1,6 @@
 # Audit Logs API client
 
-The [Audit Logs API](https://docs.slack.dev/admins/audit-logs-api) is a set of APIs that you can use to monitor what's happening in your [Enterprise Grid](https://docs.slack.dev/enterprise-grid) organization.
+The [Audit Logs API](/admins/audit-logs-api) is a set of APIs that you can use to monitor what's happening in your [Enterprise Grid](/enterprise-grid) organization.
 
 The Audit Logs API can be used by Security Information and Event Management (SIEM) tools to provide an analysis of how your Slack organization is being accessed. You can also use this API to write your own apps to see how members of your organization are using Slack.
 
@@ -10,11 +10,11 @@ You'll need a valid token in order to use the Audit Logs API. In addition, the S
 
 ## AuditLogsClient {#auditlogsclient}
 
-An OAuth token with [the admin scope](https://docs.slack.dev/reference/scopes/admin) is required to access this API.
+An OAuth token with [the admin scope](/reference/scopes/admin) is required to access this API.
 
 You'll likely use the `/logs` endpoint as it's the essential part of this API.
 
-To learn about the available parameters for this endpoint, check out [using the Audit Logs API](https://docs.slack.dev/admins/audit-logs-api). You can also learn more about the data structure of `api_response.typed_body` from [the class source code](https://github.com/slackapi/python-slack-sdk/blob/main/slack_sdk/audit_logs/v1/logs.py).
+To learn about the available parameters for this endpoint, check out [using the Audit Logs API](/admins/audit-logs-api). You can also learn more about the data structure of `api_response.typed_body` from [the class source code](https://github.com/slackapi/python-slack-sdk/blob/main/slack_sdk/audit_logs/v1/logs.py).
 
 ``` python
 import os

docs/english/installation.md

@@ -41,7 +41,7 @@ It's also good to try on the Python REPL.
 
 ## Access tokens {#handling-tokens}
 
-Making calls to the Slack API often requires a [token](https://docs.slack.dev/authentication/tokens) with associated scopes that grant access to resources. Collecting a token can be done from app settings or with an OAuth installation depending on your app's requirements.
+Making calls to the Slack API often requires a [token](/authentication/tokens) with associated scopes that grant access to resources. Collecting a token can be done from app settings or with an OAuth installation depending on your app's requirements.
 
 **Always keep your access tokens safe.**
 
@@ -69,21 +69,21 @@ import os
 SLACK_BOT_TOKEN = os.environ["SLACK_BOT_TOKEN"]
 ```
 
-Refer to our [best practices for security](https://docs.slack.dev/authentication/best-practices-for-security) page for more information.
+Refer to our [best practices for security](/authentication/best-practices-for-security) page for more information.
 
 ## Installing on a single workspace {#single-workspace}
 
 If you're building an application for a single Slack workspace, there's no need to build out the entire OAuth flow. Once you've set up your features, click the **Install App to Team** button on the **Install App** page. If you add new permission scopes or Slack app features after an app has been installed, you must reinstall the app to your workspace for the changes to take effect.
 
-Refer to the [quickstart](https://docs.slack.dev/quickstart) guide for more details.
+Refer to the [Slack quickstart](/quickstart) guide for more details.
 
 ## Installing on multiple workspaces {#multi-workspace}
 
-If you intend for an app to be installed on multiple Slack workspaces, you will need to handle this installation via the industry-standard OAuth protocol. Read more about [installing with OAuth](https://docs.slack.dev/authentication/installing-with-oauth).
+If you intend for an app to be installed on multiple Slack workspaces, you will need to handle this installation via the industry-standard OAuth protocol. Read more about [installing with OAuth](/authentication/installing-with-oauth).
 
 The OAuth exchange is facilitated via HTTP and requires a webserver; in this example, we'll use [Flask](https://flask.palletsprojects.com/).
 
-To configure your app for OAuth, you'll need a client ID, a client secret, and a set of one or more scopes that will be applied to the token once it is granted. The client ID and client secret are available from the [app page](https://api.slack.com/apps). The scopes are determined by the functionality of the app — every method you wish to access has a corresponding scope, and your app will need to request that scope in order to be able to access the method. Review the full list of [OAuth scopes](https://docs.slack.dev/reference/scopes).
+To configure your app for OAuth, you'll need a client ID, a client secret, and a set of one or more scopes that will be applied to the token once it is granted. The client ID and client secret are available from the [app page](https://api.slack.com/apps). The scopes are determined by the functionality of the app — every method you wish to access has a corresponding scope, and your app will need to request that scope in order to be able to access the method. Review the full list of [OAuth scopes](/reference/scopes).
 
 ```python
 import os
@@ -115,7 +115,7 @@ def pre_install():
 
 ### The OAuth completion page {#oauth-completion}
 
-Once the user has agreed to the permissions you've requested, Slack will redirect the user to your auth completion page, which includes a `code` query string parameter. You'll use the `code` parameter to call the [`oauth.v2.access`](https://docs.slack.dev/reference/methods/oauth.v2.access) API method that will grant you the token.
+Once the user has agreed to the permissions you've requested, Slack will redirect the user to your auth completion page, which includes a `code` query string parameter. You'll use the `code` parameter to call the [`oauth.v2.access`](/reference/methods/oauth.v2.access) API method that will grant you the token.
 
 ```python
 @app.route("/slack/oauth_redirect", methods=["GET"])

docs/english/legacy/auth.md

@@ -31,21 +31,21 @@ import os
 SLACK_BOT_TOKEN = os.environ["SLACK_BOT_TOKEN"]
 ```
 
-Refer to our [best practices for security](https://docs.slack.dev/authentication/best-practices-for-security) page for more information.
+Refer to our [best practices for security](/authentication/best-practices-for-security) page for more information.
 
 ## Installing on a single workspace {#single-workspace}
 
 If you're building an application for a single Slack workspace, there's no need to build out the entire OAuth flow. Once you've set up your features, click the **Install App to Team** button on the **Install App** page. If you add new permission scopes or Slack app features after an app has been installed, you must reinstall the app to your workspace for the changes to take effect.
 
-Refer to the [quickstart](https://docs.slack.dev/quickstart) guide for more details.
+Refer to the [quickstart](/quickstart) guide for more details.
 
 ## Installing on multiple workspaces {#multi-workspace}
 
-If you intend for an app to be installed on multiple Slack workspaces, you will need to handle this installation via the industry-standard OAuth protocol. Read more about [installing with OAuth](https://docs.slack.dev/authentication/installing-with-oauth).
+If you intend for an app to be installed on multiple Slack workspaces, you will need to handle this installation via the industry-standard OAuth protocol. Read more about [installing with OAuth](/authentication/installing-with-oauth).
 
 The OAuth exchange is facilitated via HTTP and requires a webserver; in this example, we'll use [Flask](https://flask.palletsprojects.com/).
 
-To configure your app for OAuth, you'll need a client ID, a client secret, and a set of one or more scopes that will be applied to the token once it is granted. The client ID and client secret are available from the [app page](https://api.slack.com/apps). The scopes are determined by the functionality of the app — every method you wish to access has a corresponding scope, and your app will need to request that scope in order to be able to access the method. Review the full list of [OAuth scopes](https://docs.slack.dev/reference/scopes).
+To configure your app for OAuth, you'll need a client ID, a client secret, and a set of one or more scopes that will be applied to the token once it is granted. The client ID and client secret are available from the [app page](https://api.slack.com/apps). The scopes are determined by the functionality of the app — every method you wish to access has a corresponding scope, and your app will need to request that scope in order to be able to access the method. Review the full list of [OAuth scopes](/reference/scopes).
 
 ``` python
 import os
@@ -77,7 +77,7 @@ def pre_install():
 
 ### The OAuth completion page {#oauth-completion}
 
-Once the user has agreed to the permissions you've requested, Slack will redirect the user to your auth completion page, which includes a `code` query string parameter. You'll use the `code` parameter to call the [`oauth.v2.access`](https://docs.slack.dev/reference/methods/oauth.v2.access) API method that will grant you the token.
+Once the user has agreed to the permissions you've requested, Slack will redirect the user to your auth completion page, which includes a `code` query string parameter. You'll use the `code` parameter to call the [`oauth.v2.access`](/reference/methods/oauth.v2.access) API method that will grant you the token.
 
 ``` python
 @app.route("/slack/oauth_redirect", methods=["GET"])

docs/english/legacy/basic_usage.md

@@ -8,9 +8,9 @@ The v3 SDK provides additional features such as Socket Mode, OAuth flow, SCIM AP
 
 The Slack Web API allows you to build applications that interact with Slack in more complex ways than the integrations we provide out of the box.
 
-Accessing Slack API methods requires an OAuth token — read more about [installing with OAuth](https://docs.slack.dev/authentication/installing-with-oauth).
+Accessing Slack API methods requires an OAuth token — read more about [installing with OAuth](/authentication/installing-with-oauth).
 
-Each of these [API methods](https://docs.slack.dev/reference/methods) is fully documented on our developer site at [docs.slack.dev](https://docs.slack.dev/).
+Each of these [API methods](/reference/methods) is fully documented on our developer site at [docs.slack.dev](/).
 
 ## Sending a message {#sending-messages}
 
@@ -53,13 +53,13 @@ response = client.chat_postEphemeral(
 )
 ```
 
-See the [`chat.postEphemeral`](https://docs.slack.dev/reference/methods/chat.postephemeral) API method for more details.
+See the [`chat.postEphemeral`](/reference/methods/chat.postephemeral) API method for more details.
 
 ## Formatting messages with Block Kit {#block-kit}
 
-Messages posted from apps can contain more than just text; they can also include full user interfaces composed of blocks using [Block Kit](https://docs.slack.dev/block-kit).
+Messages posted from apps can contain more than just text; they can also include full user interfaces composed of blocks using [Block Kit](/block-kit).
 
-The [`chat.postMessage method`](https://docs.slack.dev/reference/methods/chat.postmessage) takes an optional blocks argument that allows you to customize the layout of a message. Blocks are specified in a single object literal, so just add additional keys for any optional argument.
+The [`chat.postMessage method`](/reference/methods/chat.postmessage) takes an optional blocks argument that allows you to customize the layout of a message. Blocks are specified in a single object literal, so just add additional keys for any optional argument.
 
 To send a message to a channel, use the channel's ID. For DMs, use the user's ID.
 
@@ -135,7 +135,7 @@ When appearing in the channel, it won't contain any attachments or message butto
 
 :::
 
-Refer to the [threading messages](https://docs.slack.dev/messaging#threading) page for more information.
+Refer to the [threading messages](/messaging#threading) page for more information.
 
 ## Updating a message {#updating-messages}
 
@@ -149,7 +149,7 @@ response = client.chat_update(
 )
 ```
 
-See the [`chat.update`](https://docs.slack.dev/reference/methods/chat.update) API method for formatting options and some special considerations when calling this with a bot user.
+See the [`chat.update`](/reference/methods/chat.update) API method for formatting options and some special considerations when calling this with a bot user.
 
 ## Deleting a message {#deleting-messages}
 
@@ -162,7 +162,7 @@ response = client.chat_delete(
 )
 ```
 
-See the [`chat.delete`](https://docs.slack.dev/reference/methods/chat.delete) API method for more
+See the [`chat.delete`](/reference/methods/chat.delete) API method for more
 details.
 
 ## Opening a modal {#opening-modals}
@@ -244,7 +244,7 @@ if __name__ == "__main__":
   app.run("localhost", 3000)
 ```
 
-See the [`views.open`](https://docs.slack.dev/reference/methods/views.open) API method more details and additional parameters.
+See the [`views.open`](/reference/methods/views.open) API method more details and additional parameters.
 
 To run the above example, the following [app configurations](https://api.slack.com/apps) are required:
 
@@ -294,9 +294,9 @@ response = client.views_update(
 )
 ```
 
-See the [`views.update`](https://docs.slack.dev/reference/methods/views.update) API method for more details.
+See the [`views.update`](/reference/methods/views.update) API method for more details.
 
-If you want to push a new view onto the modal instead of updating an existing view, see the [`views.push`](https://docs.slack.dev/reference/methods/views.push) API method.
+If you want to push a new view onto the modal instead of updating an existing view, see the [`views.push`](/reference/methods/views.push) API method.
 
 ## Emoji reactions {#emoji}
 
@@ -322,7 +322,7 @@ response = client.reactions_remove(
 )
 ```
 
-See the [`reactions.add`](https://docs.slack.dev/reference/methods/reactions.add) and [`reactions.remove`](https://docs.slack.dev/reference/methods/reactions.remove) API methods for more details.
+See the [`reactions.add`](/reference/methods/reactions.add) and [`reactions.remove`](/reference/methods/reactions.remove) API methods for more details.
 
 ## Listing public channels {#listing-public-channels}
 
@@ -338,7 +338,7 @@ Archived channels are included by default. You can exclude them by passing `excl
 response = client.conversations_list(exclude_archived=1)
 ```
 
-See the [`conversations.list`](https://docs.slack.dev/reference/methods/conversations.list) API method for more details.
+See the [`conversations.list`](/reference/methods/conversations.list) API method for more details.
 
 ## Getting a channel's info {#get-channel-info}
 
@@ -348,7 +348,7 @@ Once you have the ID for a specific channel, you can fetch information about tha
 response = client.conversations_info(channel="C0XXXXXXX")
 ```
 
-See the [`conversations.info`](https://docs.slack.dev/reference/methods/conversations.info) API method for more details.
+See the [`conversations.info`](/reference/methods/conversations.info) API method for more details.
 
 ## Joining a channel {#join-channel}
 
@@ -360,7 +360,7 @@ response = client.conversations_join(channel="C0XXXXXXY")
 
 If you are already in the channel, the response is slightly different. The `already_in_channel` attribute will be true, and a limited `channel` object will be returned. Bot users cannot join a channel on their own, they need to be invited by another user.
 
-See the [`conversations.join`](https://docs.slack.dev/reference/methods/conversations.join) API method for more details.
+See the [`conversations.join`](/reference/methods/conversations.join) API method for more details.
 
 ------------------------------------------------------------------------
 
@@ -372,7 +372,7 @@ Maybe you've finished up all the business you had in a channel, or maybe you joi
 response = client.conversations_leave(channel="C0XXXXXXX")
 ```
 
-See the [`conversations.leave`](https://docs.slack.dev/reference/methods/conversations.leave) API method for more details.
+See the [`conversations.leave`](/reference/methods/conversations.leave) API method for more details.
 
 ## Listing team members {#list-team-members}
 
@@ -382,7 +382,7 @@ users = response["members"]
 user_ids = list(map(lambda u: u["id"], users))
 ```
 
-See the [`users.list`](https://docs.slack.dev/reference/methods/users.list) API method for more details.
+See the [`users.list`](/reference/methods/users.list) API method for more details.
 
 ## Uploading files {#uploading-files}
 
@@ -394,7 +394,7 @@ response = client.files_upload_v2(
 )
 ```
 
-See the [`files.upload`](https://docs.slack.dev/reference/methods/files.upload) API method for more details.
+See the [`files.upload`](/reference/methods/files.upload) API method for more details.
 
 ## Calling API methods {#calling-API-methods}
 
@@ -414,7 +414,7 @@ assert response["message"]["text"] == "Hello world!"
 
 ## Rate limits {#rate-limits}
 
-When posting messages to a channel, Slack allows apps to send no more than one message per channel per second. We allow bursts over that limit for short periods; however, if your app continues to exceed the limit over a longer period of time, it will be rate limited. Different API methods have other limits — be sure to check the [rate limits](https://docs.slack.dev/apis/web-api/rate-limits) and test that your app has a graceful fallback if it should hit those limits.
+When posting messages to a channel, Slack allows apps to send no more than one message per channel per second. We allow bursts over that limit for short periods; however, if your app continues to exceed the limit over a longer period of time, it will be rate limited. Different API methods have other limits — be sure to check the [rate limits](/apis/web-api/rate-limits) and test that your app has a graceful fallback if it should hit those limits.
 
 If you go over these limits, Slack will begin returning *HTTP 429 Too Many Requests* errors, a JSON object containing the number of calls you have been making, and a *Retry-After* header containing the number of seconds until you can retry.
 
@@ -454,4 +454,4 @@ while True:
       raise e
 ```
 
-Refer to the [rate limits](https://docs.slack.dev/apis/web-api/rate-limits) page for more information.
+Refer to the [rate limits](/apis/web-api/rate-limits) page for more information.