Actions20
- Assistant Actions
- Embedding Actions
- File Actions
- Report Actions
- Text Actions
- Thread Actions
Thread → Create
AI-generatedOverview
The "Thread - Create" operation in this node allows users to create a new conversation thread within the OpenAI Analytics API environment. This thread can optionally start with an initial message, setting the context or starting point for the conversation.
This operation is useful when you want to programmatically initiate a new dialogue session with an assistant or AI model, enabling subsequent interactions such as adding messages, running the thread, or retrieving results. For example, you might use it to start a customer support chat session, initiate a brainstorming conversation, or begin a multi-turn interaction with an AI assistant.
Properties
| Name | Meaning |
|---|---|
| Authentication | Choose which credentials to use: either dedicated OpenAI Analytics API credentials or existing OpenAI API credentials. |
| Initial Message | (Optional) The first message to add to the newly created thread, serving as the conversation's starting point or prompt. |
Output
The output of the "Create Thread" operation is a JSON object representing the newly created thread. This typically includes details such as the thread ID and any metadata returned by the OpenAI Analytics API about the thread. The exact structure depends on the API response but generally provides identifiers needed for further operations on the thread (e.g., adding messages or running the thread).
No binary data output is involved in this operation.
Dependencies
- Requires valid API authentication credentials, either:
- Dedicated OpenAI Analytics API credentials, or
- Existing OpenAI API credentials.
- The node uses the official OpenAI client library to communicate with the OpenAI Analytics API.
- Proper configuration of these credentials in n8n is necessary for successful operation.
Troubleshooting
- Credential Errors: If the node cannot load credentials, it will log errors related to credential loading. Ensure that the correct API key and optional organization ID are configured properly.
- Unsupported Resource: If a resource other than "thread" is specified with this operation, the node will throw an error indicating unsupported resource usage.
- API Communication Issues: Network problems or invalid API keys may cause failures when creating threads. Verify network connectivity and credential validity.
- Empty Initial Message: The initial message is optional; however, if provided, ensure it is a valid string to avoid unexpected behavior.