Moab logoMoab
Get started
Moab Docs

Blockers

Active upstream blockers — server-stamped, cleared by the event that unblocks.

Base path /api/v1/blockers on https://moabcrm.com. Authenticate with Authorization: Bearer $DASH_API_KEY and name the project with the Project-ID header. Writes are validated in declared mode; an operation this resource does not declare answers 405 operation_not_supported.

List blockers

GET /api/v1/blockers

curl "https://moabcrm.com/api/v1/blockers" \
  -H "Authorization: Bearer $DASH_API_KEY" \
  -H "Project-ID: pr_zest"
Show me the blockers filtered by code
data_query {
  "collection": "blockers"
}

Returns a paginated list of blocker objects, newest first.

{
  "object": "list",
  "data": [
    {
      "object": "blocker",
      "id": "obj_123",
      "code": "code",
      "message": "message",
      "agent_ref": "agent ref",
      "provider": "provider",
      "source": "source",
      "stamped_at": "2026-07-25T12:00:00.000Z",
      "created_at": "2026-07-25T12:00:00.000Z",
      "updated_at": "2026-07-25T12:00:00.000Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Parameters

ParameterTypeKindDescription
codestringfilterThe machine name of the blocker (sourcing_credits, approval_queue, list_mined_out). One row per (code, agent_ref) — re-hitting the same blocker refreshes the row, never duplicates it.
agent_refstringfilterCampaign-agent row id when the blocker is agent-scoped (approval_queue, list_mined_out). Absent = project-scoped (sourcing_credits). The planner skips agents carrying an active blocker and never spawns them.
sortstringsortOne of stamped_at; prefix with - to reverse.
limitnumberpageRows to return, 1–100. Defaults to 20.
cursorstringpagenext_cursor from the previous page.

Retrieve a blocker

GET /api/v1/blockers/draft-001

curl "https://moabcrm.com/api/v1/blockers/draft-001" \
  -H "Authorization: Bearer $DASH_API_KEY" \
  -H "Project-ID: pr_zest"
Open the blocker {id}
data_get {
  "collection": "blockers",
  "object_id": "draft-001"
}

Returns the blocker object.

{
  "object": "blocker",
  "id": "obj_123",
  "code": "code",
  "message": "message",
  "agent_ref": "agent ref",
  "provider": "provider",
  "source": "source",
  "stamped_at": "2026-07-25T12:00:00.000Z",
  "created_at": "2026-07-25T12:00:00.000Z",
  "updated_at": "2026-07-25T12:00:00.000Z"
}

Parameters

ParameterTypeKindDescription
idstringpathThe blocker's id or slug.

What comes back (read-only)

Every blocker carries the envelope below. The fields under it are computed or stamped by the platform — they are returned, never sent.

FieldTypeDescription
objectstringAlways blocker.
idstringStable object id. Also accepted in place of slug on any path.
slugstringURL-safe name, unique within the collection.
created_atstringISO-8601 timestamp of the first write.
updated_atstringISO-8601 timestamp of the most recent write. The cursor sorts on this.
codestringThe machine name of the blocker (sourcing_credits, approval_queue, list_mined_out). One row per (code, agent_ref) — re-hitting the same blocker refreshes the row, never duplicates it.
messagestringThe operator-English sentence ("Sourcing is down: Prospeo out of credits"). Written by the server gate, rendered verbatim on home and the report's Needs-you section.
agent_refstringCampaign-agent row id when the blocker is agent-scoped (approval_queue, list_mined_out). Absent = project-scoped (sourcing_credits). The planner skips agents carrying an active blocker and never spawns them.
providerstringIntegration slug when the blocker is provider-scoped (sourcing_credits names the refusing provider) — one row per provider, cleared when THAT provider serves a call again.
sourcestringWhich server gate stamped it (integration-call-hook, sandbox-saturation-gate) — where to look for the evidence.
stamped_atdateWhen the gate last hit this blocker (refreshed on re-hit).

Errors

Failures use { error: { type, code, message, param } }. The full code table is generated at Error Codes.

On this page

Moab logoMoab

Ready to build? Connect an agent and go — no credit card needed to start.

Get startedSee our plans