Limits, usage and polling
Each account can have 4 jobs running at once and 300 jobs per 24 hours. Longer jobs return a job id that your assistant checks until the answer arrives.
Limits
| Limit | Value |
|---|---|
| Jobs running at once, per account | 4 |
| Jobs per 24 hours, per account | 300 (failed jobs are not counted) |
| Shared beta capacity | 300 answers per UTC day across all beta testers |
Pasted material per call (context) | 800,000 characters |
my_answer | 6,000 characters |
| Citations listed under Sources | up to 24 |
| File upload, each file | 5 GB during beta |
| Upload link | works for 24 hours |
| Notes in memory | 100,000 per user |
recall_3dogs k, list_3dogs_memory limit | whole numbers 1 to 200 |
| Device command | expires if not picked up within 15 minutes |
| A job that does not finish | closed after 30 minutes and not counted against your usage |
Use is subject to plan limits. Support questions never count against usage.
What counts as a job
ask_3dogs(quick, audit, challenge and deep runs) creates one job.run_3dogs_recipecounts as a job when it runs through the ask path (the Dip & Hold screen). The Deal Letter answers from 3Dogs' latest results without starting a job.- These do not create jobs and so do not use the job limits:
check_3dogs_job,my_3dogs_usage,about_3dogs,support_3dogs,whats_new_3dogs,learn_3dogs,send_to_3dogs,transfer_status, the memory tools, the Library tools and the device tools.support_3dogs,send_to_3dogs,transfer_status,whats_new_3dogsandlearn_3dogsare described as free. Saving and recalling memory and opening a transfer still need an active free trial or plan.
Seeing your usage
my_3dogs_usage returns:
- Jobs in last 24 hours: n/300
- Jobs in flight: n/4
- Limits: 4 in-flight, 300 per 24h
- Shared beta capacity: 300 answers per UTC day across all beta testers
- Shared beta capacity left today: about n
- A plan line: your plan status, and a link to manage or cancel if you subscribe.
During the beta, it shows job counts and limits; a percent-of-allowance meter is planned to replace it when paid plans go live.
Polling
- Each
ask_3dogscall returns either a result or a job id. By default the connector waits up to 15 seconds for the result before returning a job id. - If you get a job id, your assistant calls
check_3dogs_jobwith it, withwait_secondsup to 20, until the job is done. Deep runs always return a job id. - While running, the reply is: "Job <id> is still running. Call check_3dogs_job with this job_id."
since_eventreturns findings newer than a cursor (default 0).- Job ids are private to your account: another account's job id answers "Unknown job".
When a limit is hit
- "LIMIT: too many jobs in flight": wait for a running job to finish, or check it with
check_3dogs_job. - "LIMIT: too many jobs in last 24 hours".
- "3Dogs is busy right now. Please try again in about <n> seconds." or "...in a minute."
- Running out of an allowance never locks or slows your account. Top-up purchase pages are not yet live.
Last updated 11 November 2026