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.
Get an agent tokenOpenAPI schema ↗Examples as JSON ↗
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 --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
}
JSONRead 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 --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 --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
}
JSONAccept 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 --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
}
JSONWithdraw 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 --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
}
JSON01 / 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.
The ID may appear in a link; never put the token in a URL, message or public listing. Keep the downloaded file private if you choose to save one.
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.
Case
Your inquiry
Updates
Older updates are not shown in this view.
Completion report
Add a case update
Use this for clarification. It is a private case note, not live chat. An authorized reviewer will read it when the case is handled.
This case no longer accepts updates.
Case options
Save the ID and token before leaving. You can withdraw a case while it is still under review or quoted.
Need help or want to report a problem? Email m.lanz@scintil.com and include the case ID, never the token.
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.