Skip to main content
GET
/
agent_nodes
/
{id}
Get Agent Node
curl --request GET \
  --url https://api.example.com/agent_nodes/{id}
Returns a single node type and its documentation link. This endpoint always returns the resolved node type. If your lookup matched a real agent node instance, the response also includes that instance’s id. You can pass either kind of ID:
  1. Node type ID — the ID from GET /agent_nodes or nodes[].node_type_id in Get Agent. Looked up directly.
  2. Agent node instance ID — the ID from nodes[].id in Get Agent. The API resolves this to its underlying node type automatically.
The API tries the node type ID first. If no match is found, it checks agent node instances and resolves to the underlying node type.

​
Request

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

​
Response

If you look up a node type directly, the response includes only node_type_id: 
{
  "agent_node": {
    "node_type_id": "3b281fb9-9eb2-40f6-b05b-4b6f909a3da9",
    "name": "AI Music",
    "docs": {
      "path": "tiles/ai-music",
      "anchor": "api-info",
      "url": "https://docs.mosaic.so/tiles/ai-music#api-info"
    }
  }
}
If you look up an agent node instance, the response includes both the agent node id and the resolved node_type_id: 
{
  "agent_node": {
    "id": "4e2e1ac5-2ca2-4e5c-9b1d-469b6062e704",
    "node_type_id": "3b281fb9-9eb2-40f6-b05b-4b6f909a3da9",
    "name": "AI Music",
    "docs": {
      "path": "tiles/ai-music",
      "anchor": "api-info",
      "url": "https://docs.mosaic.so/tiles/ai-music#api-info"
    }
  }
}
The response always returns the node type metadata. The id field is only present when the request matched an actual agent node instance.