{"uid":"cap_p3C-tNEEQQoFNPpC4tUHP","slug":"agents-actionlayer-io-actionlayer-poll-task-6285656f","name":"ActionLayer Poll Task","description":"Current state of a submitted task, including an `events` transcript. Unbilled; scoped to the submitting agent. Poll every 15–60s while the task is live — payment approvals are also reconciled on poll, so polling is never wasted. When `state` is `blocked_on_user`, read `info_request` and relay the ask to your user promptly (asks expire at `info_request.expires_at`).","url":"https://agents.actionlayer.io/zeroclick/tasks/{ticket_id}","method":"GET","headers":{},"bodySchema":{"type":"object","required":["ticket_id"],"properties":{"ticket_id":{"type":"string","title":"Ticket Id"}}},"responseSchema":{"type":"object","title":"TicketDetailResponse","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"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"state":{"type":"string","title":"State"},"events":{"type":"array","items":{"type":"object","title":"TicketEventResponse","required":["id","type","from_state","to_state","payload","created_at"],"properties":{"id":{"type":"string","title":"Id"},"type":{"type":"string","title":"Type"},"payload":{"type":"object","title":"Payload","additionalProperties":true},"to_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"To State"},"created_at":{"type":"string","title":"Created At","format":"date-time"},"from_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"From State"}},"description":"One status update in a task's transcript."},"title":"Events","default":[],"description":"Chronological transcript of status updates."},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"},"result":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}],"title":"Result"},"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"},"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"},"max_budget_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Budget Usd"}},"description":"A task plus its `events` transcript."},"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_nyRHhRZAnii0XuaJNDa-O","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":"Retrieves the current state, event transcript, and any user-input requests for a previously submitted ActionLayer task by ticket ID.","exampleAgentPrompt":"Check the current status of my ActionLayer task with ticket ID abc-123 — tell me if it's still running, blocked waiting for my input, or finished, and show me the event transcript.","exampleUseCases":[{"title":"Monitoring long-running web task","prompt":"I submitted a task to ActionLayer a few minutes ago with ticket ID f8e2c-4901 — can you check if it's done yet, and if it needs any input from me, let me know what it's asking?"},{"title":"Fetching completed task result","prompt":"My ActionLayer ticket 7d3a-bc91 should be finished by now — can you poll it and grab the final result for me?"},{"title":"Handling blocked task user prompt","prompt":"Check ticket bb12-5503 on ActionLayer and see if it's blocked waiting for me to answer something — if so, tell me what the question is before it expires."}],"resultDescription":"Returns a TicketDetailResponse object containing: task ID, current state (e.g. 'running', 'completed', 'blocked_on_user', 'failed'), the original goal text, a chronological events array (each with type, from_state, to_state, payload, timestamp), the final result object if completed, any error message, an info_request object if the task is waiting on user input (with an expiry timestamp), webhook URL, max budget, and created/updated/completed timestamps.","failureModes":["Ticket ID not found or not owned by the submitting agent — returns 404","Task in terminal error state — state field set to 'failed' with error field populated","info_request expires before user answers — ask becomes invalid, task may fail","Network timeout when polling — agent should retry with exponential backoff","Invalid ticket_id format — returns 400 or validation error"],"whenToPreferThis":"Use this endpoint when you have already submitted a task to ActionLayer and need to track its progress. This is the correct polling mechanism for ActionLayer tasks specifically — it is free (unbilled), scoped to the submitting agent, and is the only way to receive payment reconciliation updates and blocked-on-user info requests for ActionLayer tasks. Poll every 15–60 seconds while the task is live.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":10,"lastUsedAt":"2026-09-02T04:10:09.637Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:30:03.524Z","isFirstParty":false}