Menu
Use when academy staff need to connect Slack, run manual syncs, and monitor Slack sync health for students/cohorts; do NOT use for generic notifications or non-Slack messaging workflows.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Use when building or operating a staff frontend to list, schedule, sync, or recover academy GitHub organization memberships; do NOT use for Copilot seats, provisioning bills, or staff/student invites unrelated to GitHub org membership.
Load first for academy-scoped BreatheCode API work (/academy/, Academy header, staff capabilities). Maps requests to domain skills. Do NOT use for pure learner self-service without staff context — use breathecode-student-api-index instead.
Use when academy staff need to list or view certificate specialties, create or update academy-owned specialties, link a syllabus to a specialty, or assign a specialty to a student by issuing a certificate; do NOT use for listing a student's own certificates (use certificate me endpoint).
Use when an authenticated student needs to check LLM budget entitlement, list LiteLLM API keys and per-key spend, create a new LLM API key, or delete an existing key; do NOT use for academy staff configuring LiteLLM vendors or teams, VPS provisioning, or granting LLM budget through plans.
Load first for authenticated learner BreatheCode API work (user-scoped /me and user/me routes, public join/catalog where applicable). Maps requests to domain skills. Do NOT use for academy admin tasks requiring /academy/ or the Academy header — use breathecode-staff-api-index instead.
Use when academy staff need to set main currency and create, list, update, or deprecate checkout payment methods; do NOT use for Stripe credential setup when is_credit_card is true (use bc-payments-configure-academy-stripe first), student card save, or subscription cancel/refund.
| name | bc-notify-manage-academy-slackintegration |
| description | Use when academy staff need to connect Slack, run manual syncs, and monitor Slack sync health for students/cohorts; do NOT use for generic notifications or non-Slack messaging workflows. |
| requires | [] |
Use this skill when the user asks to connect an academy to Slack using manual credentials, manually sync Slack users/channels, or inspect sync status/errors/last sync times. Use it for team-level and individual student/cohort sync actions. Do NOT use it for email/SMS notifications, webhook subscriptions, or unrelated admissions operations.
name_normalized matches the cohort slug.GET /v1/notify/slack/team and filter by academy if needed.POST /v1/notify/academy/slack/team/<team_id>/credentials with a Slack bot token and metadata (team_name, optional app_id, bot_user_id, authed_user).GET /v1/notify/academy/slack/team/<team_id>/credentials and confirm configured=true.POST /v1/notify/academy/slack/team/<team_id>/sync/usersPOST /v1/notify/academy/slack/team/<team_id>/sync/channelsPOST /v1/notify/academy/slack/team/<team_id>/sync/user/<slack_user_id>POST /v1/notify/academy/slack/team/<team_id>/sync/cohort/<cohort_id>GET /v1/notify/academy/slack/team/<team_id>/sync/statusGET /v1/notify/academy/slack/team/<team_id>/sync/user/<slack_user_id>GET /v1/notify/academy/slack/team/<team_id>/sync/cohort/<cohort_id>/v1/admissions/academy/cohort/user)/v1/admissions/academy/cohort).| Action | Method | Path | Headers | Body | Response |
|---|---|---|---|---|---|
| List linked Slack teams | GET | /v1/notify/slack/team | Authorization | Query optional: academy=<slug> | Paginated list of Slack teams |
| Get team credentials status | GET | /v1/notify/academy/slack/team/<team_id>/credentials | Authorization, Academy: <academy_id> | — | configured boolean + metadata; token is never returned |
| Configure team credentials | POST/PUT | /v1/notify/academy/slack/team/<team_id>/credentials | Authorization, Academy: <academy_id> | token, optional team_name, app_id, bot_user_id, authed_user | 200 configured response |
| Trigger team users sync | POST | /v1/notify/academy/slack/team/<team_id>/sync/users | Authorization, Academy: <academy_id> | — | 202 accepted + metadata |
| Trigger team channels sync | POST | /v1/notify/academy/slack/team/<team_id>/sync/channels | Authorization, Academy: <academy_id> | — | 202 accepted + metadata |
| Trigger single user sync | POST | /v1/notify/academy/slack/team/<team_id>/sync/user/<slack_user_id> | Authorization, Academy: <academy_id> | — | 202 accepted + metadata |
| Get single user sync status | GET | /v1/notify/academy/slack/team/<team_id>/sync/user/<slack_user_id> | Authorization, Academy: <academy_id> | — | User-team sync status object |
| Trigger single cohort sync | POST | /v1/notify/academy/slack/team/<team_id>/sync/cohort/<cohort_id> | Authorization, Academy: <academy_id> | — | 202 accepted + metadata |
| Get single cohort sync status | GET | /v1/notify/academy/slack/team/<team_id>/sync/cohort/<cohort_id> | Authorization, Academy: <academy_id> | — | Cohort-channel sync status object |
| Get team sync status | GET | /v1/notify/academy/slack/team/<team_id>/sync/status | Authorization, Academy: <academy_id> | — | Team summary + users/channels counters |
| Manage cohort membership (source data) | GET/POST/PUT/DELETE | /v1/admissions/academy/cohort/user | Authorization, Academy: <academy_id> | Depends on method | Cohort-user assignment result |
| Manage cohorts/slugs (source data) | GET/POST/PUT | /v1/admissions/academy/cohort | Authorization, Academy: <academy_id> | Depends on method | Cohort object(s) |
Configure team credentials — request (POST /v1/notify/academy/slack/team/<team_id>/credentials):
{
"token": "xoxb-1234567890-abcdef",
"team_name": "4Geeks Academy",
"app_id": "A123456",
"bot_user_id": "U0BOT123",
"authed_user": "U0ADMIN123"
}
Credentials status — response (200):
{
"configured": true,
"team_id": "T01ABC",
"team_name": "4Geeks Academy",
"app_id": "A123456",
"bot_user_id": "U0BOT123",
"authed_user": "U0ADMIN123",
"updated_at": "2026-03-23T18:21:31.123Z"
}
Trigger team users sync — response (202):
{
"status": "accepted",
"sync_type": "users",
"team_id": 7
}
Trigger single user sync — response (202):
{
"status": "accepted",
"sync_type": "user",
"team_id": 7,
"slack_user_id": "U09ABC123"
}
Team sync status — response (200):
{
"id": 7,
"slack_id": "T01ABC",
"name": "4Geeks Academy",
"sync_status": "COMPLETED",
"sync_message": null,
"synqued_at": "2026-03-23T18:21:31.123Z",
"users": {
"total": 120,
"completed": 110,
"incompleted": 10,
"last_synqued_at": "2026-03-23T18:21:30.555Z"
},
"channels": {
"total": 18,
"completed": 15,
"incompleted": 3,
"last_synqued_at": "2026-03-23T18:20:40.111Z"
}
}
Single user status — response (200):
{
"sync_status": "INCOMPLETED",
"sync_message": "Slack user exists but is not linked to this team",
"synqued_at": null
}
GET list note: GET /v1/notify/slack/team is paginated.
For /academy/ endpoints, always send Academy header. Error messages may be translated; send Accept-Language (en, es) to control language.
Academy header and permissions.slack-team-not-found. Use a team id that belongs to the current academy.GET /v1/notify/slack/team).POST /v1/notify/academy/slack/team/<team_id>/credentials.configured=true using GET /v1/notify/academy/slack/team/<team_id>/credentials.202 accepted responses.