{"uid":"cap_7Gyr0jGFkg4lKtz9WsHF5","slug":"agents-actionlayer-io-actionlayer-reply-to-blocked-task-cd0b36c2","name":"ActionLayer Reply to Blocked Task","description":"Resume a task waiting on user input. Plain asks (no `info_request` on the task): answer with `message` or `field`+`value`, setting `sensitive: true` for secrets. Structured asks (`info_request` present): send `info.field_values` whose keys exactly match `requested_fields` plus every `questions[].key`, all values non-empty. Payment asks are approved in the end user's Link app, never here — `info.payment_approved` only declines a charge (false) or re-sends a lapsed approval push (true). Unbilled; scoped to the submitting agent.","url":"https://agents.actionlayer.io/zeroclick/tasks/{ticket_id}/reply","method":"POST","headers":{},"bodySchema":{"type":"object","title":"ReplyTaskRequest","properties":{"info":{"anyOf":[{"type":"object","title":"InfoReplyData","properties":{"field_values":{"type":"object","title":"Field Values","description":"Map of `{requested_field_name: value}`. Keys must exactly match `info_request.requested_fields` plus every `info_request.questions[].key`; values must be non-empty.","additionalProperties":{"type":"string"}},"payment_approved":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Payment Approved","description":"Payment-ask control. `false`: decline the charge and end the task (`error=payment_rejected`). `true`: when `payment_status=approval_expired`, send a fresh approval request to the user's Link app. The approval itself always happens in the Link app, never here."}},"description":"Structured answers for a task's `info_request`. Either the end user or their agent can supply these."},{"type":"null"}],"description":"Required when the task carries an `info_request`; ignored otherwise."},"field":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Field","description":"Machine-readable name of the requested item — e.g. `sms_code`. `value` is stored under this key."},"value":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}],"title":"Value"},"message":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}],"title":"Message"},"sensitive":{"type":"boolean","title":"Sensitive","default":false,"description":"Set true when `value` is a secret (2FA code, password): encrypted at rest, purged when the task ends, redacted in logs."}},"description":"Body for answering a `blocked_on_user` ask: a free-form `message`, or `field`+`value` for a specific requested item, or `info` when the task carries an `info_request`."},"responseSchema":{"type":"object","title":"TicketResponse","required":["id","state","goal","flow","max_budget_usd","webhook_url","result","error","created_at","updated_at","completed_at"],"properties":{"id":{"type":"string","title":"Id"},"flow":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Flow"},"goal":{"type":"string","title":"Goal","description":"The submitted task text; answered questions are folded in over time."},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Machine-readable failure code when state is failed (e.g. `payment_rejected`)."},"state":{"type":"string","title":"State","description":"`pending | blocked_on_user | completed | failed | cancelled` — see the document description for how to handle each."},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason","description":"Human-readable summary, set when state is completed or failed."},"result":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}],"title":"Result","description":"Structured output on completion: `{output, summary}`."},"created_at":{"type":"string","title":"Created At","format":"date-time"},"updated_at":{"type":"string","title":"Updated At","format":"date-time"},"webhook_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Webhook Url","description":"Not used on this surface; always null."},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"},"info_request":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}],"title":"Info Request","description":"Present while the task awaits user action: `{amount_usd?, merchant_name?, payment_status?, payment_error?, requested_fields, questions, note?, created_at, expires_at}`. See the document description for `payment_status` handling."},"max_budget_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Budget Usd","description":"Not used on this surface; always null."}},"description":"A task. `state` is one of `pending | blocked_on_user | completed | failed | cancelled`; `completed` and `failed` carry a human-readable `reason`. When `state` is `blocked_on_user`, `info_request` describes what's needed."},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.000000","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"unknown_unparsed","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"unknown","summary":"price unknown","primary":{"kind":"unknown","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"unknown","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_k7dADIKhT2uEqIKtYGMIk","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.000000","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.actionlayer.io","brandSlug":"agents-actionlayer-io-mpp","brandBaseUrl":"https://agents.actionlayer.io","brandDocsUrl":null,"whatItDoes":"Resumes an ActionLayer task that is waiting on user input by supplying an answer, field value, or structured info response.","exampleAgentPrompt":"The ActionLayer task for booking my flight is blocked waiting for my SMS verification code — reply to ticket abc123 with the code 847291 and mark it as sensitive.","exampleUseCases":[{"title":"Providing 2FA code to unblock task","prompt":"My ActionLayer task is stuck waiting for a two-factor authentication code — send the code 391847 as a sensitive value under the field 'sms_code' for ticket task-xyz-789."},{"title":"Submitting structured info_request fields","prompt":"The travel research task I submitted is blocked and needs my passport number and date of birth — fill in those requested fields with 'A12345678' and '1985-06-15' to resume ticket task-abc-456."},{"title":"Declining an unexpected payment charge","prompt":"An ActionLayer task is asking me to approve a $49.99 charge from a merchant I don't recognize — decline that payment for ticket task-def-321 so the task ends without charging me."}],"resultDescription":"Returns the full updated task object including the new state (e.g. pending, completed, failed), the goal text, any remaining info_request, the structured result on completion, and an error code if the task failed (e.g. payment_rejected).","failureModes":["Task not in blocked_on_user state — reply rejected because task is not awaiting input","Missing required info fields — info.field_values keys don't exactly match requested_fields or questions[].key","Empty field values — all values in info.field_values must be non-empty strings","Payment approval attempted here — payment approvals must happen in the user's Link app, not via this endpoint","Ticket not found — invalid or expired ticket_id returns 404","Sensitive value not flagged — secrets submitted without sensitive:true may be logged or exposed"],"whenToPreferThis":"Use this endpoint when an ActionLayer task has reached the blocked_on_user state and is waiting for user-supplied input — whether that is a free-form message, a specific named field value (such as a verification code), a full structured info_request response, or a payment decline/re-approval signal. Do not use this to start a new task or poll task status; use the task submission and polling endpoints for those.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:30:02.711Z","isFirstParty":false}