AI Assistant API

5. AI Assistant

This section describes APIs related to AI Assistant management.

5.1. Get Assistants

Retrieve a list of AI assistants with optional parameters like limit and sorting.

Endpoint: GET https://app-gateway.dev.imbrace.co/journeys/v2/ai/assistants?limit=2&sort=desc
Headers:
- x-temp-token:
  Loading temporary token…
- Content-Type: application/json

Example:

curl --location 'https://app-gateway.dev.imbrace.co/journeys/v2/ai/assistants?limit=2&sort=desc' \
--header 'x-temp-token: api_648b936b-cd1d-4553-bb30-7124d3910100' \
--header 'User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:141.0) Gecko/20100101 Firefox/141.0'

5.2. Create Assistant

Create a new AI assistant with specified attributes such as name, description, instructions, and metadata.

Endpoint: POST https://app-gateway.dev.imbrace.co/journeys/v2/ai/assistants
Headers:
- x-temp-token:
  Loading temporary token…
- Content-Type: application/json
- Authorization: Bearer
  Loading temporary token…

Body:

{
    "name": "testing assistant 6",
    "description": "description",
    "instructions": "instructions",
    "file_ids": [],
    "metadata": {
        "key_1": "value_1"
    }
}

Example:

curl --location 'https://app-gateway.dev.imbrace.co/journeys/v2/ai/assistants' \
--header 'User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:141.0) Gecko/20100101 Firefox/141.0' \
--header 'x-temp-token: api_9fd1566e-c85b-4d31-90d1-e88ac5bfcfc1' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer api_9fd1566e-c85b-4d31-90d1-e88ac5bfcfc1' \
--data '{
    "name": "testing assistant 6",
    "description": "description",
    "instructions": "instructions",
    "file_ids": [],
    "metadata": {
        "key_1": "value_1"
    }
}'

5.3. Update Assistant

Update the details of an existing AI assistant by its ID.

Endpoint: PUT https://app-gateway.dev.imbrace.co/journeys/v2/ai/assistants/{assistant_id}
Headers:
- x-temp-token:
  Loading temporary token…
- Content-Type: application/json
- Authorization: Bearer
  Loading temporary token…

Body:

{
    "name": "testing assistant 15",
    "description": "updated description",
    "instructions": "updated instructions",
    "file_ids": [],
    "metadata": {
        "key_2": "value_2"
    }
}

Example:

curl --location --request PUT 'https://app-gateway.dev.imbrace.co/journeys/v2/ai/assistants/asst_1r0G0F5E92HN8Q3mw91Rrbxq' \
--header 'x-temp-token: api_9fd1566e-c85b-4d31-90d1-e88ac5bfcfc1' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer api_9fd1566e-c85b-4d31-90d1-e88ac5bfcfc1' \
--header 'User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:141.0) Gecko/20100101 Firefox/141.0' \
--data '{
    "name": "testing assistant 15",
    "description": "updated description",
    "instructions": "updated instructions",
    "file_ids": [],
    "metadata": {
        "key_2": "value_2"
    }
}'

5.4. Delete Assistant

Delete a specific AI assistant by its ID.

Endpoint: DELETE https://app-gateway.dev.imbrace.co/journeys/v2/ai/assistants/{assistant_id}
Headers:
- x-temp-token:
  Loading temporary token…

Example:

curl --location --request DELETE 'https://app-gateway.dev.imbrace.co/journeys/v2/ai/assistants/asst_1r0G0F5E92HN8Q3mw91Rrbxq' \
--header 'x-temp-token: api_9fd1566e-c85b-4d31-90d1-e88ac5bfcfc1' \
--header 'User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:141.0) Gecko/20100101 Firefox/141.0' \
--header 'Authorization: Bearer api_9fd1566e-c85b-4d31-90d1-e88ac5bfcfc1'

5.5. Create Assistant App

Create a new AI Assistant app with specified attributes.

Endpoint: POST https://app-gateway.dev.imbrace.co/journeys/v2/ai/assistant_apps
Headers:
- x-temp-token:
  Loading temporary token…
- Content-Type: application/json

Body:

{
    "name": "testing assistant 12",
    "description": "description",
    "instructions": "instructions",
    "file_ids": [],
    "metadata": {
        "key_1": "value_1"
    },
    "workflow_name": "workflow test 12",
    "credential_id": 0,
    "credential_name": "placeholder",
    "mode": "advanced"
}

Example:

curl --location 'https://app-gateway.dev.imbrace.co/journeys/v2/ai/assistant_apps' \
--header 'x-temp-token: api_9fd1566e-c85b-4d31-90d1-e88ac5bfcfc1' \
--header 'Content-Type: application/json' \
--header 'User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:141.0) Gecko/20100101 Firefox/141.0' \
--data '{
    "name": "testing assistant 12",
    "description": "description",
    "instructions": "instructions",
    "file_ids": [],
    "metadata": {
        "key_1": "value_1"
    },
    "workflow_name": "workflow test 12",
    "credential_id": 0,
    "credential_name": "placeholder",
    "mode": "advanced"
}'

5.6. Update Assistant App

Update the details of an existing Assistant app by its ID.

Endpoint: PUT https://app-gateway.dev.imbrace.co/journeys/v2/ai/assistant_apps/{app_id}
Headers:
- x-temp-token:
  Loading temporary token…
- Content-Type: application/json

Body:

{
    "name": "testing assistant 15",
    "description": "updated description",
    "instructions": "updated instructions",
    "file_ids": [],
    "metadata": {},
    "workflow_name": "workflow test 15",
    "credential_id": 0,
    "credential_name": "placeholder",
    "mode": "advanced"
}

Example:

curl --location --request PUT 'https://app-gateway.dev.imbrace.co/journeys/v2/ai/assistant_apps/asst_X8JHZyPfapRrUEElNO6H7YD4' \
--header 'x-temp-token: api_9fd1566e-c85b-4d31-90d1-e88ac5bfcfc1' \
--header 'Content-Type: application/json' \
--header 'User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:141.0) Gecko/20100101 Firefox/141.0' \
--data '{
    "name": "testing assistant 15",
    "description": "updated description",
    "instructions": "updated instructions",
    "file_ids": [],
    "metadata": {},
    "workflow_name": "workflow test 15",
    "credential_id": 0,
    "credential_name": "placeholder",
    "mode": "advanced"
}'

5.7. Delete Assistant App

Delete a specific Assistant app by its ID.

Endpoint: DELETE https://app-gateway.dev.imbrace.co/journeys/v2/ai/assistant_apps/{app_id}
Headers:
- x-temp-token:
  Loading temporary token…
- Content-Type: application/json

Example:

curl --location --request DELETE 'https://app-gateway.dev.imbrace.co/journeys/v2/ai/assistant_apps/asst_X8JHZyPfapRrUEElNO6H7YD4' \
--header 'x-temp-token: api_9fd1566e-c85b-4d31-90d1-e88ac5bfcfc1' \
--header 'Content-Type: application/json' \
--header 'User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:141.0) Gecko/20100101 Firefox/141.0' \
--data ''

AI Assistant API

On this page