Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
secondsky avatar

Sap Btp Job Scheduling

secondsky/sap-skills

  • 341 installs
  • 399 repo stars
  • Updated August 4, 2026
  • secondsky/sap-skills

Configure SAP BTP Job Scheduling service to run recurring background jobs, connect destinations, and orchestrate enterprise workloads from Claude-guided setup.

About

Skill for configuring SAP Business Technology Platform Job Scheduling to create, deploy, and manage recurring background jobs inside SAP-centric enterprise stacks. Covers service enablement, job definitions, destination connectivity, retry behavior, and operational patterns for reliable timed processing on BTP rather than ad-hoc cron scripts.

  • SAP BTP Job Scheduling setup
  • Cron and recurrence patterns
  • Destination and credential binding
  • Job monitoring and retries
  • Enterprise workload orchestration

Sap Btp Job Scheduling by the numbers

  • 341 all-time installs (skills.sh)
  • +29 installs in the week ending Aug 5, 2026 (Skillselion tracking)
  • Ranked #473 of 2,715 Automation & Workflows skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/secondsky/sap-skills --skill sap-btp-job-scheduling

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs341
repo stars★ 399
Last updatedAugust 4, 2026
Repositorysecondsky/sap-skills ↗

What it does

Configure SAP BTP Job Scheduling service to run recurring background jobs, connect destinations, and orchestrate enterprise workloads from Claude-guided setup.

Files

SKILL.mdMarkdownGitHub ↗

SAP BTP Job Scheduling Service

Related Skills

  • sap-dependency-security: Use for secure dependency and workflow hardening when your job scheduling microservices maintain npm/CLI dependency stacks

Table of Contents

Overview

SAP Job Scheduling Service is a runtime-agnostic platform service for defining and managing one-time and recurring jobs or Cloud Foundry tasks on SAP BTP. It operates across multiple hyperscalers (AWS, Azure, GCP) without requiring application modifications.

Documentation Source: https://help.sap.com/docs/job-scheduling

Last Verified: 2025-11-27

When to Use This Skill

Use this skill when:

  • Setting up Job Scheduling Service on Cloud Foundry or Kyma runtime
  • Creating and managing jobs via REST API or dashboard
  • Configuring schedules using cron, date/time, or human-readable formats
  • Implementing asynchronous job execution for long-running processes
  • Securing action endpoints with OAuth 2.0 and XSUAA
  • Integrating with SAP Cloud ALM or Alert Notification Service
  • Developing multitenant applications with tenant-aware job scheduling
  • Troubleshooting job execution issues and schedule failures
  • Using the Node.js client library (@sap/jobs-client)

Quick Decision Tree

What Task?

Setup & Configuration
├─ Initial setup prerequisites → references/setup-guide.md
├─ Create service instance
│  ├─ BTP Cockpit → references/setup-guide.md#cockpit
│  ├─ CF CLI → references/setup-guide.md#cf-cli
│  └─ Kyma Dashboard → references/setup-guide.md#kyma
└─ Configure XSUAA scopes → references/security.md

Job Management
├─ Create jobs → references/rest-api.md#create-job
├─ Configure schedules → references/rest-api.md#schedules
├─ Run logs & monitoring → references/rest-api.md#run-logs
└─ Dashboard operations → references/operations.md#dashboard

Schedule Configuration
├─ One-time vs recurring → references/concepts.md#schedule-types
├─ Cron format → references/concepts.md#cron-format
├─ Date/time formats → references/concepts.md#date-formats
└─ Human-readable → references/concepts.md#human-readable

Asynchronous Execution
├─ Async mode flow → references/concepts.md#async-mode
├─ Callback implementation → references/rest-api.md#update-run-log
└─ CF tasks → references/concepts.md#cf-tasks

Security & Authentication
├─ OAuth 2.0 setup → references/security.md#oauth
├─ XSUAA configuration → references/security.md#xsuaa
└─ Credential rotation → references/security.md#rotation

Integrations
├─ SAP Cloud ALM → references/integrations.md#cloud-alm
└─ Alert Notification → references/integrations.md#alert-notification

Troubleshooting
├─ Common errors → references/troubleshooting.md#errors
├─ FAQ → references/troubleshooting.md#faq
└─ Support: BC-CP-CF-JBS

Version History & Updates
└─ What's New (2021-2025) → references/changelog.md

Core Concepts

Job

A collection of schedules with an action endpoint. Jobs invoke a configured URL at specified times synchronously (short operations) or asynchronously (long processes).

Schedule

A one-time or recurring entity within a job. Supports multiple formats (cron, date/time, human-readable) and has three lifecycle states: SCHEDULED → RUNNING → COMPLETED.

Action Endpoint

An HTTP/REST endpoint exposed by your application that the service invokes when schedules trigger. Must be OAuth 2.0 protected in production.

Cloud Foundry Task

An app or script that runs independently in its own container. Always executes asynchronously with configurable memory allocation.

Service Constraints

ConstraintValue
Minimum schedule interval5 minutes
Synchronous request timeout15 seconds
Asynchronous timeout (default)30 minutes (configurable up to 7 days)
POST request body limit100 KB
Run log retention15 days
Service SLA~20 minutes from scheduled time

Quick Reference Tables

Schedule Formats

FormatExampleUse Case
Cron* * * * 10:12 0,30 0Every 30 min between 10:00-12:00
Date/Time2025-10-20T04:30:00ZISO-8601 one-time execution
Human-readabletomorrow at 4pmNatural language scheduling
repeatInterval2 hours, 5 minutesRecurring at fixed intervals
repeatAt4.40pm, 18:40Daily at specific time

Cron Format (7 fields)

Year Month Day DayOfWeek Hour Minute Second
*    *     *   *         *    *      *
FieldValuesSpecial
Year4-digit (2025)* = any
Month1-12*/a = every a-th
Day-31 to 31negative = from end
DayOfWeekmon, tue, wed...a.y = a-th occurrence
Hour0-23a:b = range
Minute0-59a:b/c = step in range
Second0-59a,b,c = multiple values

Schedule Lifecycle States

PhaseStatesDescription
SCHEDULEDSCHEDULEDQueued for future run
RUNNINGTRIGGERED, ACK_RECVD, ACK_NOT_RECVDExecuting
COMPLETEDSUCCESS, ERROR, REQUEST_ERROR, UNKNOWNFinished

HTTP Methods for Jobs

MethodEndpointPurpose
POST/scheduler/jobsCreate job
GET/scheduler/jobsList all jobs
GET/scheduler/jobs/{id}Get job details
PUT/scheduler/jobs/{id}Update job
DELETE/scheduler/jobs/{id}Delete job

Best Practices

Scheduling Optimization

Avoid Peak Times:

  • ❌ 0th or 30th second of any minute
  • ❌ 0th, 30th, or multiples of 5 minutes
  • ❌ Top of each hour
  • ❌ Midnight UTC (busiest time)

Use Irregular Times:

  • ✅ 01:12:17 instead of 01:00:00
  • ✅ 01:38:37 instead of 01:30:00

Asynchronous Jobs

1. Return 202 Accepted immediately - Don't block the request 2. Store request headers - x-sap-job-id, x-sap-job-schedule-id, x-sap-job-run-id, x-sap-scheduler-host 3. Update run log on completion - Single API call with final status 4. Handle timeouts - Default 30 min, configurable up to 7 days

One-Time Schedules

  • Use only for testing/validation
  • Auto-deactivate after execution
  • Use "time": "now" for immediate execution

Authentication Quick Start

Standard Plan (OAuth 2.0)

# Get access token
curl -X POST "<uaa_url>/oauth/token" \
  -H "Authorization: Basic $(echo -n '<clientid>:<clientsecret>' | base64)" \
  -d "grant_type=client_credentials"

# Use token in API calls
curl -X GET "https://jobscheduler-rest.<landscape>/scheduler/jobs" \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json"

xs-security.json Configuration

{
  "xsappname": "<app-name>",
  "scopes": [{
    "name": "$XSAPPNAME.JOBSCHEDULER",
    "description": "Job Scheduler Scope",
    "grant-as-authority-to-apps": ["$XSSERVICENAME(<jobscheduler-instance>)"]
  }]
}

Create Job Example

POST /scheduler/jobs
{
  "name": "myJob",
  "description": "Process daily reports",
  "action": "https://myapp.cfapps.eu10.hana.ondemand.com/api/process",
  "active": true,
  "httpMethod": "POST",
  "schedules": [{
    "active": true,
    "description": "Daily at 6 AM",
    "repeatAt": "6.00am",
    "startTime": {"date": "2025-01-01", "format": "YYYY-MM-DD"}
  }]
}

Node.js Client Library

Requirements: Node.js 14.x or later

npm install @sap/jobs-client@1.8.6
const JobSchedulerClient = require('@sap/jobs-client');
const scheduler = new JobSchedulerClient.Scheduler();

// Create job
scheduler.createJob({ url: vcapServices.jobscheduler[0].credentials.url }, {
  name: 'myJob',
  action: 'https://myapp.../process',
  active: true,
  httpMethod: 'GET',
  schedules: [{ cron: '* * * * 0 0 0', active: true }]
}, (err, result) => { /* handle */ });

Rate Limits

Limit TypeResponse CodeHeader
Client limit exceeded429retry-after (seconds)
Absolute limit exceeded503throttling (milliseconds)

Limits stack - both can apply simultaneously.

Service Behavior

Outage Recovery

Outage DurationBehavior
< 20 minutesAll missed executions run immediately
>= 20 minutesOnly last missed execution runs

Auto-Deactivation Triggers

  • One-time schedule executed
  • No valid future dates exist
  • Job/schedule endTime reached
  • Action endpoint unreachable for 10+ days

Reference Files

Detailed Guides Available

1. references/concepts.md - Schedule types, formats, lifecycle, async mode, multitenancy 2. references/rest-api.md - Complete REST API reference with all endpoints 3. references/setup-guide.md - Prerequisites, service instance creation 4. references/security.md - OAuth 2.0, XSUAA scopes, credential rotation 5. references/integrations.md - Cloud ALM, Alert Notification Service 6. references/troubleshooting.md - FAQ, error scenarios, monitoring 7. references/operations.md - Dashboard, backup/restore, service behavior 8. references/changelog.md - Version history, feature updates (2021-2025)

Templates Available

1. templates/job-creation.json - Job creation request template 2. templates/xs-security.json - XSUAA configuration template

Common Pitfalls

Setup:

  • ❌ Missing XSUAA binding before Job Scheduling binding
  • ❌ Not granting scopes via grant-as-authority-to-apps
  • ❌ Using HTTP instead of HTTPS for action endpoints

Scheduling:

  • ❌ Using Linux cron format (service uses SAP cron)
  • ❌ Scheduling at peak times (00:00, 00:30, etc.)
  • ❌ Forgetting UTC timezone (only supported timezone)

Async Jobs:

  • ❌ Not returning 202 Accepted immediately
  • ❌ Forgetting to call Update Run Log API
  • ❌ Multiple status updates instead of single final update

Multitenancy:

  • ❌ Using tenantId filter with SaaS tenant tokens (returns 400)
  • ❌ Missing Job Scheduling as application dependency

External Resources

SAP Documentation

Support

  • Component: BC-CP-CF-JBS
  • SAP Trust Center: Platform status verification
  • Guided Answers: Self-service troubleshooting

Updates and Maintenance

Source: SAP BTP Job Scheduling Service Documentation

To Update This Skill: 1. Check GitHub repository for documentation updates 2. Review What's New section for changes 3. Update affected reference files 4. Update templates if configurations changed 5. Update "Last Verified" date

Quarterly Review Recommended: Check for updates every 3 months

Next Review: 2026-02-27

Bundled Resources

Reference Files

1. references/concepts.md - Schedule types, formats, lifecycle, async mode, multitenancy (12K lines) 2. references/rest-api.md - Complete REST API reference with all endpoints (20K lines) 3. references/setup-guide.md - Prerequisites, service instance creation (9K lines) 4. references/security.md - OAuth 2.0, XSUAA scopes, credential rotation (11K lines) 5. references/integrations.md - Cloud ALM, Alert Notification Service (8K lines) 6. references/troubleshooting.md - FAQ, error scenarios, monitoring (9K lines) 7. references/operations.md - Dashboard, backup/restore, service behavior (8K lines) 8. references/changelog.md - Version history, feature updates (2021-2025) (9K lines)

Templates

1. templates/job-creation.json - Job creation request template with examples 2. templates/xs-security.json - XSUAA configuration template for OAuth scopes

---

License: GPL-3.0 Maintainer: Eduard Jiglau | hello@sap-ai-skills.com | sap-ai-skills.com | https://github.com/secondsky/sap-skills

Related skills

vercel-labsAgent BrowserGive their coding agent reliable, high-fidelity control over any website or Electron desktop app.591k39.6kopen.feishu.cnLark ApprovalLet their AI coding agent create, read, update, and approve items in Lark (Feishu) approval workflows without leaving the coding environment.494kopen.feishu.cnLark EventHandle Feishu/Lark bot events, webhooks, and subscription callbacks in agent-driven backend code.493kopen.feishu.cnLark Workflow Meeting SummaryAutomatically generate structured meeting summaries and action items from Lark/Feishu calls without manual note-taking.492kopen.feishu.cnLark Workflow Standup ReportAutomatically generate and post daily standup reports in Lark/Feishu from their workflow and activity data.492k101-skillsTwitter AutomationAutomate X/Twitter posts, scheduling, and engagement via X API integration441k669
Automation & Workflowsintegrationsbackend
Browse by category
AI & AgentsFrontend & DesignBackend & DataDev ToolsAutomationTesting & ReviewSecurityMonitoring & CloudDocs & Planning
Design & frontend
Design systemsAnimation & motionAccessibility (a11y)CSS & TailwindUI designUXDesign to codeshadcn/uiLanding pagesBest design skills
Most searched skills
find-skillscavemanfrontend-designbrainstormingsystematic-debuggingstop-slopemil-design-engui-ux-pro-maxkarpathy-guidelinesweb-design-guidelinesreact-best-practicesgrill-meimprovemicrosoft-foundryagent-browser
Browse all listings
All agent skillsAll MCP serversAll marketplacesAll plugins

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.