curl -X GET "https://mdb.ai/threads/mdb_thread_cfa0fac64cd94faab3ae269d768c0cb0/runs/mdb_run_8b425f3bf0a04ca584ad11106d37330c" \
  -H "Authorization: Bearer MINDS_API_KEY" \
  -H "Content-Type: application/json"

{
  "id": "mdb_run_8b425f3bf0a04ca584ad11106d37330c",
  "assistant_id": "mdb_asst_cfde04f34a5e47548b705fbf091e06bc",
  "cancelled_at": null,
  "completed_at": null,
  "created_at": 1718885800,
  "expires_at": null,
  "failed_at": null,
  "incomplete_details": null,
  "instructions": "",
  "last_error": null,
  "max_completion_tokens": null,
  "max_prompt_tokens": null,
  "metadata": null,
  "model": "",
  "object": "thread.run",
  "required_action": null,
  "response_format": null,
  "started_at": null,
  "status": "queued",
  "thread_id": "mdb_thread_cfa0fac64cd94faab3ae269d768c0cb0",
  "tool_choice": null,
  "tools": [],
  "truncation_strategy": null,
  "usage": null,
  "temperature": null,
  "top_p": null
}

This API endpoint retrieves a Run using the GET method.

​
Body

None.

​
Response

​
id
string
required

Unique identifier for the run.

​
assistant_id
string
required

ID of the Assistant associated with the run.

​
cancelled_at
number

Timestamp when the run was cancelled.

​
completed_at
number

Timestamp when the run was completed.

​
created_at
number
required

Timestamp when the run was created.

​
expires_at
number

Expiration time for the run.

​
failed_at
number

Timestamp when the run failed.

​
incomplete_details
object

Details about why the run was incomplete, if applicable.

​
instructions
string

Instructions sent to the Assistant.

​
last_error
object

Details about the last error, if any.

​
max_completion_tokens
number

Maximum number of tokens for the completion.

​
max_prompt_tokens
number

Maximum number of tokens for the prompt.

​
metadata
object

Additional metadata for the run.

​
model
string

Model name used for the run.

​
object
string
required

Type of the returned object (e.g., “thread.run”).

​
required_action
object

Actions required before proceeding.

​
response_format
string

Format of the response.

​
started_at
number

Timestamp when the run started.

​
status
string
required

Current status of the run (e.g., “queued”, “in_progress”).

​
thread_id
string
required

ID of the thread associated with the run.

​
tool_choice
string

Chosen tool for the run.

​
tools
array

List of tools used during the run.

​
truncation_strategy
string

Strategy used to truncate input.

​
usage
object

Usage statistics for the run.

​
temperature
number

Sampling temperature for randomness.

​
top_p
number

Top-p sampling parameter.

​
Authorization

A valid API key must be passed in the Authorization header:

Authorization: Bearer MINDS_API_KEY

Generate your API key here.

​
Path Parameters

​
thread_id
string
required

ID of a Thread to be listed.

​
run_id
string
required

ID of a Run to be listed.

curl -X GET "https://mdb.ai/threads/mdb_thread_cfa0fac64cd94faab3ae269d768c0cb0/runs/mdb_run_8b425f3bf0a04ca584ad11106d37330c" \
  -H "Authorization: Bearer MINDS_API_KEY" \
  -H "Content-Type: application/json"

{
  "id": "mdb_run_8b425f3bf0a04ca584ad11106d37330c",
  "assistant_id": "mdb_asst_cfde04f34a5e47548b705fbf091e06bc",
  "cancelled_at": null,
  "completed_at": null,
  "created_at": 1718885800,
  "expires_at": null,
  "failed_at": null,
  "incomplete_details": null,
  "instructions": "",
  "last_error": null,
  "max_completion_tokens": null,
  "max_prompt_tokens": null,
  "metadata": null,
  "model": "",
  "object": "thread.run",
  "required_action": null,
  "response_format": null,
  "started_at": null,
  "status": "queued",
  "thread_id": "mdb_thread_cfa0fac64cd94faab3ae269d768c0cb0",
  "tool_choice": null,
  "tools": [],
  "truncation_strategy": null,
  "usage": null,
  "temperature": null,
  "top_p": null
}