Get job status

GET

agents

jobs

{job_id}

status

curl -X GET 'https://api.cloud.blnkfinance.com/agents/jobs/job_1779300000000000000/status' \
  -H 'Authorization: Bearer CLOUD_API_KEY'

{
  "job_id": "job_1779300000000000000",
  "status": "running",
  "status_message": "Workflow executing.",
  "plan_run_id": "pr_1779300000000000000",
  "approval_state": "",
  "last_error": "",
  "schedule": null,
  "progress": {
    "total": 2,
    "completed": 1,
    "running": 1,
    "pending": 0,
    "failed": 0,
    "waiting_approval": 0
  },
  "current_step": {
    "step_id": "s2",
    "title": "watch assess and summarize",
    "task_type": "backoffice.watch_assess_and_summarize",
    "status": "running",
    "summary": "Step is running.",
    "created_at": "2026-09-16T05:10:04Z",
    "updated_at": "2026-09-16T05:10:08Z"
  },
  "failed_step": null,
  "sub_tasks": [
    {
      "step_id": "s1",
      "title": "filter collection",
      "task_type": "backoffice.filter_collection",
      "status": "completed",
      "task_id": "tsk_1779300000000000100",
      "summary": "Step completed.",
      "input_summary": "transactions filtered by 1 condition",
      "created_at": "2026-09-16T05:10:02Z",
      "updated_at": "2026-09-16T05:10:04Z"
    },
    {
      "step_id": "s2",
      "title": "watch assess and summarize",
      "task_type": "backoffice.watch_assess_and_summarize",
      "status": "running",
      "summary": "Step is running.",
      "created_at": "2026-09-16T05:10:04Z",
      "updated_at": "2026-09-16T05:10:08Z"
    }
  ],
  "reasoning_trail": [],
  "created_at": "2026-09-16T05:10:00Z",
  "updated_at": "2026-09-16T05:10:08Z",
  "links": {
    "status": "/agents/jobs/job_1779300000000000000/status",
    "result": "/agents/jobs/job_1779300000000000000/result",
    "control": "/agents/jobs/job_1779300000000000000/control"
  }
}

not found

jobs service unavailable

Agent Jobs API is currently in beta.

Use this endpoint while an agent job is in progress. The response is a compact snapshot: status, progress counts, the current or failed step, and summarized subtasks. For the final output after the job completes or fails, use Get job result. To pause, resume, approve, reject, or schedule, use Control agent job.

Add ?view=debug (or view=verbose, verbose=1) to include a debug object with the raw plan steps and reasoning trail.

Authorization

Blnk Cloud APIs support any one of the following authentication methods. All of them work with your CLOUD_API_KEY or OAUTH_ACCESS_TOKEN.

Bearer token
X-Blnk-Key header
X-API-Key header

Pass Authorization: Bearer CLOUD_API_KEY or Authorization: Bearer OAUTH_ACCESS_TOKEN.

string

required

Cloud API key or OAuth access token. Create credentials in API keys or OAuth.

Pass X-Blnk-Key: CLOUD_API_KEY or X-Blnk-Key: OAUTH_ACCESS_TOKEN.

string

required

Cloud API key or OAuth access token. Create credentials in API keys or OAuth.

Pass X-API-Key: CLOUD_API_KEY or X-API-Key: OAUTH_ACCESS_TOKEN.

string

required

Cloud API key or OAuth access token. Create credentials in API keys or OAuth.

Path

curl -X GET 'https://api.cloud.blnkfinance.com/agents/jobs/job_1779300000000000000/status' \
  -H 'Authorization: Bearer CLOUD_API_KEY'

string

required

Job to poll (job_...). Use the job_id returned by Create agent job.

string

Set to debug or verbose to add a debug object with the raw plan steps and reasoning trail. Leave unset for the compact payload.

string

Alias for view=debug. Send 1 or true. Prefer view.

string

Optional Core instance (instance_...). When present, Cloud checks that the instance belongs to your organization. The job already stores its instance from create.

Response

{
  "job_id": "job_1779300000000000000",
  "status": "running",
  "status_message": "Workflow executing.",
  "plan_run_id": "pr_1779300000000000000",
  "approval_state": "",
  "last_error": "",
  "schedule": null,
  "progress": {
    "total": 2,
    "completed": 1,
    "running": 1,
    "pending": 0,
    "failed": 0,
    "waiting_approval": 0
  },
  "current_step": {
    "step_id": "s2",
    "title": "watch assess and summarize",
    "task_type": "backoffice.watch_assess_and_summarize",
    "status": "running",
    "summary": "Step is running.",
    "created_at": "2026-09-16T05:10:04Z",
    "updated_at": "2026-09-16T05:10:08Z"
  },
  "failed_step": null,
  "sub_tasks": [
    {
      "step_id": "s1",
      "title": "filter collection",
      "task_type": "backoffice.filter_collection",
      "status": "completed",
      "task_id": "tsk_1779300000000000100",
      "summary": "Step completed.",
      "input_summary": "transactions filtered by 1 condition",
      "created_at": "2026-09-16T05:10:02Z",
      "updated_at": "2026-09-16T05:10:04Z"
    },
    {
      "step_id": "s2",
      "title": "watch assess and summarize",
      "task_type": "backoffice.watch_assess_and_summarize",
      "status": "running",
      "summary": "Step is running.",
      "created_at": "2026-09-16T05:10:04Z",
      "updated_at": "2026-09-16T05:10:08Z"
    }
  ],
  "reasoning_trail": [],
  "created_at": "2026-09-16T05:10:00Z",
  "updated_at": "2026-09-16T05:10:08Z",
  "links": {
    "status": "/agents/jobs/job_1779300000000000000/status",
    "result": "/agents/jobs/job_1779300000000000000/result",
    "control": "/agents/jobs/job_1779300000000000000/control"
  }
}

not found

jobs service unavailable

string

Job you polled (job_...). Same value you sent in the path.

string

Where the job is right now: queued, scheduled, planning, running, paused, waiting_approval, completed, or failed. Poll until completed or failed, then call Get job result.

string

Short sentence that matches status, for example Workflow executing. Use this for logs or UI copy. Do not parse it.

string

Plan Cloud built from your message (pr_...). Empty until planning finishes. Status, result, and control still use job_id.

string

Set when the job is in waiting_approval. Empty otherwise. Use Control agent job with approve or reject to continue.

string

Most recent error on the job. Empty while the job is healthy. Filled when a step or the planner fails.

object

Present when this job is waiting for a one-time run or is tied to a recurring template. null for a normal create.

Show Schedule properties

timestamp

UTC ISO 8601 time when a one-time scheduled child job should start.

string

Recurring template created from this job (rt_...).

object

How many plan steps are in each state: total, completed, running, pending, failed, waiting_approval. Use this for a progress bar. running also counts steps in created_task.

object

The step Cloud is on now: first running, created_task, or waiting_approval step, otherwise the next pending step. null when no step is active. Same shape as one item in sub_tasks.

object

First step with status failed. null when every step has succeeded or has not failed yet. Same shape as one item in sub_tasks.

array

Compact plan steps, oldest first. This is the summarized view. Use view=debug if you need the raw plan payload.

Show Compact step

string

Step ID from the plan (s1, s2, …).

string

Readable label derived from task_type. Cloud strips the backoffice. prefix and replaces underscores with spaces.

string

Planner step name, such as backoffice.filter_collection. Map this to a capability in the tool allowlist if you set approved_tools.

string

Step state: pending, running, created_task, waiting_approval, completed, or failed.

string

Task Cloud created for this step (tsk_...). Empty until the step starts work.

array

step_id values this step waits on before it can run.

string

What the step is doing or just did, truncated to 220 characters.

string

Why the step failed. Empty on successful or in-progress steps.

string

Short description of the step input, for example transactions filtered by 1 condition. Empty when Cloud has nothing useful to show.

array

Compact planner and execution notes. Each item has id, kind, title, status, and summary. Empty until the planner writes notes.

timestamp

When Cloud accepted the job, in UTC ISO 8601.

timestamp

When the job last changed, in UTC ISO 8601. Use this to see if a poll returned new work.

object

Relative paths for status, result, and control on this job. Prefix them with https://api.cloud.blnkfinance.com.

object

Raw sub_tasks and reasoning_trail. Present only when you send view=debug (or verbose=1). Omit it in production clients.

Need help?

We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool. To ask questions or discuss issues, please contact us or join our Discord community.

curl -X GET 'https://api.cloud.blnkfinance.com/agents/jobs/job_1779300000000000000/status' \
  -H 'Authorization: Bearer CLOUD_API_KEY'

{
  "job_id": "job_1779300000000000000",
  "status": "running",
  "status_message": "Workflow executing.",
  "plan_run_id": "pr_1779300000000000000",
  "approval_state": "",
  "last_error": "",
  "schedule": null,
  "progress": {
    "total": 2,
    "completed": 1,
    "running": 1,
    "pending": 0,
    "failed": 0,
    "waiting_approval": 0
  },
  "current_step": {
    "step_id": "s2",
    "title": "watch assess and summarize",
    "task_type": "backoffice.watch_assess_and_summarize",
    "status": "running",
    "summary": "Step is running.",
    "created_at": "2026-09-16T05:10:04Z",
    "updated_at": "2026-09-16T05:10:08Z"
  },
  "failed_step": null,
  "sub_tasks": [
    {
      "step_id": "s1",
      "title": "filter collection",
      "task_type": "backoffice.filter_collection",
      "status": "completed",
      "task_id": "tsk_1779300000000000100",
      "summary": "Step completed.",
      "input_summary": "transactions filtered by 1 condition",
      "created_at": "2026-09-16T05:10:02Z",
      "updated_at": "2026-09-16T05:10:04Z"
    },
    {
      "step_id": "s2",
      "title": "watch assess and summarize",
      "task_type": "backoffice.watch_assess_and_summarize",
      "status": "running",
      "summary": "Step is running.",
      "created_at": "2026-09-16T05:10:04Z",
      "updated_at": "2026-09-16T05:10:08Z"
    }
  ],
  "reasoning_trail": [],
  "created_at": "2026-09-16T05:10:00Z",
  "updated_at": "2026-09-16T05:10:08Z",
  "links": {
    "status": "/agents/jobs/job_1779300000000000000/status",
    "result": "/agents/jobs/job_1779300000000000000/result",
    "control": "/agents/jobs/job_1779300000000000000/control"
  }
}

not found

jobs service unavailable

Start Here

Deployments

Proxy & data

Data lake

AI integrations

Audit

Alerts

Billing

Authorization

Path

Response

Need help?

​Authorization

​Path

​Response

​Need help?

Authorization

Path

Response

Need help?