For AI agents: markdown of this page — /docs-content-en/infra/jobs/list.md documentation index — /llms.txt

List jobs

GET /v1/infra/servers/:id/jobs

Returns all non-deleted server jobs, including disabled ones, with up to five latest runs per job. Works when the feature is unavailable. The response contains no secret.

Requires a key with vibe:infra and existing server permissions. Writes need the managing key or a team role permitted to manage the lifecycle. General rules; signature verification.

Parameters

Parameter	In	Type	Required	Description
`id`	path	string	yes	Server ID from the server list

No request body or query parameters are needed. For a POST without a body, omit Content-Type: application/json; an empty JSON body is rejected before the handler.

Examples

curl — personal key

Terminal

curl --max-time 20 -X GET "https://vibecode.bitrix24.com/v1/infra/servers/SERVER_ID/jobs" \
  -H "X-Api-Key: YOUR_API_KEY"

curl — OAuth application

Terminal

curl --max-time 20 -X GET "https://vibecode.bitrix24.com/v1/infra/servers/SERVER_ID/jobs" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

JavaScript — personal key

javascript

const serverId = 'SERVER_ID';
const res = await fetch(`https://vibecode.bitrix24.com/v1/infra/servers/${encodeURIComponent(serverId)}/jobs`, {
  method: 'GET',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
  },
});
const result = await res.json();
if (!res.ok || !result.success) throw new Error(result.error?.code ?? `HTTP_${res.status}`);
console.log(result);

JavaScript — OAuth application

javascript

const serverId = 'SERVER_ID';
const res = await fetch(`https://vibecode.bitrix24.com/v1/infra/servers/${encodeURIComponent(serverId)}/jobs`, {
  method: 'GET',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
});
const result = await res.json();
if (!res.ok || !result.success) throw new Error(result.error?.code ?? `HTTP_${res.status}`);
console.log(result);

Response

HTTP 200. Illustrative response shape with synthetic IDs, not a live request result.

JSON

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "job_example",
        "serverId": "server_example",
        "label": "daily digest",
        "cronExpr": "0 9 * * *",
        "timezone": "Africa/Abidjan",
        "path": "/tasks/digest?mode=daily",
        "enabled": true,
        "nextScheduledFor": "2026-10-11T09:00:00.000Z",
        "scheduleRevision": 1,
        "availableSince": "2026-10-09T10:00:00.000Z",
        "createdAt": "2026-10-09T10:00:00.000Z",
        "updatedAt": "2026-10-09T10:00:00.000Z",
        "latestRuns": [
          {
            "id": "run_example",
            "jobId": "job_example",
            "serverId": "server_example",
            "portalId": "account_example",
            "path": "/tasks/digest?mode=daily",
            "scheduleRevision": 1,
            "trigger": "SCHEDULE",
            "scheduledFor": "2026-10-10T09:00:00.000Z",
            "status": "SUCCEEDED",
            "attempts": 1,
            "nextAttemptAt": null,
            "readyDeadlineAt": "2026-10-10T09:30:00.000Z",
            "deliveryDeadlineAt": "2026-10-14T09:00:00.000Z",
            "waitingForServer": false,
            "startedAt": "2026-10-10T09:00:02.000Z",
            "lastAttemptStartedAt": "2026-10-10T09:00:02.000Z",
            "late": false,
            "finishedAt": "2026-10-10T09:00:02.150Z",
            "durationMs": 150,
            "responseSource": "app",
            "httpStatus": 202,
            "errorCode": null,
            "lastAttemptErrorCode": null,
            "requestId": "request_example",
            "responseSnippet": "{\"accepted\":true}",
            "createdAt": "2026-10-10T09:00:00.000Z",
            "updatedAt": "2026-10-10T09:00:02.150Z"
          }
        ]
      }
    ]
  }
}

Response fields

Field	Type	Description
`success`	boolean	Always `true` on success.
`data`	object	Object containing the job list in `items`.

The signing secret is not returned.

Fields of data:

Field	Type	Description
`items`	array	All non-deleted jobs, at most 20

Fields of each job in data.items:

Field	Type	Description
`id`	string	Job ID
`serverId`	string	Server ID
`label`	string	Job label
`cronExpr`	string	Five-field cron
`timezone`	string	Schedule time zone
`path`	string	Path and optional query string
`enabled`	boolean	Whether scheduled runs are enabled
`nextScheduledFor`	string	Next scheduled occurrence, UTC ISO-8601
`scheduleRevision`	integer	Schedule revision
`availableSince`	string	Start of the current schedule period, UTC ISO-8601
`createdAt`	string	Creation time, UTC ISO-8601
`updatedAt`	string	Last update time, UTC ISO-8601
`latestRuns`	array	Up to 5 latest runs; every field is described in history

Errors

HTTP	Code	Reason
401	`MISSING_API_KEY`	Missing API key
403	`SERVER_ROLE_FORBIDDEN`	Development team role does not permit this action
404	`NOT_FOUND`	Server not found or inaccessible to the caller

Full list of shared error codes — Errors.