Skip to content

Docs clarification: background=true + store=false support and 24-hour Interactions retention #3153

Open

Description

@hutg99

Documentation clarification (no live backend reproduction)

Two current official guides appear to disagree about Interactions API background execution and temporary result storage:

Could you clarify the current contract for the Gemini Developer API v1beta/interactions, standard model gemini-4-argon, revision 2026-05-20?

  1. Is background=true, store=false supported, with results retrievable by the returned interaction ID?
  2. If supported, what is the maximum request/result retention period, when does that clock begin, and does the same bound apply to completed, failed and cancelled interactions?
  3. Is the stated 24-hour project-retrieval TTL distinct from other provider logging/retention policies that an application must consider? Which official document defines those boundaries?
  4. If store=true is actually required, is there any officially supported at-most-24-hour background request/result retention option for a paid-tier project?

Please point to the applicable model/revision-specific documentation or correct the conflicting wording. This is a documentation question, not a claim that a particular combination has been tested. No account information, credentials, research content or provider response is included.

Activity

  1. added
    priority: p3Desirable enhancement or fix. May not be included in next release.
    type: questionRequest for information or clarification. Not an issue.
    and removed
    priority: p3Desirable enhancement or fix. May not be included in next release.
    on Oct 19, 2026
  2. Venkaiahbabuneelam commented on Oct 19, 2026

    @Venkaiahbabuneelam

    Hi @hutg99, great catch! Thank you for pointing out the conflicting wording between the Background execution and Interactions overview documentation pages.
    We have escalated this to our engineering and documentation teams to clarify the background=true + store=false retention contract and will review the documentation for potential updates.
    Thanks

  3. treyn-create commented on Oct 20, 2026

    @treyn-create

    @hutg99 we'll update the docs, thanks for flagging

    To clear things up:

    • background=true, store = false is not supported
    • All store=true interactions are retained for 55days paid (1day free tier)
    • There is no configurable 24H max ttl now. To achieve this, you can manually delete any interactions after 24H
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Labels

priority: p3Desirable enhancement or fix. May not be included in next release.type: questionRequest for information or clarification. Not an issue.

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions