# Is Slack giving you a headache?

You were probably searching for a fix for that obscure Slack error. But maybe you found something better.

Stop debugging. Start coordinating.

Qordinate acts as your intelligent layer between apps like Slack and your life. We handle the messy API connections and coordination so you can focus on what actually matters.

## Slack Integration Terminal Errors

### Authentication Errors

#### `invalid_auth`

```
Error: invalid_auth
{"ok":false,"error":"invalid_auth"}
```

Occurs when bot token is expired, revoked, or malformed. Terminal output shows HTTP 200 with error payload.

#### `not_authed`

```
Error: not_authed
{"ok":false,"error":"not_authed","response_metadata":{}}
```

API call made without authentication token or token missing from request headers.

#### `account_inactive`

```
Error: account_inactive
{"ok":false,"error":"account_inactive"}
```

Bot user account has been deactivated or workspace access revoked.

#### `token_expired`

```
SlackApiError: token_expired
    at SlackClient.postMessage (/node_modules/@slack/web-api/dist/WebClient.js:123:45)
```

OAuth access token expired. Refresh token required for renewal.

#### `missing_scope`

```
Error: missing_scope
{"ok":false,"error":"missing_scope","needed":"channels:read","provided":["chat:write"]}
```

Bot token lacks required OAuth scope. Terminal shows `needed` and `provided` scopes in error response.

### Rate Limiting Errors

#### `rate_limited`

```
Error: rate_limited
HTTP 429 Too Many Requests
Retry-After: 60
{"ok":false,"error":"rate_limited","retry_after":60}
```

Rate limit exceeded. Check `Retry-After` header value for seconds to wait.

#### `ratelimited`

```
SlackApiError: ratelimited
    at handlePlatformError (/slack-sdk/dist/errors.js:89:12)
```

SDK throws exception when rate limit hit. Requires exponential backoff implementation.

### API Request Errors

#### `invalid_arguments`

```
Error: invalid_arguments
{"ok":false,"error":"invalid_arguments","response_metadata":{"messages":["[ERROR] missing required field: channel"]}}
```

Request missing required parameters. Terminal shows specific missing fields in `messages` array.

#### `channel_not_found`

```
Error: channel_not_found
{"ok":false,"error":"channel_not_found"}
```

Channel ID or name doesn't exist or bot lacks access.

#### `not_in_channel`

```
Error: not_in_channel
{"ok":false,"error":"not_in_channel"}
```

Bot not member of channel. Must join channel before posting messages.

#### `message_too_long`

```
Error: message_too_long
{"ok":false,"error":"message_too_long"}
```

Message text exceeds 4000 character limit for chat.postMessage.

#### `invalid_blocks`

```
Error: invalid_blocks
{"ok":false,"error":"invalid_blocks","response_metadata":{"messages":["[ERROR] blocks[0].type must be one of: section, divider, image, actions, context, input, file, header, video, rich_text"]}}
```

Block Kit JSON structure invalid. Terminal shows specific validation errors.

### Webhook & Events API Errors

#### `invalid_request`

```
Error: invalid_request
HTTP 400 Bad Request
{"error":"invalid_request","error_description":"The request is missing a required parameter"}
```

Webhook request missing required parameters like `token`, `team_id`, or `api_app_id`.

#### `invalid_signature`

```
Error: invalid_signature
HTTP 401 Unauthorized
X-Slack-Signature: v0=abc123...
```

Webhook signature verification failed. Timestamp skew or incorrect signing secret.

#### `challenge_failed`

```
Error: challenge_failed
{"challenge":"3eZbrw1aBd2rqRg0TbGCM6","type":"url_verification"}
```

Events API URL verification challenge response incorrect or missing.

### SDK-Specific Errors

#### Python SDK: `slack.errors.SlackApiError`

```python
Traceback (most recent call last):
  File "slack_bot.py", line 45, in <module>
    response = client.chat_postMessage(channel="#general", text="Hello")
  File "/venv/lib/python3.9/site-packages/slack/web/client.py", line 234, in chat_postMessage
    raise SlackApiError(message=error, response=response)
slack.errors.SlackApiError: The request to the Slack API failed.
The server responded with: {'ok': False, 'error': 'invalid_auth'}
```

#### Node.js SDK: `Error [SlackAPIError]`

```javascript
Error [SlackAPIError]: An API error occurred: invalid_auth
    at WebClient.apiCall (/node_modules/@slack/web-api/dist/WebClient.js:185:25)
    at processTicksAndRejections (internal/process/task_queues.js:95:5)
```

#### Ruby SDK: `Slack::Web::Api::Errors::SlackError`

```ruby
Slack::Web::Api::Errors::SlackError: invalid_auth
  from /gems/slack-ruby-client-2.0.0/lib/slack/web/api/endpoints/chat.rb:45:in `postMessage'
```

#### Go SDK: `slack.SlackError`

```go
slack.SlackError: invalid_auth
    slack.(*Client).PostMessage(0xc0000a2000, 0xc0000b4000, 0x1234567)
        /go/pkg/mod/github.com/slack-go/slack@v0.12.0/chat.go:89
```

### WebSocket & RTM Errors

#### `invalid_auth` (RTM)

```
Error: invalid_auth
{"ok":false,"error":"invalid_auth","url":""}
```

RTM WebSocket connection fails authentication. No `url` returned in response.

#### `connection_closed`

```
Error: connection_closed
WebSocket connection closed unexpectedly
```

RTM WebSocket disconnects without close frame. Requires reconnection logic.

#### `socket_mode_connection_failed`

```
Error: socket_mode_connection_failed
Failed to establish Socket Mode WebSocket connection
```

Socket Mode WebSocket fails to connect. Check app-level token validity.

### File Upload Errors

#### `file_too_large`

```
Error: file_too_large
{"ok":false,"error":"file_too_large","max_size_bytes":1048576000}
```

File exceeds 1GB upload limit. Terminal shows `max_size_bytes` in error response.

#### `invalid_file_type`

```
Error: invalid_file_type
{"ok":false,"error":"invalid_file_type"}
```

File type not supported for upload. Check allowed MIME types.

#### `file_deleted`

```
Error: file_deleted
{"ok":false,"error":"file_deleted"}
```

File referenced by ID has been deleted from workspace.

### Pagination Errors

#### `invalid_cursor`

```
Error: invalid_cursor
{"ok":false,"error":"invalid_cursor"}
```

Pagination cursor expired or malformed. Cursors expire after 5 minutes.

#### `cursor_pagination_failed`

```
Error: cursor_pagination_failed
{"ok":false,"error":"cursor_pagination_failed","response_metadata":{"next_cursor":""}}
```

Pagination request fails. `next_cursor` empty string indicates no more pages.

### Interactive Components Errors

#### `action_not_found`

```
Error: action_not_found
{"ok":false,"error":"action_not_found"}
```

Interactive component action handler not registered or callback ID mismatch.

#### `interactive_timeout`

```
Error: interactive_timeout
{"ok":false,"error":"interactive_timeout"}
```

Interactive component response not sent within 3-second window.

#### `invalid_trigger_id`

```
Error: invalid_trigger_id
{"ok":false,"error":"invalid_trigger_id"}
```

Modal or interactive component `trigger_id` expired or already used.

### Workspace & Team Errors

#### `team_added_to_org`

```
Error: team_added_to_org
{"ok":false,"error":"team_added_to_org"}
```

Workspace added to Enterprise Grid organization. API behavior changes.

#### `restricted_action`

```
Error: restricted_action
{"ok":false,"error":"restricted_action"}
```

Action restricted by workspace admin settings or Enterprise Grid policies.

#### `enterprise_is_restricted`

```
Error: enterprise_is_restricted
{"ok":false,"error":"enterprise_is_restricted"}
```

Enterprise Grid restriction prevents API call execution.

### OAuth Flow Errors

#### `invalid_client_id`

```
Error: invalid_client_id
{"ok":false,"error":"invalid_client_id"}
```

OAuth client ID incorrect or app not found.

#### `invalid_code`

```
Error: invalid_code
{"ok":false,"error":"invalid_code"}
```

OAuth authorization code expired, already used, or invalid.

#### `invalid_redirect_uri`

```
Error: invalid_redirect_uri
{"ok":false,"error":"invalid_redirect_uri"}
```

OAuth redirect URI doesn't match registered redirect URLs in app settings.

### Connection & Network Errors

#### `request_timeout`

```
Error: request_timeout
TimeoutError: Request timed out after 30000ms
    at Timeout._onTimeout (/node_modules/axios/lib/adapters/http.js:201:15)
```

API request exceeds 30-second timeout. Network congestion or Slack service degradation.

#### `network_error`

```
Error: network_error
FetchError: request to https://api.slack.com/api/chat.postMessage failed, reason: getaddrinfo ENOTFOUND api.slack.com
```

DNS resolution failure or network connectivity issue.

#### `ssl_handshake_failed`

```
Error: ssl_handshake_failed
Error: SSL handshake failed: unable to verify the first certificate
    at TLSSocket.onConnectSecure (_tls_wrap.js:1515:34)
```

SSL/TLS certificate validation failure. Corporate proxy or certificate chain issues.

### Webhook Delivery Errors

#### `webhook_timeout`

```
Error: webhook_timeout
HTTP 504 Gateway Timeout
X-Slack-Retry-Num: 3
```

Webhook endpoint timeout after retry attempts. Check `X-Slack-Retry-Num` header.

#### `webhook_delivery_failed`

```
Error: webhook_delivery_failed
{"ok":false,"error":"webhook_delivery_failed","retry_after":300}
```

Webhook delivery failed after maximum retries. Manual event replay required.

### Miscellaneous Errors

#### `method_deprecated`

```
Error: method_deprecated
{"ok":false,"error":"method_deprecated","response_metadata":{"warnings":["method_deprecated"]}}
```

API method deprecated. Migration to newer API version required.

#### `internal_error`

```
Error: internal_error
{"ok":false,"error":"internal_error"}
```

Slack server-side error. Retry request after delay.

#### `service_unavailable`

```
Error: service_unavailable
HTTP 503 Service Unavailable
{"ok":false,"error":"service_unavailable"}
```

Slack service temporarily unavailable. Check status page.

#### `fatal_error`

```
Error: fatal_error
{"ok":false,"error":"fatal_error"}
```

Critical error preventing request processing. Contact Slack support.
