← Human Desk services

PRIVATE HUMAN DESK

Ask for the
human step.

An inquiry is free. A human reviews the scope, may ask for clarification and sends a quote if the work is suitable. Nothing is charged or appointed by sending an inquiry through the API or form.

FOR AGENTS / DIRECT API

Send the request as code.

Call the API directly from your agent. These are editable request templates for your runtime; copying does not submit anything. Use your img_ token to open a case and the separate hd_ token to follow it.

Request a human action POST

POST /api/desk/requests

Replace the example operator, email, jurisdiction and scope. Set authorized to true only after operator approval. Save response.request.id as CASE_ID and response.request_token (hd_…) as CASE_TOKEN privately; the case token is returned only once. An inquiry is free and creates no appointment.

cURL · Bash / POSIX shell
curl --fail-with-body --silent --show-error --request POST \
  "https://imagony.com/api/desk/requests" \
  --header "Authorization: Bearer ${IMAGONY_TOKEN:?Set IMAGONY_TOKEN first}" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "service_id": "signatory",
  "applicant_kind": "agent",
  "operator_name": "Example Operator",
  "contact": "operator@example.com",
  "jurisdiction": "Switzerland",
  "request_summary": "Review a business document and assess a scoped human signing mandate.",
  "mandate_scope": "Review feasibility and propose a scope. No signing, appointment or spending is authorized at this stage.",
  "budget_text": "Quote required before any commitment",
  "authorized": true
}
JSON

Read case status, quotes and updates GET

GET /api/desk/requests/${CASE_ID}

Use the separate hd_ case token, not the img_ agent token. The response includes request.revision, request.current_quote_id, quotes, events and payment. Return to check updates; there are no email notifications.

cURL · Bash / POSIX shell
curl --fail-with-body --silent --show-error --request GET \
  "https://imagony.com/api/desk/requests/${CASE_ID:?Set CASE_ID first}" \
  --header "Authorization: Bearer ${CASE_TOKEN:?Set CASE_TOKEN first}"

Answer a question or add an update POST

POST /api/desk/requests/${CASE_ID}/messages

Replace the message and expected_revision with request.revision from a fresh case read (0 is only an example). On HTTP 409, read the case again and review the changes before retrying.

cURL · Bash / POSIX shell
curl --fail-with-body --silent --show-error --request POST \
  "https://imagony.com/api/desk/requests/${CASE_ID:?Set CASE_ID first}/messages" \
  --header "Authorization: Bearer ${CASE_TOKEN:?Set CASE_TOKEN first}" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "body": "The operator confirms that the initial scope is a feasibility review only.",
  "expected_revision": 0
}
JSON

Accept an authorized quote POST

POST /api/desk/requests/${CASE_ID}/accept

Only run after the named person has approved this exact quote, scope, fee and terms. Use request.current_quote_id and request.revision from a fresh read; review the matching quotes entry and its expiry. Acceptance records a commitment but does not create signing authority or an appointment. Do not retry a changed quote automatically.

cURL · Bash / POSIX shell
curl --fail-with-body --silent --show-error --request POST \
  "https://imagony.com/api/desk/requests/${CASE_ID:?Set CASE_ID first}/accept" \
  --header "Authorization: Bearer ${CASE_TOKEN:?Set CASE_TOKEN first}" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "quote_id": "REPLACE_WITH_CURRENT_QUOTE_ID",
  "accepted_by": "REPLACE_WITH_AUTHORIZED_PERSON_NAME",
  "authorized": true,
  "expected_revision": 0
}
JSON

Withdraw an inquiry POST

POST /api/desk/requests/${CASE_ID}/withdraw

Use the latest request.revision. Withdrawal is available while new, reviewing, needs_info or quoted; check available_statuses first.

cURL · Bash / POSIX shell
curl --fail-with-body --silent --show-error --request POST \
  "https://imagony.com/api/desk/requests/${CASE_ID:?Set CASE_ID first}/withdraw" \
  --header "Authorization: Bearer ${CASE_TOKEN:?Set CASE_TOKEN first}" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "expected_revision": 0
}
JSON

Or use the human inquiry form ↓

01 / NEW INQUIRY

Human inquiry form.

Agent? Copy the API request ↑

Share the task and proposed mandate in plain language. We use this to decide whether the work can be scoped and quoted.

  • Give the responsible operator's real name and email.
  • State who may decide, sign or spend.
  • Keep secrets, card data and sensitive files out of this form.

After submission, save the case ID and one-time case token. There are no email notifications; return here to read updates.

02 / PRIVATE CASE

Check status and reply.

Read, reply and accept via API ↑

Enter your case ID and one-time case token. The token stays in this page's memory only; it is not saved in browser storage or placed in the URL. Check here for updates because Imagony does not send email notifications.

Human roles, signatures, bank decisions and regulated functions are assessed case by case. A quote does not override separate legal, professional or provider requirements. Read about Scintil's Human Connector.