Skip to main content
GET
/
api
/
v2
/
appuid
/
{appUid}
/
agents
Retrieve agents
curl --request GET \
  --url https://a.api.mindset.ai/api/v2/appuid/{appUid}/agents \
  --header 'x-api-key: <api-key>'
{
  "agents": [
    {
      "uid": "<string>",
      "agentName": "<string>",
      "agentPurpose": "<string>",
      "personality": {
        "preset": "friendly",
        "customText": "<string>"
      },
      "formatting": {
        "preset": "conversational",
        "customText": "<string>"
      },
      "policies": {
        "focusAndScope": {
          "enabled": false,
          "scope": "<string>"
        },
        "knowledgeLimits": {
          "enabled": false,
          "themeSpecificAllowance": "<string>"
        },
        "nonContextSegmentMessage": {
          "enabled": false,
          "message": "<string>"
        },
        "clarification": {
          "enabled": false
        },
        "recommendations": {
          "enabled": false
        },
        "neutrality": {
          "enabled": false
        },
        "professionalConduct": {
          "enabled": false
        },
        "legalFinancial": {
          "enabled": false
        },
        "safeguarding": {
          "enabled": false,
          "email": "[email protected]"
        },
        "feedback": {
          "enabled": false
        }
      },
      "additionalPolicyRules": "<string>",
      "additionalInformation": "<string>",
      "iceBreakerMessage": "<string>",
      "memory": {
        "allowAccess": false,
        "allowContribution": false,
        "miningGuidance": "<string>"
      },
      "live": true,
      "contextUids": [
        "<string>"
      ],
      "mcpserverUids": [
        "<string>"
      ],
      "tags": [
        "<string>"
      ],
      "access": "openAccess",
      "externalTenantId": "<string>",
      "createdAt": "2023-11-07T05:31:56Z"
    }
  ]
}

Authorizations

x-api-key
string
header
required

Path Parameters

appUid
string
required

Your application's uid

Minimum string length: 1

Query Parameters

contextUid
string

Filter results to a specific contextUid. Cannot be used with mcpserverUid

mcpserverUid
string

Filter results to a specific mcpserverUid. Cannot be used with contextUid

externalTenantId
string

Only include Agents for externalTenantId

startAfter
string<date-time>

Start after the given createdAt timestamp (ISO 8601) for pagination

Response

Successful retrieval

agents
object[]