Share via

OpenAI Assistants (Independent Publisher) (Preview)

  • Reference

OpenAI Assistants allows you to build AI assistants within your own applications. An Assistant has instructions and can leverage models, tools, and knowledge to respond to user queries. The Assistants service currently supports three types of tools: Code Interpreter, Retrieval, and Function calling.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Troy Taylor
URL https://www.hitachisolutions.com
Email ttaylor@hitachisolutions.com
Connector Metadata
Publisher Troy Taylor
Website https://openai.com/
Privacy policy https://openai.com/policies/privacy-policy
Categories AI

Creating a connection

The connector supports the following authentication types:
Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
API Key (in the form 'Bearer $OPENAI_API_KEY') securestring The API Key (in the form 'Bearer $OPENAI_API_KEY') for this api True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Cancel a run

Cancel a run for a thread that is in progress.
Create assistant

Create an assistant with a model and instructions.
Create assistant file

Create an assistant file by attaching a file to an assistant.
Create message

Create a message within a thread.
Create run

Creates a run for a thread.
Create thread

Creates a thread that assistants can interact with.
Create thread and run

Creates a thread and run it in one request.
Delete assistant

Deletes an assistant.
Delete assistant file

Deletes an assistant file.
Delete thread

Deletes a thread.
Get assistant files

Retrieves a list of assistant files.
Get run

Retrieve a run from a thread.
Get run step

Retrieve a run step for a thread.
Get thread

Retrieve a thread.
List assistants

Retrieves a list of assistants.
List message files

Retrieves a list of message files for a thread.
List messages

Retrieve a list of messages for a given thread.
List models

Lists the currently available models, and provides basic information about each one such as the owner and availability.
List run steps

Retrieve a list of run steps for a thread.
List runs

Retrieve a list of runs for a thread.
Modify a thread

Modifies a thread.
Modify message

Modifies a message.
Modify run

Modifies a run for a thread.
Retrieve assistant

Retrieves information about an assistant.
Retrieve assistant file

Retrieves an assistant file.
Retrieve message file

Retrieves a message file from a thread.
Submit tool outputs to run

When a run has the status: "requires_action" and required_action.type is submit_tool_outputs, this action can be used to submit the outputs from the tool calls once they're all completed.

Cancel a run

Operation ID:
RunCancelPost

Cancel a run for a thread that is in progress.

Parameters

Name Key Required Type Description
Beta Header
 OpenAI-Beta True string

The beta header. Required to be set while the API is in beta.
Thread ID
 thread_id True string

The thread identifier.
Run ID
 run_id True string

The run identifier.

Returns

Name Path Type Description
ID
 id string

The identifier.
Object
 object string

The object.
Created At
 created_at integer

When created at.
Assistant ID
 assistant_id string

The assistant identifier.
Thread ID
 thread_id string

The thread identifier.
Status
 status string

The status.
Started At
 started_at integer

When started at.
Expires At
 expires_at integer

When expires at.
Cancelled At
 cancelled_at string

When cancelled at.
Failed At
 failed_at string

When failed at.
Completed At
 completed_at string

When completed at.
Last Error
 last_error string

The last error.
Model
 model string

The model.
Instructions
 instructions string

The instructions.
Tools
 tools array of object
Type
 tools.type string

The tools type.
File IDs
 file_ids array of string

The file identifiers.

Create assistant

Operation ID:
AssistantPost

Create an assistant with a model and instructions.

Parameters

Name Key Required Type Description
Beta Header
 OpenAI-Beta True string

The beta header. Required to be set while the API is in beta.
Model
 model True string

The model.
Instructions
 instructions string

The instructions.
Name
 name string

The name.
Description
 description string

The description.
Type
 type string

The tools type.
File IDs
 file_ids array of string

The file identifiers.

Returns

Name Path Type Description
ID
 id string

The identifier.
Object
 object string

The object.
Created At
 created_at integer

When created at.
Name
 name string

The name.
Description
 description string

The description.
Model
 model string

The model.
Instructions
 instructions string

The instructions.
Tools
 tools array of object
Type
 tools.type string

The tool type.
File IDs
 file_ids array of string

The file identifiers.

Create assistant file

Operation ID:
FilePost

Create an assistant file by attaching a file to an assistant.

Parameters

Name Key Required Type Description
Beta Header
 OpenAI-Beta True string

The beta header. Required to be set while the API is in beta.
Assistant ID
 assistant_id True string

The assistant identifier.
File ID
 file_id True string

The file identifier.

Returns

Name Path Type Description
ID
 id string

The identifier.
Object
 object string

The object.
Created At
 created_at integer

When created at.
Assistant ID
 assistant_id string

The assistant identifier.

Create message

Operation ID:
MessagePost

Create a message within a thread.

Parameters

Name Key Required Type Description
Beta Header
 OpenAI-Beta True string

The beta header. Required to be set while the API is in beta.
Thread ID
 thread_id True string

The thread identifier.

Returns

Name Path Type Description
ID
 id string

The identifier.
Object
 object string

The object.
Created At
 created_at integer

When created at.
Thread ID
 thread_id string

The thread identifier.
Role
 role string

The role.
Content
 content array of object
Type
 content.type string

The tools type.
Value
 content.text.value string

The value.
Annotations
 content.text.annotations array of string

The annotations.
File IDs
 file_ids array of string

The file identifiers.
Assistant ID
 assistant_id string

The assistant identifier.
Run ID
 run_id string

The run identifier.

Create run

Operation ID:
RunPost

Creates a run for a thread.

Parameters

Name Key Required Type Description
Beta Header
 OpenAI-Beta True string

The beta header. Required to be set while the API is in beta.
Thread ID
 thread_id True string

The thread identifier.
Assistant ID
 assistant_id string

The assistant identifier.
Model
 model True string

The model.
Instructions
 instructions string

The instructions.
Type
 type string

The tools type.

Returns

Name Path Type Description
ID
 id string

The identifier.
Object
 object string

The object.
Created At
 created_at integer

When created at.
Assistant ID
 assistant_id string

The assistant identifier.
Thread ID
 thread_id string

The thread identifier.
Status
 status string

The status.
Started At
 started_at integer

When started at.
Expires At
 expires_at string

When expires at.
Cancelled At
 cancelled_at string

When cancelled at.
Failed At
 failed_at string

When failed at.
Completed At
 completed_at integer

When completed at.
Last Error
 last_error string

The last error.
Model
 model string

The model.
Instructions
 instructions string

The instructions.
Tools
 tools array of object
Type
 tools.type string

The tools type.
File IDs
 file_ids array of string

The file identifiers.

Create thread

Operation ID:
ThreadPost

Creates a thread that assistants can interact with.

Parameters

Name Key Required Type Description
Beta Header
 OpenAI-Beta True string

The beta header. Required to be set while the API is in beta.
ID
 id string

The identifier.
Object
 object string

The object.
Created At
 created_at integer

When created at.
Thread ID
 thread_id string

The thread identifier.
Role
 role True string

The role.
Content
 content True string

The content.
File IDs
 file_ids array of string

The file identifiers.
Assistant ID
 assistant_id string

The assistant identifier.
Run ID
 run_id string

The run identifier.

Returns

Name Path Type Description
ID
 id string

The identifier.
Object
 object string

The object.
Created At
 created_at integer

When created at.

Create thread and run

Operation ID:
ThreadRunPost

Creates a thread and run it in one request.

Parameters

Name Key Required Type Description
Beta Header
 OpenAI-Beta True string

The beta header. Required to be set while the API is in beta.
Assistant ID
 assistant_id string

The assistant identifier.
Role
 role string

The role.
Content
 content string

The content.
Model
 model string

The model.
Intructions
 instructions string

The instructions.
Type
 type string

The tools type.

Returns

Name Path Type Description
ID
 id string

The identifier.
Object
 object string

The object.
Created At
 created_at integer

When created at.
Assistant ID
 assistant_id string

The assistant identifier.
Thread ID
 thread_id string

The thread identifier.
Status
 status string

The status.
Started At
 started_at string

When started at.
Expires At
 expires_at integer

When expires at.
Cancelled At
 cancelled_at string

When cancelled at.
Failed At
 failed_at string

When failed at.
Completed At
 completed_at string

When completed at.
Last Error
 last_error string

The last error.
Model
 model string

The model.
Instructions
 instructions string

The instructions.
Tools
 tools array of object
Type
 tools.type string

The tools type.
File IDs
 file_ids array of string

The file identifiers.

Delete assistant

Operation ID:
AssistantDelete

Deletes an assistant.

Parameters

Name Key Required Type Description
Beta Header
 OpenAI-Beta True string

The beta header. Required to be set while the API is in beta.
Assistant ID
 assistant_id True string

The assistant identifier.

Returns

Name Path Type Description
ID
 id string

The identifier.
Object
 object string

The object.
Deleted
 deleted boolean

Whether deleted.

Delete assistant file

Operation ID:
FileDelete

Deletes an assistant file.

Parameters

Name Key Required Type Description
Beta Header
 OpenAI-Beta True string

The beta header. Required to be set while the API is in beta.
Assistant ID
 assistant_id True string

The assistant identifier.
File ID
 file_id True string

The file identifier.

Returns

Name Path Type Description
ID
 id string

The identifier.
Object
 object string

The object.
Deleted
 deleted boolean

Whether deleted.

Delete thread

Operation ID:
ThreadDelete

Deletes a thread.

Parameters

Name Key Required Type Description
Beta Header
 OpenAI-Beta True string

The beta header. Required to be set while the API is in beta.
Thread ID
 thread_id True string

The thread identifier.

Returns

Name Path Type Description
ID
 id string

The identifier.
Object
 object string

The object.
Deleted
 deleted boolean

Whether deleted.

Get assistant files

Operation ID:
FilesGet

Retrieves a list of assistant files.

Parameters

Name Key Required Type Description
Beta Header
 OpenAI-Beta True string

The beta header. Required to be set while the API is in beta.
Assistant ID
 assistant_id True string

The assistant identifier.

Returns

Name Path Type Description
Object
 object string

The object.
Data
 data array of object
ID
 data.id string

The identifier.
Object
 data.object string

The object.
Created At
 data.created_at integer

When created at.
Assistant ID
 data.assistant_id string

The assistant identifier.
First ID
 first_id string

The first identifier.
Last ID
 last_id string

The last identifier.
Has More
 has_more boolean

Whether has more.

Get run

Operation ID:
RunGet

Retrieve a run from a thread.

Parameters

Name Key Required Type Description
Beta Header
 OpenAI-Beta True string

The beta header. Required to be set while the API is in beta.
Thread ID
 thread_id True string

The thread identifier.
Run ID
 run_id True string

The run identifier.

Returns

Name Path Type Description
ID
 id string

The identifier.
Object
 object string

The object.
Created At
 created_at integer

When created at.
Assistant ID
 assistant_id string

The assistant identifier.
Thread ID
 thread_id string

The thread identifier.
Status
 status string

The status.
Started At
 started_at integer

When started at.
Expires At
 expires_at string

When expires at.
Cancelled At
 cancelled_at string

When cancelled at.
Failed At
 failed_at string

When failed at.
Completed At
 completed_at integer

When completed at.
Last Error
 last_error string

The last error.
Model
 model string

The model.
Instructions
 instructions string

The instructions.
Tools
 tools array of object
Type
 tools.type string

The tools type.
File IDs
 file_ids array of string

The file identifiers.

Get run step

Operation ID:
RunStepGet

Retrieve a run step for a thread.

Parameters

Name Key Required Type Description
Beta Header
 OpenAI-Beta True string

The beta header. Required to be set while the API is in beta.
Thread ID
 thread_id True string

The thread identifier.
Run ID
 run_id True string

The run identifier.
Step ID
 step_id True string

The step identifier.

Returns

Name Path Type Description
ID
 id string

The identifier.
Object
 object string

The object.
Created At
 created_at integer

When created at.
Run ID
 run_id string

The run identifier.
Assistant ID
 assistant_id string

The assistant identifier.
Thread ID
 thread_id string

The thread identifier.
Type
 type string

The type.
Status
 status string

The status.
Cancelled At
 cancelled_at string

When cancelled at.
Completed At
 completed_at integer

When completed at.
Expired At
 expired_at string

When expired at.
Failed At
 failed_at string

When failed at.
Last Error
 last_error string

The last error.
Type
 step_details.type string

The type.
Message ID
 step_details.message_creation.message_id string

The message identifier.

Get thread

Operation ID:
ThreadGet

Retrieve a thread.

Parameters

Name Key Required Type Description
Beta Header
 OpenAI-Beta True string

The beta header. Required to be set while the API is in beta.
Thread ID
 thread_id True string

The thread identifier.

Returns

Name Path Type Description
ID
 id string

The identifier.
Object
 object string

The object.
Created At
 created_at integer

When created at.

List assistants

Operation ID:
AssistantsGet

Retrieves a list of assistants.

Parameters

Name Key Required Type Description
Beta Header
 OpenAI-Beta True string

The beta header. Required to be set while the API is in beta.

Returns

Name Path Type Description
Object
 object string

The object.
Data
 data array of object
ID
 data.id string

The identifier.
Object
 data.object string

The object.
Created At
 data.created_at integer

When created at.
Name
 data.name string

The name.
Description
 data.description string

The description.
Model
 data.model string

The model.
Instructions
 data.instructions string

The instructions.
Tools
 data.tools array of object
Type
 data.tools.type string

The type.
File IDs
 data.file_ids array of string

The file identifiers.
First ID
 first_id string

The first identifier.
Last ID
 last_id string

The last identifier.
Has More
 has_more boolean

Whether has more.

List message files

Operation ID:
MessageFilesGet

Retrieves a list of message files for a thread.

Parameters

Name Key Required Type Description
Beta Header
 OpenAI-Beta True string

The beta header. Required to be set while the API is in beta.
Thread ID
 thread_id True string

The thread identifier.
Message ID
 message_id True string

The message identifier.

Returns

Name Path Type Description
Object
 object string

The object.
Data
 data array of object
ID
 data.id string

The identifier.
Object
 data.object string

The object.
Created At
 data.created_at integer

When created at.
Message ID
 data.message_id string

The message identifier.
First ID
 first_id string

The first identifier.
Last ID
 last_id string

The last identifier.
Has More
 has_more boolean

Whether has more.

List messages

Operation ID:
MessagesGet

Retrieve a list of messages for a given thread.

Parameters

Name Key Required Type Description
Beta Header
 OpenAI-Beta True string

The beta header. Required to be set while the API is in beta.
Thread ID
 thread_id True string

The thread identifier.
Limit
 limit integer

The limit.
Order
 order string

The order.
After
 after string

The after.
Before
 before string

The before.

Returns

Name Path Type Description
Object
 object string

The object.
Data
 data array of object
ID
 data.id string

The identifier.
Object
 data.object string

The object.
Created At
 data.created_at integer

When created at.
Thread ID
 data.thread_id string

The thread identifier.
Role
 data.role string

The role.
Content
 data.content array of object
Type
 data.content.type string

The type.
Value
 data.content.text.value string

The value.
Annotations
 data.content.text.annotations array of string

The annotations.
File IDs
 data.file_ids array of string

The file identifiers.
Assistant ID
 data.assistant_id string

The assistant identifier.
Run ID
 data.run_id string

The run identifier.
First ID
 first_id string

The first identifier.
Last ID
 last_id string

The last identifier.
Has More
 has_more boolean

Whether has more.

List models

Operation ID:
ModelsGet

Lists the currently available models, and provides basic information about each one such as the owner and availability.

Returns

Name Path Type Description
Object
 object string

The object.
Data
 data array of object
ID
 data.id string

The identifier.
Object
 data.object string

The object.
Created
 data.created integer

When created.
Owned By
 data.owned_by string

Owned by.

List run steps

Operation ID:
RunStepsGet

Retrieve a list of run steps for a thread.

Parameters

Name Key Required Type Description
Beta Header
 OpenAI-Beta True string

The beta header. Required to be set while the API is in beta.
Thread ID
 thread_id True string

The thread identifier.
Run ID
 run_id True string

The run identifier.
Limit
 limit integer

The limit.
Order
 order string

The order.
After
 after string

The after.
Before
 before string

The before.

Returns

Name Path Type Description
Object
 object string

The object.
Data
 data array of object
ID
 data.id string

The identifier.
Object
 data.object string

The object.
Created At
 data.created_at integer

When created at.
Run ID
 data.run_id string

The run identifier.
Assistant ID
 data.assistant_id string

The assistant identifier.
Thread ID
 data.thread_id string

The thread identifier.
Type
 data.type string

The tools type.
Status
 data.status string

The status.
Cancelled At
 data.cancelled_at string

When cancelled at.
Completed At
 data.completed_at integer

When completed at.
Expired At
 data.expired_at string

When expired at.
Failed At
 data.failed_at string

When failed at.
Last Error
 data.last_error string

The last error.
Type
 data.step_details.type string

The type.
Message ID
 data.step_details.message_creation.message_id string

The message identifier.
First ID
 first_id string

The first identifier.
Last ID
 last_id string

The last identifier.
Has More
 has_more boolean

Whether has more.

List runs

Operation ID:
RunsGet

Retrieve a list of runs for a thread.

Parameters

Name Key Required Type Description
Beta Header
 OpenAI-Beta True string

The beta header. Required to be set while the API is in beta.
Thread ID
 thread_id True string

The thread identifier.
Limit
 limit integer

The limit.
Order
 order string

The order.
After
 after string

The after.
Before
 before string

The before.

Returns

Name Path Type Description
Object
 object string

The object.
Data
 data array of object
ID
 data.id string

The identifier.
Object
 data.object string

The object.
Created At
 data.created_at integer

When created at.
Assistant ID
 data.assistant_id string

The assistant identifier.
Thread ID
 data.thread_id string

The thread identifier.
Status
 data.status string

The status.
Started At
 data.started_at integer

When started at.
Expires At
 data.expires_at string

When expires at.
Cancelled At
 data.cancelled_at string

When cancelled at.
Failed At
 data.failed_at string

When failed at.
Completed At
 data.completed_at integer

When completed at.
Last Error
 data.last_error string

The last error.
Model
 data.model string

The model.
Instructions
 data.instructions string

The instructions.
Tools
 data.tools array of object
Type
 data.tools.type string

The type.
File IDs
 data.file_ids array of string

The file identifiers.
First ID
 first_id string

The first identifier.
Last ID
 last_id string

The last identifier.
Has More
 has_more boolean

Whether has more.

Modify a thread

Operation ID:
ThreadModifyPost

Modifies a thread.

Parameters

Name Key Required Type Description
Beta Header
 OpenAI-Beta True string

The beta header. Required to be set while the API is in beta.
Thread ID
 thread_id True string

The thread identifier.

Returns

Name Path Type Description
ID
 id string

The identifier.
Object
 object string

The object.
Created At
 created_at integer

When created at.

Modify message

Operation ID:
MessageModifyPost

Modifies a message.

Parameters

Name Key Required Type Description
Beta Header
 OpenAI-Beta True string

The beta header. Required to be set while the API is in beta.
Thread ID
 thread_id True string

The thread identifier.
Message ID
 message_id True string

The message identifier.

Returns

Name Path Type Description
ID
 id string

The identifier.
Object
 object string

The object.
Created At
 created_at integer

When created at.
Thread ID
 thread_id string

The thread identifier.
Role
 role string

The role.
Content
 content array of object
Type
 content.type string

The tools type.
Value
 content.text.value string

The value.
Annotations
 content.text.annotations array of string

The annotations.
File IDs
 file_ids array of string

The file identifiers.
Assistant ID
 assistant_id string

The assistant identifier.
Run ID
 run_id string

The run identifier.

Modify run

Operation ID:
RunModifyPost

Modifies a run for a thread.

Parameters

Name Key Required Type Description
Beta Header
 OpenAI-Beta True string

The beta header. Required to be set while the API is in beta.
Thread ID
 thread_id True string

The thread identifier.
Run ID
 run_id True string

The run identifier.

Returns

Name Path Type Description
ID
 id string

The identifier.
Object
 object string

The object.
Created At
 created_at integer

When created at.
Assistant ID
 assistant_id string

The assistant identifier.
Thread ID
 thread_id string

The thread identifier.
Status
 status string

The status.
Started At
 started_at integer

When started at.
Expires At
 expires_at string

When expires at.
Cancelled At
 cancelled_at string

When cancelled at.
Failed At
 failed_at string

When failed at.
Completed At
 completed_at integer

When completed at.
Last Error
 last_error string

The last error.
Model
 model string

The model.
Instructions
 instructions string

The instructions.
Tools
 tools array of object
Type
 tools.type string

The tools type.
File IDs
 file_ids array of string

The file identifiers.

Retrieve assistant

Operation ID:
AssistantGet

Retrieves information about an assistant.

Parameters

Name Key Required Type Description
Beta Header
 OpenAI-Beta True string

The beta header. Required to be set while the API is in beta.
Assistant ID
 assistant_id True string

The assistant identifier.

Returns

Name Path Type Description
ID
 id string

The identifier.
Object
 object string

The object.
Created At
 created_at integer

When created at.
Name
 name string

The name.
Description
 description string

The description.
Model
 model string

The model.
Instructions
 instructions string

The instructions.
Tools
 tools array of object
Type
 tools.type string

The tools type.
File IDs
 file_ids array of string

The file identifiers.

Retrieve assistant file

Operation ID:
FileGet

Retrieves an assistant file.

Parameters

Name Key Required Type Description
Beta Header
 OpenAI-Beta True string

The beta header. Required to be set while the API is in beta.
Assistant ID
 assistant_id True string

The assistant identifier.
File ID
 file_id True string

The file identifier.

Returns

Name Path Type Description
ID
 id string

The identifier.
Object
 object string

The object.
Created At
 created_at integer

When created at.
Assistant ID
 assistant_id string

The assistant identifier.

Retrieve message file

Operation ID:
MessageFileGet

Retrieves a message file from a thread.

Parameters

Name Key Required Type Description
Beta Header
 OpenAI-Beta True string

The beta header. Required to be set while the API is in beta.
Thread ID
 thread_id True string

The thread identifier.
Message ID
 message_id True string

The message identifier.
File ID
 file_id True string

The file identifier.

Returns

Name Path Type Description
ID
 id string

The identifier.
Object
 object string

The object.
Created At
 created_at integer

When created at.
Message ID
 message_id string

The message identifier.

Submit tool outputs to run

Operation ID:
RunToolOutputsPost

When a run has the status: "requires_action" and required_action.type is submit_tool_outputs, this action can be used to submit the outputs from the tool calls once they're all completed.

Parameters

Name Key Required Type Description
Beta Header
 OpenAI-Beta True string

The beta header. Required to be set while the API is in beta.
Thread ID
 thread_id True string

The thread identifier.
Run ID
 run_id True string

The run identifier.
Tool Call ID
 tool_call_id string

The toll call identifier.
Output
 output string

The output.

Returns

Name Path Type Description
ID
 id string

The identifier.
Object
 object string

The object.
Created At
 created_at integer

When created at.
Assistant ID
 assistant_id string

The assistant identifier.
Thread ID
 thread_id string

The thread identifier.
Status
 status string

The status.
Started At
 started_at integer

When started at.
Expires At
 expires_at integer

When expires at.
Cancelled At
 cancelled_at string

When cancelled at.
Failed At
 failed_at string

When failed at.
Completed At
 completed_at string

When completed at.
Last Error
 last_error string

The last error.
Model
 model string

The model.
Instructions
 instructions string

The instructions.
Tools
 tools array of object
Type
 tools.type string

The tools type.
Name
 tools.function.name string

The name.
Description
 tools.function.description string

The description.
Type
 tools.function.parameters.type string

The type.
File IDs
 file_ids array of string

The file identifiers.