OpenAI Assistants (Independent Publisher) (Preview)
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 |
ttaylor@hitachisolutions.com |
Connector Metadata | |
---|---|
Publisher | Troy Taylor |
Website | https://openai.com/ |
Privacy policy | https://openai.com/policies/privacy-policy |
Categories | AI |
The connector supports the following authentication types:
Default | Parameters for creating connection. | All regions | Not shareable |
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 |
Name | Calls | Renewal Period |
---|---|---|
API calls per connection | 100 | 60 seconds |
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 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 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 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 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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |