Skip to content
Submit a Task
Public Preview

Task limits: submission, deadlines, and continuations

This reference lists Duale AI Task limits for submission, deadlines, continuations, and code execution, with the outcome at each limit and the next action.

This page lists the limits for submitting, planning, receiving, continuing, stopping, and running code in Duale AI Tasks.

  • Task submission limits for instructions, IDs, and request size.
  • Deadline planning for Task lifetime, work cutoff, and answer timing.
  • Outcome limits for free-text answers and result retention.
  • Continuation and recall limits for parent age and chain depth.
  • Code execution limits for run time, machine size, and disk space.

Summaries were generated by AI.

Plan each Task against these limits: each row states what happens at the limit and what to do next.

Submit a Task

LimitValueWhat happensYour action
Instruction1 to 100,000 characters, without NUL charactersThe SDK or Duale AI refuses the request, and no Task starts.Put long material in attachments.
Task ID10 to 128 ASCII letters, digits, _, or -Duale AI refuses the request with 422, and no Task starts.Let the SDK generate the Task ID.
Task ID reuse30 days from the first submissionWithin 30 days, a request with the same Task ID from the same Agent Identity starts nothing new and streams the first Task, even with a different instruction. After 30 days, the same Task ID can start a new Task, which Duale AI charges.Reuse a Task ID only to retry the same request.
Response-format description500 charactersThe SDK or Duale AI refuses the request, and no Task starts.Shorten the description.
Request size4 MiB for one Task submission or continuationDuale AI refuses the request with 413 REQUEST_BODY_TOO_LARGE, and no Task starts.Shorten the JSON Schema of the response format.
Size of one model turnA fixed size for the Task history, the Tool definitions, and the Tool Results of one turn. A larger context window does not raise it.Before the Task starts, Duale AI refuses it with LLM_CONFIG_CONTEXT_TOO_SMALL and does not charge it. Later, the Task fails with that code.Return smaller Tool Results, shorten Tool definitions, or start a new Task instead of a continuation.
  • Limit
    Instruction
    Value
    1 to 100,000 characters, without NUL characters
    What happens
    The SDK or Duale AI refuses the request, and no Task starts.
    Your action
    Put long material in attachments.
  • Limit
    Task ID
    Value
    10 to 128 ASCII letters, digits, _, or -
    What happens
    Duale AI refuses the request with 422, and no Task starts.
    Your action
    Let the SDK generate the Task ID.
  • Limit
    Task ID reuse
    Value
    30 days from the first submission
    What happens
    Within 30 days, a request with the same Task ID from the same Agent Identity starts nothing new and streams the first Task, even with a different instruction. After 30 days, the same Task ID can start a new Task, which Duale AI charges.
    Your action
    Reuse a Task ID only to retry the same request.
  • Limit
    Response-format description
    Value
    500 characters
    What happens
    The SDK or Duale AI refuses the request, and no Task starts.
    Your action
    Shorten the description.
  • Limit
    Request size
    Value
    4 MiB for one Task submission or continuation
    What happens
    Duale AI refuses the request with 413 REQUEST_BODY_TOO_LARGE, and no Task starts.
    Your action
    Shorten the JSON Schema of the response format.
  • Limit
    Size of one model turn
    Value
    A fixed size for the Task history, the Tool definitions, and the Tool Results of one turn. A larger context window does not raise it.
    What happens
    Before the Task starts, Duale AI refuses it with LLM_CONFIG_CONTEXT_TOO_SMALL and does not charge it. Later, the Task fails with that code.
    Your action
    Return smaller Tool Results, shorten Tool definitions, or start a new Task instead of a continuation.

Plan around the deadline

LimitValueWhat happensYour action
Task lifetime30 days from submission, whatever the deadlineDuale AI shortens a later deadline to this limit, with no error, and the Task ends by then.Split longer work into continuations. Each has its own lifetime.
Default deadline30 minutes from submission, when ask() or next() gets no deadlineThe Task ends near that time.Pass a deadline that fits the work.
Work cutoff5 minutes before the deadline. With a deadline less than 10 minutes away: 5 minutes after submission, or at the deadline when that comes first.The Task starts no new model turn, delegated work, or Tool Call, and writes its answer. A Tool Call still running at this point times out, even when its own time limit is longer.Set the deadline 5 minutes later than the time the work needs.
Answer after the deadlineUp to 5 minutes after the deadlineThe Task’s result can arrive in this time. If no answer is ready by then, the Task fails with TASK_DEADLINE_EXCEEDED.Keep waiting for the result for 5 minutes after the deadline.
  • Limit
    Task lifetime
    Value
    30 days from submission, whatever the deadline
    What happens
    Duale AI shortens a later deadline to this limit, with no error, and the Task ends by then.
    Your action
    Split longer work into continuations. Each has its own lifetime.
  • Limit
    Default deadline
    Value
    30 minutes from submission, when ask() or next() gets no deadline
    What happens
    The Task ends near that time.
    Your action
    Pass a deadline that fits the work.
  • Limit
    Work cutoff
    Value
    5 minutes before the deadline. With a deadline less than 10 minutes away: 5 minutes after submission, or at the deadline when that comes first.
    What happens
    The Task starts no new model turn, delegated work, or Tool Call, and writes its answer. A Tool Call still running at this point times out, even when its own time limit is longer.
    Your action
    Set the deadline 5 minutes later than the time the work needs.
  • Limit
    Answer after the deadline
    Value
    Up to 5 minutes after the deadline
    What happens
    The Task’s result can arrive in this time. If no answer is ready by then, the Task fails with TASK_DEADLINE_EXCEEDED.
    Your action
    Keep waiting for the result for 5 minutes after the deadline.

Receive and keep the outcome

LimitValueWhat happensYour action
Free-text answer100,000 bytes of UTF-8 text, for an answer without a JSON Schema response formatDuale AI does not accept a longer answer. When the Task cannot write a shorter one, it fails with RESULT_UNAVAILABLE.Ask for a shorter answer, or split the work across continuations that each answer one part.
Reading a Task againA limited time after submissionAfter that time, a request with the Task ID cannot return the Task’s events or its result.Save the result when it arrives.
  • Limit
    Free-text answer
    Value
    100,000 bytes of UTF-8 text, for an answer without a JSON Schema response format
    What happens
    Duale AI does not accept a longer answer. When the Task cannot write a shorter one, it fails with RESULT_UNAVAILABLE.
    Your action
    Ask for a shorter answer, or split the work across continuations that each answer one part.
  • Limit
    Reading a Task again
    Value
    A limited time after submission
    What happens
    After that time, a request with the Task ID cannot return the Task’s events or its result.
    Your action
    Save the result when it arrives.

Continue a Task or recall earlier work

LimitValueWhat happensYour action
Continuation Task IDDiffers from the parent’s Task IDDuale AI refuses the request with 422, and no Task starts.Let the SDK generate the Task ID.
Parent age30 days from the parent’s submissionThe continuation fails with PARENT_TASK_NOT_FOUND or PARENT_TASK_UNAVAILABLE.Start a new Task.
Inherited history30 days from the request that supplied each part, including the first Task’s instructionThe continuation uses only the history that remains, with no error.Restate lasting rules in the continuation’s own instruction.
Continuation chain90 days from the chain’s first TaskA later continuation fails with CONTINUATION_UNAVAILABLE.Start a new Task.
Wait for a running parentUp to the continuation’s own deadlineThe continuation waits until the parent has work to inherit, and can start several minutes after that. If the parent has none in time, the continuation fails with PARENT_TASK_UNAVAILABLE.Give the continuation a deadline that leaves time to wait, or continue the parent after it ends.
Recall reachEarlier Tasks of the same Agent Identity, for a limited period after they ranRecall does not find older Tasks. A Task that just ended can also be missing for a short time.To build on one earlier Task, continue it.
  • Limit
    Continuation Task ID
    Value
    Differs from the parent’s Task ID
    What happens
    Duale AI refuses the request with 422, and no Task starts.
    Your action
    Let the SDK generate the Task ID.
  • Limit
    Parent age
    Value
    30 days from the parent’s submission
    What happens
    The continuation fails with PARENT_TASK_NOT_FOUND or PARENT_TASK_UNAVAILABLE.
    Your action
    Start a new Task.
  • Limit
    Inherited history
    Value
    30 days from the request that supplied each part, including the first Task’s instruction
    What happens
    The continuation uses only the history that remains, with no error.
    Your action
    Restate lasting rules in the continuation’s own instruction.
  • Limit
    Continuation chain
    Value
    90 days from the chain’s first Task
    What happens
    A later continuation fails with CONTINUATION_UNAVAILABLE.
    Your action
    Start a new Task.
  • Limit
    Wait for a running parent
    Value
    Up to the continuation’s own deadline
    What happens
    The continuation waits until the parent has work to inherit, and can start several minutes after that. If the parent has none in time, the continuation fails with PARENT_TASK_UNAVAILABLE.
    Your action
    Give the continuation a deadline that leaves time to wait, or continue the parent after it ends.
  • Limit
    Recall reach
    Value
    Earlier Tasks of the same Agent Identity, for a limited period after they ran
    What happens
    Recall does not find older Tasks. A Task that just ended can also be missing for a short time.
    Your action
    To build on one earlier Task, continue it.

SDK errors gives the next action for each code.

Stop a Task

LimitValueWhat happensYour action
Stop reason1 to 500 characters, not only spaces, without NUL charactersThe SDK or Duale AI refuses the Stop request, and the Task keeps running.Shorten the reason.
Size of the Task’s workA fixed bound on the model turns and Tool Calls of the whole Task, including its delegated workDuale AI accepts the Stop with 202, then drops it with no error, event, or result. The Task keeps running, and a repeated Stop fails the same way.Set a deadline that bounds the work, and check the Task’s result after each Stop.
  • Limit
    Stop reason
    Value
    1 to 500 characters, not only spaces, without NUL characters
    What happens
    The SDK or Duale AI refuses the Stop request, and the Task keeps running.
    Your action
    Shorten the reason.
  • Limit
    Size of the Task’s work
    Value
    A fixed bound on the model turns and Tool Calls of the whole Task, including its delegated work
    What happens
    Duale AI accepts the Stop with 202, then drops it with no error, event, or result. The Task keeps running, and a repeated Stop fails the same way.
    Your action
    Set a deadline that bounds the work, and check the Task’s result after each Stop.

Run code

LimitValueWhat happensYour action
Run time5 minutes for each run, including any wait while another run or document copy of the Task uses the machineA run still running shortly before then stops and shows Outcome unknown, and the machine keeps none of the run’s changes.For longer work, publish an SDK Tool that does it.
Machine size1 vCPU and 512 MiB of memoryA run stops when its code runs out of memory, with the same outcome as at the end of the run time.For larger work, publish an SDK Tool that does it.
Disk space512 MiB on each machineCode on the machine cannot write more. A document copy holds only the extracted text when the original does not fit, and Duale AI refuses to copy a document whose text does not fit.For larger data, publish an SDK Tool that works on it.
Printed outputA fixed amount for each runOutput past that amount does not reach the model. When one piece of code prints past it, that code can fail without returning any output, and the run stops there.Ask the Task to print compact results, such as totals or only the rows it needs.
Machine lifetime30 days after the machine’s last useDuale AI erases the machine and its files. A continuation that runs code later starts without them.Ask for the data you need in the Task’s answer, and keep it in your own system.
  • Limit
    Run time
    Value
    5 minutes for each run, including any wait while another run or document copy of the Task uses the machine
    What happens
    A run still running shortly before then stops and shows Outcome unknown, and the machine keeps none of the run’s changes.
    Your action
    For longer work, publish an SDK Tool that does it.
  • Limit
    Machine size
    Value
    1 vCPU and 512 MiB of memory
    What happens
    A run stops when its code runs out of memory, with the same outcome as at the end of the run time.
    Your action
    For larger work, publish an SDK Tool that does it.
  • Limit
    Disk space
    Value
    512 MiB on each machine
    What happens
    Code on the machine cannot write more. A document copy holds only the extracted text when the original does not fit, and Duale AI refuses to copy a document whose text does not fit.
    Your action
    For larger data, publish an SDK Tool that works on it.
  • Limit
    Printed output
    Value
    A fixed amount for each run
    What happens
    Output past that amount does not reach the model. When one piece of code prints past it, that code can fail without returning any output, and the run stops there.
    Your action
    Ask the Task to print compact results, such as totals or only the rows it needs.
  • Limit
    Machine lifetime
    Value
    30 days after the machine’s last use
    What happens
    Duale AI erases the machine and its files. A continuation that runs code later starts without them.
    Your action
    Ask for the data you need in the Task’s answer, and keep it in your own system.