POST
/
v1
/
instruction
curl --request POST \
  --url https://api.personal.ai/v1/instruction \
  --header 'Content-Type: <content-type>' \
  --header 'x-api-key: <x-api-key>' \
  --data '{
  "Text": "<string>",
  "Context": "<string>",
  "DomainName": "<string>",
  "UserName": "<string>",
  "SessionId": "<string>",
  "SourceName": "<string>",
  "is_message": true
}'
{
  "ai_message": "<string>",
  "ai_score": 123,
  "ai_name": "<string>",
  "SessionId": "<string>",
  "source_app": "<string>"
}

​
Overview

API endpoint for sending specific instructions to your AI. This endpoint allows you to interact with different AI models and execute specific commands.

​
Authorization

​
x-api-key
string
required

Your Personal AI API key

​
Headers

​
Content-Type
string
required

Must be set to application/json

​
Query Parameters

​
cmd
string
required
  • chatgpt
  • search
Example
    https://api.personal.ai/v1/instruction?cmd=chatgpt
Example
    https://api.personal.ai/v1/instruction?cmd=search

​
Body

​
Text
string
required

Text instruction to send to your AI

Example
    "Text": "who is Einstein"
​
Context
string

Additional context for the instruction

Example
    "Context": "Respond in 2 sentences or less."
​
DomainName
string
required

The domain part of the AI profile url

Example
    "DomainName": "pai-developer"
​
UserName
string

Name of the user sending the request

Example
    "UserName": "Leila"
​
SessionId
string

Session identifier for maintaining conversation context

Example
    "SessionId": "d5e9f208-937c-4a9c-92bf-5fb90ce68ff6"
​
SourceName
string

Source application name

Example
    "SourceName": "slack"
​
is_message
boolean

Flag to indicate if the instruction should be treated as a message

Example
    "is_message": true

​
Example Request

Example
{
    "Text": "who is Einstein",
    "Context": "Respond in two sentences or less.",
    "DomainName": "pai-developer",
    "UserName": "Leila",
    "SessionId": "d5e9f208-937c-4a9c-92bf-5fb90ce68ff6",
    "SourceName": "slack",
    "is_message": true
}

​
Example Response

​
ai_message
string

The AI’s response to the instruction

​
ai_score
number

Confidence score of the AI’s response

​
ai_name
string

The name given to the AI persona

​
SessionId
string

The Id of the conversation that was passed or automatically generated

​
source_app
string

The source from which the request was initiated from as specified in the original API request

Example Success Response
{
    "ai_message": "Einstein was a renowned physicist who developed the theory of relativity. He is considered one of the most influential scientists of the 20th century.",
    "ai_score": 95.5,
    "ai_name": "AI Name",
    "SessionId": "d5e9f208-937c-4a9c-92bf-5fb90ce68ff6",
    "source_app": "api"
}

​
Example cURL

cURL
curl --location 'https://api.personal.ai/v1/instruction?cmd=chatgpt' \
--header 'Content-Type: application/json' \
--header 'x-api-key: <your-api-key>' \
--data '{
    "Text": "who is Einstein",
    "UserName": "Leila",
    "SourceName": "slack",
    "SessionId": "d5e9f208-937c-4a9c-92bf-5fb90ce68ff6",
    "is_message": true
}'

​
Error Codes

CodeDescription
403Forbidden - Check that API key is invalid
503Processing Failure - Instruction could not be processed
Example Error Response
{
    "detail": "AI instruction api unauthorized."
}