Skip to main content
POMA Grill logo
  • Category: ai agents
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 18
  • Triggers: 0
  • Slug: POMA_GRILL
  • Version: 20261101_00

Tools

Slug: POMA_GRILL_CANCEL_BUCKET_INGEST_TASKIrreversibly cancel a non-terminal POMA Grill bucket-ingest task. Already terminal tasks cannot be cancelled.

Input Parameters

string
required
Bucket-ingest task UUID returned by Submit Bucket Ingest.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: POMA_GRILL_CANCEL_INGEST_JOBRequest best-effort cancellation and removal of an ingestion job. A successful response does not guarantee that completed job metadata disappears.

Input Parameters

string
required
Exact ingestion job UUID to cancel or remove.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: POMA_GRILL_DELETE_DOCUMENTDelete one selected indexed document and its vectors. The response reports whether its stored content and assets were removed; the action cannot be undone.

Input Parameters

string
required
Exact document UUID to permanently remove; obtain and verify it with List Documents or Get Document first.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: POMA_GRILL_GET_BUCKET_INGEST_TASKGet the current state, progress, processing rate, credential status, and recent failures for a POMA Grill bucket-ingest task.

Input Parameters

string
required
Bucket-ingest task UUID returned by Submit Bucket Ingest.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: POMA_GRILL_GET_DOCUMENTGet metadata for one indexed document by its document ID.

Input Parameters

string
required
Document UUID returned by ingestion, search, or List Documents.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: POMA_GRILL_GET_INGEST_JOBGet an ingestion job’s current status and usage; poll this after Ingest Document until status is done, failed, or blocked. Grill jobs may pass through indexing before reaching a terminal state.

Input Parameters

string
required
Ingestion job UUID returned by Ingest Document.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: POMA_GRILL_INGEST_DOCUMENTUpload one file or provide one public remote URL for asynchronous indexing, and return the ingestion job ID to poll with Get Ingest Job.

Input Parameters

object
File content to upload and index; the single-upload body limit is 50 MB. Provide exactly one of file or remote_url.
array
Optional labels to attach for later filtering; at most 64 labels, 128 characters each, and 4096 serialized characters total.
object
Typed document attributes. Names must be lowercase letters, digits, or underscores and at most 64 characters; serialized JSON is capped at 2048 characters.
integer
Deprecated customer integer metadata for range queries.
integer
Deprecated customer integer metadata for range queries.
string
Publicly accessible URL for POMA to fetch instead of uploading a file. Provide exactly one of remote_url or file.
string
Citation URL associated with the ingested document.
object
Types for newly introduced attributes, required for datetime and encrypted_text values. Serialized JSON is capped at 2048 characters.
object
Plaintext string metadata for glob filtering; at most 32 keys and 16384 serialized characters. Keys use letters, digits, or underscores.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: POMA_GRILL_LIST_BUCKET_INGEST_FAILURESReturn one page of failed items for a bucket ingest task, ordered by item ID, with an opaque cursor for the next page.

Input Parameters

integer
Maximum failed items to return in this page (1-1000).
string
Opaque continuation cursor returned by the previous call. Omit it for the first page and pass it back unchanged for the next page.
string
required
Bucket-ingest task UUID returned by Submit Bucket Ingest.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: POMA_GRILL_LIST_DOCUMENTSList one page of document metadata from the connected project.

Input Parameters

integer
Maximum documents to return on this page; omit for legacy list behavior.
string
Opaque pagination cursor from a previous response; pass it unchanged and omit it for the first page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: POMA_GRILL_PAUSE_BUCKET_INGEST_TASKPause a non-terminal bucket ingest task in paused_user state. Processing halts on the next scheduler tick while the task continues to occupy its account’s active-task slot.

Input Parameters

string
required
Bucket-ingest task UUID returned by Submit Bucket Ingest.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: POMA_GRILL_PREVIEW_BUCKET_INGESTValidate S3 or GCS credentials and preview matching source objects without creating a bucket-ingest task. Sensitive credentials are sent to POMA and exposed to the action execution environment.

Input Parameters

object
required
Source bucket and the credentials POMA uses to list and read it.
object
Optional customer-owned destination for processed results; omit to keep results only in POMA-managed storage.
string
Optional object-key glob such as “*.pdf”; nonmatching files are skipped.
boolean
Set true to acknowledge estimated egress cost when the provider requires confirmation for a destination transfer.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: POMA_GRILL_RESUME_BUCKET_INGEST_TASKResume a bucket ingest task paused by the user, restoring its pre-pause state and waking processing for the next scheduler tick.

Input Parameters

string
required
Bucket-ingest task UUID returned by Submit Bucket Ingest.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: POMA_GRILL_RETRY_BUCKET_INGEST_FAILURESRetry all or selected failed items in a bucket ingest task that is in done_with_errors or materialising. Refresh purged source credentials first.

Input Parameters

string
required
Bucket-ingest task UUID returned by Submit Bucket Ingest.
array
Failed item UUIDs to retry. Omit or pass an empty list to retry every failed item in the task.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: POMA_GRILL_SEARCH_DOCUMENTSSearch indexed content across the project or within one document, returning either prompt-ready context or structured matching chunks.

Input Parameters

string
required
Natural-language or keyword query to retrieve relevant indexed content.
string ("prompt_ready" | "json")
Response form: prompt_ready for assembled context or json for structured chunks and relevance scores.
array
Restrict search to at most 100 document IDs.
boolean
Enable premium retrieval features such as reranking.
array
Deprecated alias for meta_tags_all.
array
Deprecated alias for meta_tags_any.
integer
Hard maximum context size in estimated tokens (100-500000). When below target_tokens, POMA clamps the soft target down to this ceiling.
string
Optional document UUID. When set, search only that document; otherwise search the full project namespace.
array
Deprecated label filter requiring all listed metadata tags.
array
Deprecated label filter requiring any listed metadata tag.
number
Optional minimum relevance threshold from 0 to 1 for returned matches.
boolean
Return extracted figures and tables referenced by included documents.
integer
Preferred context size in estimated tokens (100-500000).
integer
Deprecated inclusive lower bound for metadata integer field 1.
integer
Deprecated inclusive upper bound for metadata integer field 1.
integer
Deprecated inclusive lower bound for metadata integer field 2.
integer
Deprecated inclusive upper bound for metadata integer field 2.
string
Retrieval tier override, such as free, standard, or premium.
array
Exclude at most 100 document IDs from search results.
number
Controls how aggressively context is expanded around hits, from 0 to 1.
array
Up to 32 typed attribute clauses, combined with AND.
number
Return no results when the top result scores below this 0-1 threshold.
object
Ingest-time unencrypted string keys mapped to case-insensitive Unix glob patterns.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: POMA_GRILL_SUBMIT_BUCKET_INGESTCreate an asynchronous task to ingest matching objects from an S3 or GCS bucket into POMA Grill, optionally delivering results to another bucket. Source and destination credentials are sensitive inputs sent to POMA and exposed to the action execution environment.

Input Parameters

object
required
Source bucket and the credentials POMA uses to list and read it.
object
Optional customer-owned destination for processed results; omit to keep results only in POMA-managed storage.
string
Optional object-key glob such as “*.pdf”; nonmatching files are skipped.
boolean
Set true to acknowledge estimated egress cost when the provider requires confirmation for a destination transfer.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: POMA_GRILL_SUBMIT_BUCKET_INGEST_ECO_LEGACYDeprecated compatibility route for creating a POMA Grill bucket-ingest task. Use Submit Bucket Ingest for new calls; POMA documents both routes as behaviorally identical.

Input Parameters

object
required
Source bucket and the credentials POMA uses to list and read it.
object
Optional customer-owned destination for processed results; omit to keep results only in POMA-managed storage.
string
Optional object-key glob such as “*.pdf”; nonmatching files are skipped.
boolean
Set true to acknowledge estimated egress cost when the provider requires confirmation for a destination transfer.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: POMA_GRILL_UPDATE_BUCKET_INGEST_CREDENTIALSReplace and validate the source credentials for an active bucket ingest task. A task paused for a source credential error resumes materialising on success.

Input Parameters

string
required
Bucket-ingest task UUID returned by Submit Bucket Ingest.
object
required
Replacement sensitive access details for the task’s source bucket. POMA validates and stores them encrypted for this task.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: POMA_GRILL_UPDATE_DOCUMENT_ATTRIBUTESSet, change, or remove selected typed attributes on one indexed document. Null attribute values remove those attributes; omitted names are unchanged.

Input Parameters

object
required
Attribute names to set, update, or remove. A null value removes that attribute; omitted names remain unchanged.
string
required
Document identifier returned by ingestion, search, or List Documents.
object
Types for attributes first introduced to the namespace. Required for datetime and encrypted_text values; declare only names in attributes.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not