Skip to main content
GET
/
agent
/
{agent_id}
Get Agent
curl --request GET \
  --url https://api.example.com/agent/{agent_id}
Returns the saved agent and its nodes with their current parameter configuration.

​
Request

curl -X GET "https://api.mosaic.so/agent/[agent_id]" \
  -H "Authorization: Bearer mk_your_api_key"

​
Response

{
  "agent": {
    "id": "123e4567-e89b-12d3-a456-789012345678",
    "name": "My Agent",
    "description": "",
    "created_at": "2026-03-01T12:00:00Z",
    "updated_at": "2026-03-02T08:00:00Z"
  },
  "nodes": [
    {
      "id": "bf750792-a2e9-48c2-9d39-24f892772f6a",
      "node_type_id": "3b281fb9-9eb2-40f6-b05b-4b6f909a3da9",
      "node_type_name": "AI Music",
      "params_used": {
        "use_intelligent_analysis": true,
        "genre": "Cinematic"
      }
    },
    {
      "id": "a1c2d3e4-5678-90ab-cdef-1234567890ab",
      "node_type_id": "ea1b2c3d-4e5f-6789-0abc-def123456789",
      "node_type_name": "Captions",
      "params_used": {
        "font_family": "Montserrat"
      }
    }
  ]
}

​
Response Fields

FieldTypeDescription
agent.idstringAgent ID.
agent.namestringAgent display name.
agent.descriptionstringAgent description.
agent.created_atstringISO timestamp.
agent.updated_atstringISO timestamp.
nodes[].idstringAgent node instance ID. Use this as the key in update_params.
nodes[].node_type_idstringThe underlying node type ID. Match against GET /agent_nodes for docs.
nodes[].node_type_namestringNode type display name.
nodes[].params_usedobjectCurrent parameter configuration for this node instance.