slack-objects
A focused Python package for working with Slack objects commonly used in administration and automation workflows.
slack-objects provides opinionated, testable wrappers around the Slack Web API, Admin API, and SCIM API—favoring object-based access over raw endpoint calls.
Supported Slack Objects
The following Slack object types are supported:
- Users
- Conversations (e.g, channels)
- Messages
- Files
- Workspaces
- IDP Groups (SCIM - e.g., Okta groups)
Overview
slack-objects is designed for:
- Slack administration automation
- Identity and access management (IAM) workflows
- Internal tooling and bots
- Auditing and cleanup scripts
This package is not a replacement for slack_sdk.
Instead, it focuses on higher-level object operations that typically require:
- multiple API calls
- pagination
- rate limiting
- Admin API or SCIM usage
- non-trivial orchestration logic
Design Highlights
Factory-based API
All object helpers are created from a single entry point:
from slack_objects.client import SlackObjectsClient
slack = SlackObjectsClient(cfg)
users = slack.users()
alice = slack.users("U123")
conversations = slack.conversations()
general = slack.conversations("C123")
This avoids global state while keeping usage concise and consistent.
Explicit token model
Slack APIs have different authorization requirements. This package keeps tokens explicit and separate:
| Token | Used for |
|---|---|
bot_token |
Slack Web API (most read/write operations) |
user_token |
Slack Admin API |
scim_token |
Slack SCIM API (IdP / provisioning) |
Tokens are optional in configuration, but required by methods that need them. Errors are raised at call time with clear messages.
Strict method boundaries
Each object follows a consistent internal structure:
public method
→ wrapper method
→ SlackApiCaller / SCIM request
Keyword-only APIs
Methods with multiple optional parameters use keyword-only arguments to avoid ambiguity and future breaking changes.
Testability
The codebase is designed to be tested without hitting Slack.
Installation
pip install slack-objects
Configuration
from slack_objects.config import SlackObjectsConfig, RateTier
cfg = SlackObjectsConfig(
bot_token="xoxb-...",
user_token="xoxp-...",
scim_token="xoxp-...",
default_rate_tier=RateTier.TIER_3,
)
Testing
Run all smoke tests:
python -m tests.run_all_smoke
Notes
- SCIM v1 is the default; v2 is supported where applicable
- Guest expiration dates use
PC_Utils.Datetimeif installed - This package is intended for automation and administration workflows
Metadata
Release files for slack-objects 0.0.post34
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| slack_objects-0.0.post34.tar.gz | 115.9 kB | Without provenance | Details for slack_objects-0.0.post34.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| slack_objects-0.0.post34-py3-none-any.whl | Python 3 | none | any | Details for slack_objects-0.0.post34-py3-none-any.whl |
Total release size: 146.2 kB
Release files / slack_objects-0.0.post34.tar.gz
| Download URL | slack_objects-0.0.post34.tar.gz |
|---|---|
| Size | 115.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
820135ace2a1e39b323027123814c4e1433b8e38eb163694ac65f3f7d291e4f9
|
|
BLAKE2b-256 checksum How to use checksums |
d959d9f65708306c88ee5ec979f9bd33f74fcf61c91a707151003692bf723015
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.2
|
Release files / slack_objects-0.0.post34-py3-none-any.whl
| Download URL | slack_objects-0.0.post34-py3-none-any.whl |
|---|---|
| Size | 30.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
32096d0befd5efbea01e311b22536201c99b06178b9a52a248d6db2843980f65
|
|
BLAKE2b-256 checksum How to use checksums |
db3f6f081c872a4e1ac134dd90fe42c2575ecf343e3e2557a3e0e561b4bb80dd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.2
|
Security for slack-objects 0.0.post34
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.