---
id: list-agents
title: "List all agents"
description: "Get a list of all agents with their profiles"
sidebar_label: "List all agents"
hide_title: true
hide_table_of_contents: true
api: eJylV9ty2zYQ/RUM8tJ6aIly4rTDN9m1U83kNrXSh9oez5pckYhBAAFAyaxG/95ZkJQoyrm5fjFE7O5Z7OUssOYecseTaz7NUXn2DhTkWKLy/DbiGbrUCuOFVjzhb9AzYFI4z/SCgZQMSMexlfAF8wUKy4zVCyHR8YhrgxZIdZbxhJPaXSPPI27RGa0cOp6s+Ukc0799sKsqTdG5RSXZX60wj3iqlSffkjUHY6RIA8D4syOdNXdpgSXQyliC96JBaHGTNRceS/cVgTuR0drXBnnCnbdC5TziXnhJH5oAzTK+ibiCEr8l+572NxE3aJ1WIIWvD0G1QaXQuZ4hVZX3aHnES3gUZVXyZBLxUqhmHe8APnS6wyR1G8xrho8GrUCVIvslPp78Sh6lWrlUoPJCV+656OcHRoZuHEjsPMBHb2GJ1okmaT8LftHXH+L2N3eQkFtEuJf43ANP9wwMQfd2d6gKK6u9SIUrn4P5vqc+ROzt7fDuBbg75y2q3BfPQTwT4NhVZ2CI+adeMeetVrmsWa+wmVALWVGVOaaNUEKrbRA2UeeEvv+MqQ+t/6USFjPiHL2r4sO6HFTKMIv78R2e/nZ3qo87V+cWhD/MX0+C+SDC7sFhxrRiZyJnl2KJrNQZylHwCkojsaGNvbqKR78dZCF8e6Lp4tHrYSvEo9NB0cSjl1GPJuLR7xTRe0gfcqsr9U26OttJUdtbBI/ZHTTcqeoPC55cD7U3Ua9opOSbXhjPGwts6sleZbL/ae9TYyHY+06ZbNm5Jd59Xt0LyO2Ar98K52ceDzuoYfMwzGgmNDOsnV7MVWUJth7xnWNgLdTDaeB+zHX3pFu9sbbvWrfRlBxbaBv8FCrvDd2DSmwm3HV/lvHKoZ2cvNwPUcJnDEoGzOmFX4FFhioXCgNF9OuEn8Qnr47jyfHkdD6Jk5dxEsf/dDlI+FSKdJiLp3ri9ImeOP1KT5z+SE+c7vfE6aAcd26/nk9eJSeN25vbTfiLeIm+0BSGHClbBsglPgYjxsvJeHtFEWqhQ3/tjf93WGpbs+nH2UHabtSUeSyNtiCPHZagvEhZ2Si42lGVUS6ns+7e5AvwzHlt0UXMorcCl7QElTGL4IhI9RJtY0SgG92oG/XiBbtE8JVFRz+P2NHRGfi06Hy78tpCjkdHSVgiKyvphZG4NcNwsRAh9rJuCh8qr0sgfxeQehZykNK5GvtX3WmuEGxakOlLEZyUuATld5YrR2WqyD2QTILKK8iRfanoIuIaa5cEMa8NskshPRJTBGeDbQap1c6xlbYyC95QQELsG4/a+GwnjUMDFjzKurE+L4R6YBcqM1ooT4bfoKKbKLJwe3z0FUgGyq3Q9ni+gRAZFaSvA0R3qMbuGwumYH8LV4EU/4Z7JxmfKY8hVkvscp0HyWVfsjHxh04rulqzuYX0oT12WDd44e7dWcla4fZ6XRmH1jNXGaOtb+tgatNCeEypGOjTvMCu0iqHLrlRxxSRtijZW6EeHGGea6Uw7aUtVCJRQSq1QyYU86LERn2b/AP1rshBypo5UQoJthc1Ur5owvkd5DLQgKI3BHNQEiN54bdGroxFyKiwphTovdhLKULmWtKAhi/bGLY9BfJGsfavfURAGgZXS2Vd54TQEekTtRE170SmBtIC2cko5hGvrOQJL7w3LhmPV6vVCML2SNt83Oq68dvZ+cX7q4vjk1E8KnwpyfCW2PhkFI/i8EbQzpegelg0HXpUP2Sa9e4Z9LNvsnZUUReMjQShwiyn06xbIrzmYASP+HISblzd9Cq087S5XlPHfLJys6HP1Nc1T65vI74EK4j26dcm4gVChjYMpAesKYBpioYIdwmyChN1+ICj28GWnN9czPlm8x9AEQw1
sidebar_class_name: "get api-method"
info_path: docs/api-reference/endpoints/agent-memory-api
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"List all agents"}
>
</Heading>

<MethodEndpoint
  method={"get"}
  path={"/api/v1/agents"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Get a list of all agents with their profiles

<ParamsDetails
  parameters={undefined}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={undefined}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"agents":{"items":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"name":{"type":"string","title":"Name"},"personality":{"properties":{"openness":{"type":"number","maximum":1,"minimum":0,"title":"Openness","description":"Openness to experience (0-1)"},"conscientiousness":{"type":"number","maximum":1,"minimum":0,"title":"Conscientiousness","description":"Conscientiousness (0-1)"},"extraversion":{"type":"number","maximum":1,"minimum":0,"title":"Extraversion","description":"Extraversion (0-1)"},"agreeableness":{"type":"number","maximum":1,"minimum":0,"title":"Agreeableness","description":"Agreeableness (0-1)"},"neuroticism":{"type":"number","maximum":1,"minimum":0,"title":"Neuroticism","description":"Neuroticism (0-1)"},"bias_strength":{"type":"number","maximum":1,"minimum":0,"title":"Bias Strength","description":"How strongly personality influences opinions (0-1)"}},"type":"object","required":["openness","conscientiousness","extraversion","agreeableness","neuroticism","bias_strength"],"title":"PersonalityTraits","description":"Personality traits based on Big Five model.","example":{"agreeableness":0.7,"bias_strength":0.7,"conscientiousness":0.6,"extraversion":0.5,"neuroticism":0.3,"openness":0.8}},"background":{"type":"string","title":"Background"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["agent_id","name","personality","background"],"title":"AgentListItem","description":"Agent list item with profile summary."},"type":"array","title":"Agents"}},"type":"object","required":["agents"],"title":"AgentListResponse","description":"Response model for listing all agents.","example":{"agents":[{"agent_id":"user123","background":"I am a software engineer","created_at":"2024-01-15T10:30:00Z","name":"Alice","personality":{"agreeableness":0.5,"bias_strength":0.5,"conscientiousness":0.5,"extraversion":0.5,"neuroticism":0.5,"openness":0.5},"updated_at":"2024-01-16T14:20:00Z"}]}}}}}}}
>
  
</StatusCodes>


      