{"uid":"cap_RhXqkPTnRobstaujTdPLC","slug":"agentbit-list-queue-memory-097da0ec","name":"AgentBit List/Queue Memory","description":"Private ordered list/queue for an agent: push/pop/peek/range/length/clear, scoped to the paying wallet. For task queues, event logs, buffers.","url":"https://agentbit.app/v1/memory/list?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"end":{"enum":["head","tail"],"type":"string","description":"Which end to push/pop/peek (default tail)."},"key":{"type":"string","description":"The list name."},"count":{"type":"integer","description":"For range: how many items (default 100)."},"start":{"type":"integer","description":"For range: start index (negative counts from the end)."},"value":{"description":"Any JSON value to push (for push)."},"namespace":{"type":"string","description":"Optional group (default \"default\")."},"operation":{"enum":["push","pop","peek","range","length","clear"],"type":"string","description":"What to do."},"ttl_seconds":{"type":"integer","description":"Optional expiry in seconds (max 90 days)."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_aE5t356EdzAW5wLne2KKg","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Provides a private, ordered list/queue data structure for agents with push, pop, peek, range, length, and clear operations scoped to the paying wallet.","exampleAgentPrompt":"Push the task 'send_weekly_report' onto the tail of my 'pending_tasks' list in the 'reporting' namespace, and set it to expire in 86400 seconds.","exampleUseCases":[{"title":"Task queue for agent pipeline","prompt":"Add 'process_invoice_#4521' to the tail of my 'invoice_queue' list, then tell me how many items are now in the queue."},{"title":"Peek next event without consuming it","prompt":"Peek at the head of my 'event_log' list so I can see what the next event is without removing it from the queue."},{"title":"Drain and review a buffer","prompt":"Give me the first 50 items from my 'error_buffer' list starting at index 0, then clear the list so it's ready for new entries."}],"resultDescription":"Returns a JSON response containing the operation result — the pushed/popped/peeked value, a list of items for range queries, an integer for length, or a success confirmation for clear/push operations. Includes the current list length where applicable.","failureModes":["Invalid operation enum value returns a 400 error","Missing required 'key' or 'operation' fields returns a validation error","Expired TTL causes list to be unavailable","Attempting to pop from an empty list returns null or empty response","Payment failure (x402) blocks the operation","TTL exceeding 90-day maximum is rejected"],"whenToPreferThis":"Choose this endpoint when your AI agent needs a persistent, ordered data structure (queue, stack, or list) that survives between invocations and is scoped to a specific wallet identity. Ideal for task queues, event buffers, breadcrumb logs, and any workflow requiring FIFO or LIFO ordering. Prefer over key-value storage when order and position matter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T01:10:59.351Z","isFirstParty":false,"canonicalSlug":"agentbit-list-queue-memory-097da0ec"}