{
  "opencollection": "1.0.0",
  "info": {
    "name": "MagicBell apns slack API",
    "version": "2.0.0"
  },
  "items": [
    {
      "info": {
        "name": "slack",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "get_slack_tokens",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.magicbell.com/v2/channels/slack/tokens",
            "params": [
              {
                "name": "page[size]",
                "value": "",
                "type": "query"
              },
              {
                "name": "page[after]",
                "value": "",
                "type": "query"
              },
              {
                "name": "page[before]",
                "value": "",
                "type": "query"
              }
            ]
          },
          "docs": "Lists all slack tokens belonging to the authenticated user. Returns a paginated list of tokens, including their status, creation dates, and associated metadata."
        },
        {
          "info": {
            "name": "save_slack_token",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.magicbell.com/v2/channels/slack/tokens",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Saves a slack token for the authenticated user. This token serves as a credential for accessing channel-specific functionality. Each token is unique to the user and channel combination, allowing for direct communication with the user via the channel."
        },
        {
          "info": {
            "name": "get_slack_token",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.magicbell.com/v2/channels/slack/tokens/:token_id",
            "params": [
              {
                "name": "token_id",
                "value": "",
                "type": "path"
              }
            ]
          },
          "docs": "Retrieves details of a specific slack token belonging to the authenticated user. Returns information about the token's status, creation date, and any associated metadata. Users can only access their own tokens."
        },
        {
          "info": {
            "name": "discard_slack_token",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://api.magicbell.com/v2/channels/slack/tokens/:token_id",
            "params": [
              {
                "name": "token_id",
                "value": "",
                "type": "path"
              }
            ]
          },
          "docs": "Revokes one of the authenticated user's slack tokens. This permanently invalidates the specified token, preventing it from being used for future channel access. This action cannot be undone. Users can only revoke their own tokens."
        },
        {
          "info": {
            "name": "get_slack_integration",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.magicbell.com/v2/integrations/slack"
          },
          "docs": "Retrieves the current slack integration configurations for a specific integration type in the project. Returns configuration details and status information."
        },
        {
          "info": {
            "name": "save_slack_integration",
            "type": "http"
          },
          "http": {
            "method": "PUT",
            "url": "https://api.magicbell.com/v2/integrations/slack",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Creates or updates a slack integration for the project. Only administrators can configure integrations."
        },
        {
          "info": {
            "name": "delete_slack_integration",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://api.magicbell.com/v2/integrations/slack"
          },
          "docs": "Removes a slack integration configuration from the project. This will disable the integration's functionality within the project."
        },
        {
          "info": {
            "name": "save_slack_installation",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.magicbell.com/v2/integrations/slack/installations",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Creates a new installation of a slack integration for a user. This endpoint is used when an integration needs to be set up with user-specific credentials or configuration."
        },
        {
          "info": {
            "name": "finish_slack_installation",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.magicbell.com/v2/integrations/slack/installations/finish",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Completes the installation flow for a slack integration. This endpoint is typically called after the user has completed any required authorization steps with slack."
        },
        {
          "info": {
            "name": "start_slack_installation",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.magicbell.com/v2/integrations/slack/installations/start",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Initiates the installation flow for a slack integration. This is the first step in a multi-step installation process where user authorization or external service configuration may be required."
        },
        {
          "info": {
            "name": "delete_slack_integration_by_id",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://api.magicbell.com/v2/integrations/slack/:id",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path"
              }
            ]
          },
          "docs": "Removes a specific slack integration instance by ID from the project."
        },
        {
          "info": {
            "name": "get_slack_user_tokens",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.magicbell.com/v2/users/:user_id/channels/slack/tokens",
            "params": [
              {
                "name": "user_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "page[size]",
                "value": "",
                "type": "query"
              },
              {
                "name": "page[after]",
                "value": "",
                "type": "query"
              },
              {
                "name": "page[before]",
                "value": "",
                "type": "query"
              }
            ]
          },
          "docs": "Lists all slack tokens associated with a specific user. This endpoint is available to project administrators and returns a paginated list of tokens, including both active and revoked tokens."
        },
        {
          "info": {
            "name": "get_slack_user_token",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.magicbell.com/v2/users/:user_id/channels/slack/tokens/:token_id",
            "params": [
              {
                "name": "user_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "token_id",
                "value": "",
                "type": "path"
              }
            ]
          },
          "docs": "Retrieves a specific slack token by its ID for a given user. This endpoint is available to project administrators and requires project-level authentication. Use this to inspect token details including its status, creation date, and associated metadata."
        },
        {
          "info": {
            "name": "discard_slack_user_token",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://api.magicbell.com/v2/users/:user_id/channels/slack/tokens/:token_id",
            "params": [
              {
                "name": "user_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "token_id",
                "value": "",
                "type": "path"
              }
            ]
          },
          "docs": "Revokes a specific user's slack token. This endpoint is available to project administrators and permanently invalidates the specified token. Once revoked, the token can no longer be used to access channel features. This action cannot be undone."
        }
      ]
    }
  ],
  "bundled": true
}