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 template with agent node instances (including embedded node_type) and connections.

​
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": "",
    "visibility": "private",
    "created_at": "2026-03-01T12:00:00Z",
    "updated_at": "2026-03-02T08:00:00Z"
  },
  "agent_nodes": [
    {
      "agent_node_id": "bf750792-a2e9-48c2-9d39-24f892772f6a",
      "node_type": {
        "node_type_id": "3b281fb9-9eb2-40f6-b05b-4b6f909a3da9",
        "node_type_name": "AI Music",
        "docs_url": "https://docs.mosaic.so/tiles/ai-music",
        "params_docs_url": "https://docs.mosaic.so/tiles/ai-music#api-info"
      },
      "params_used": {
        "use_intelligent_analysis": true,
        "genre": "Cinematic"
      }
    },
    {
      "agent_node_id": "a1c2d3e4-5678-90ab-cdef-1234567890ab",
      "node_type": {
        "node_type_id": "ea1b2c3d-4e5f-6789-0abc-def123456789",
        "node_type_name": "Captions",
        "docs_url": "https://docs.mosaic.so/tiles/captions",
        "params_docs_url": "https://docs.mosaic.so/tiles/captions#api-info"
      },
      "params_used": {
        "caption_font": "Montserrat"
      }
    }
  ],
  "connections": [
    {
      "source_agent_node_id": "bf750792-a2e9-48c2-9d39-24f892772f6a",
      "target_agent_node_id": "a1c2d3e4-5678-90ab-cdef-1234567890ab"
    }
  ]
}

​
Response Fields

FieldTypeDescription
agent.idstringAgent ID.
agent.namestringAgent display name.
agent.descriptionstringAgent description.
agent.visibilitystring | nullVisibility setting (public or private).
agent.created_atstringISO timestamp.
agent.updated_atstringISO timestamp.
agent_nodes[].agent_node_idstringAgent node instance ID. Use this in operations[].agent_node_id for update_node and delete_node.
agent_nodes[].node_type.node_type_idstringNode type ID for this agent node.
agent_nodes[].node_type.node_type_namestring | nullNode type display name for this agent node.
agent_nodes[].node_type.docs_urlstring | nullCanonical docs page URL (from nodes.docs_path).
agent_nodes[].node_type.params_docs_urlstring | nullExact params/API section URL (from nodes.docs_anchor).
agent_nodes[].params_usedobjectCurrent parameter configuration for this node instance.
connections[]arrayDirected edges between agent_node_id values in this agent graph.