GPT models for every AI feature and AI step, and the embeddings knowledge-source search uses.
Explore 35 workflow actions for OpenAI, including account permissions and operation limits.
23 read actions12 write actions
WORKFLOW ACTIONS
What you can configure.
Choose an action in the workflow builder, connect an account, and map its inputs. These actions are available in the catalog; your account access and a successful test determine whether they work for your setup.
Add conversation items
Write
Add up to 20 text messages to one Responses API conversation.
Permissions and limits
Account permissions
Conversations:write
Operation limits
Only text messages are supported. A lost response is uncertain and the write is not retried.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Analyze image
Read
Ask a question about one protected workflow image and return bounded text.
Permissions and limits
Account permissions
chat.completions:write
Operation limits
One PNG, JPEG or WebP input at most 16 MB. Returns descriptive text, not a structured decision. Charged requests are sent once.
Create chat completion
Read
Generate one text reply from a bounded conversation using Chat Completions.
Permissions and limits
Account permissions
chat.completions:write
Operation limits
One completion with at most 20 messages and 2,048 completion tokens. Structured output uses a bounded strict JSON Schema subset. Charged requests are sent once. Model-specific unsupported options are returned as provider errors.
Create conversation
Write
Create a Responses API conversation in the selected OpenAI project.
Permissions and limits
Account permissions
Conversations:write
Operation limits
Initial items support text messages only. A lost create response is uncertain and is not retried.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create reusable agent
Write
Create a reusable OpenAI agent with a model, instructions and metadata.
Permissions and limits
Account permissions
Agents:write beta access
Operation limits
Model, name, instructions and metadata only; tool and reasoning configuration are not exposed. A lost create response is uncertain and is not retried.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create text embedding
Read
Embed one text input with an OpenAI text-embedding-3 model.
Permissions and limits
Account permissions
embeddings:write
Operation limits
One text input at a time, at most 8000 characters. Charged calls are never retried after an uncertain response.
Create text embeddings
Read
Embed up to 20 text inputs in one OpenAI request.
Permissions and limits
Account permissions
embeddings:write
Operation limits
One to 20 text inputs, each at most 8000 characters. Charged calls are never retried after an uncertain response.
Delete conversation
Write
Delete a Responses API conversation without deleting its items.
Permissions and limits
Account permissions
Conversations:write
Operation limits
OpenAI keeps the conversation's items after deletion. A lost response is uncertain and is not retried.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete conversation item
Write
Delete an item from a Responses API conversation.
Permissions and limits
Account permissions
Conversations:write
Operation limits
The provider returns the parent conversation as the deletion receipt. A lost response is uncertain and is not retried.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete file
Write
Permanently delete a file from the selected OpenAI project.
Permissions and limits
Account permissions
Files:write
Operation limits
OpenAI also removes a deleted file from its vector stores. A lost response is uncertain and is not retried.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete reusable agent
Write
Delete one reusable agent after OpenAI confirms the deletion.
Permissions and limits
Account permissions
Agents:write beta access
Operation limits
A lost delete response is uncertain and is not retried.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Download file content
Read
Save OpenAI file content to this workflow's protected file store.
Permissions and limits
Account permissions
Files:read
Operation limits
The selected OpenAI file must be at most 16 MB. Availability of file content depends on its purpose and account permissions.
Edit image
Read
Edit a protected workflow image, optionally using an alpha mask, and save one PNG result.
Permissions and limits
Account permissions
Images:write
Operation limits
One source image and optional same-size PNG alpha mask, each at most 16 MB. One PNG output at most 16 MB. A charged request is sent once.
Generate a response
Read
Generate text or schema-constrained JSON with the OpenAI Responses API using the selected account.
Permissions and limits
Account permissions
responses:write
Generate image
Read
Generate one PNG image and save it as a protected workflow file.
Permissions and limits
Account permissions
Images:write
Operation limits
One PNG per call, at most 16 MB. A charged request is never retried after an uncertain response. Requires workflow file storage.
Generate speech
Read
Generate MP3 speech from text and save it as a protected workflow file.
Permissions and limits
Account permissions
Audio:write
Operation limits
One MP3 per call, at most 16 MB. Paid generation is attempted once. Requires protected workflow file storage.
Get agent session
Read
Read an OpenAI agent session's current status.
Permissions and limits
Account permissions
Agents:read beta access
Operation limits
Status is a snapshot. Read session items to inspect the agent's output.
Get conversation
Read
Read one Responses API conversation.
Permissions and limits
Account permissions
Conversations:read
Operation limits
Returns conversation metadata, not its items.
Get conversation item
Read
Read one item from a Responses API conversation.
Permissions and limits
Account permissions
Conversations:read
Get file
Read
Read metadata for one file in the selected OpenAI project.
Permissions and limits
Account permissions
Files:read
Operation limits
Returns metadata, not the file content.
Get reusable agent
Read
Read one reusable agent from the connected OpenAI project.
Permissions and limits
Account permissions
Agents:read beta access
List agent session items
Read
Inspect one bounded page of messages and other items produced by an OpenAI agent session.
Permissions and limits
Account permissions
Agents:read beta access
Operation limits
Returns one page of at most 100 root-agent items. Use last_id as after to continue. A message item must have completed status and final_answer phase to count as a final reply.
Pagination: cursor. Check the result for additional pages; a single action may not return every record.
List conversation items
Read
List one bounded page of items in a Responses API conversation.
Permissions and limits
Account permissions
Conversations:read
Operation limits
Returns at most 100 items. Use last_id as after while has_more is true.
Pagination: cursor. Check the result for additional pages; a single action may not return every record.
List files
Read
Read one bounded page of files in the selected OpenAI project.
Permissions and limits
Account permissions
Files:read
Operation limits
Returns at most 100 files. Pass last_id as after while has_more is true to read another page.
Pagination: cursor. Check the result for additional pages; a single action may not return every record.
List models
Read
Read models available to the selected OpenAI connection.
Permissions and limits
Account permissions
models:read
Pagination: limited. Check the result for additional pages; a single action may not return every record.
List reusable agents
Read
List one bounded page of reusable agents in the connected OpenAI project.
Permissions and limits
Account permissions
Agents:read beta access
Operation limits
Returns one page of at most 100. Pass last_id as after for the next page.
Pagination: cursor. Check the result for additional pages; a single action may not return every record.
Moderate image
Read
Classify one protected workflow image with OpenAI moderation and return category flags and scores without returning image bytes.
Permissions and limits
Account permissions
moderations:write
Operation limits
One protected PNG, JPEG, WebP or GIF at most 16 MB. OpenAI supports image moderation up to 20 MB, but NodeHub keeps the workflow file limit at 16 MB. Image-only requests return empty applied-input lists for text-only categories. A lost response is not retried automatically.
Moderate text
Read
Classify one text input with OpenAI moderation and return category flags and scores without repeating the text.
Permissions and limits
Account permissions
moderations:write
Operation limits
One nonempty text input of at most 8000 characters. The model can change behind the latest alias; score-based policy thresholds require review. A lost response is not retried automatically.
Start agent session
Write
Start a turn with a saved OpenAI agent and return its session ID and current status.
Permissions and limits
Account permissions
Agents:write beta access
Operation limits
Uses an execution environment of type none. The returned status is a snapshot, not a final reply. Saved agent tools may still require actions. A lost create response is uncertain and is not retried.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Submit agent session message
Write
Submit one user message to an existing OpenAI agent session and report acceptance only.
Permissions and limits
Account permissions
Agents:write beta access
Operation limits
HTTP 202 confirms acceptance, not durable processing or a completed reply. Read the session and its items to inspect the outcome. A lost response is uncertain and is not retried.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Transcribe audio
Read
Transcribe a protected audio file into text in its original language.
Permissions and limits
Account permissions
Audio:write
Operation limits
One protected audio file up to 16 MB. JSON text response only. Paid calls are sent once and not retried after an uncertain outcome.
Translate audio to English
Read
Translate a protected audio file into English text.
Permissions and limits
Account permissions
Audio:write
Operation limits
One protected audio file up to 16 MB. OpenAI currently supports whisper-1 for translation. JSON text response only. Paid calls are sent once.
Update conversation metadata
Write
Replace metadata on one Responses API conversation.
Permissions and limits
Account permissions
Conversations:write
Operation limits
Replaces the conversation metadata. A lost response is uncertain and is not retried.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update reusable agent
Write
Change the model, name, instructions or metadata of one reusable agent.
Permissions and limits
Account permissions
Agents:write beta access
Operation limits
Omitted fields stay unchanged. Null resets, tools and reasoning configuration are not exposed. A lost response is uncertain and is not retried.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Upload file
Write
Upload a protected workflow file to the selected OpenAI project.
Permissions and limits
Account permissions
Files:write
Operation limits
Uploads a protected workflow file of at most 16 MB. Optional expiry uses OpenAI's created_at anchor, one hour to 30 days. OpenAI's file format requirements depend on the selected purpose. A lost response is uncertain and is not retried.
A repeated request may repeat the external action. Review the previous result before retrying a write.
SETUP
Start with a controlled test.
01Connect the intended account
Use the account and permissions required for your process. Review the connection check before configuring a workflow action.
02Review inputs and access
Select a listed operation and map its required inputs. Use test records and add a human approval before writes that need review.
03Confirm the result
Inspect step outputs and confirm the result in OpenAI. A saved workflow is not a completed provider action.
AI models ยท CONNECTION
