For Developers
List Chats
GET https://ed.link/api/v2/teams/:team_id/chats
Returns AI assistant chat sessions for the authenticated user on the team, ordered by sequence descending. Each chat is a model-shaped MikroORM Chat entity.
Requires the chats.read system permission.
This query allows for standard paging parameters.
It is best practice to use either $first or $last in conjunction with the $next value returned by the API to paginate through results.
Read More About Paging
Developer Guide
Sample Request
const response = await axios.get(`https://ed.link/api/v2/teams/${team_id}/chats`, {
headers: {
authorization: `Bearer ${user_session_token}`
}
});
Sample Response
{
"$data": [
{
"id": "5130c012-b5d0-4baa-816b-a6c100bac6ad",
"created_date": "2026-08-10T16:00:00.000Z",
"updated_date": "2026-08-10T16:05:00.000Z",
"title": "Integration troubleshooting",
"state": "active",
"user": {
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"email": "alex@example.edu"
}
}
]
}
Related Endpoints
POST /api/v2/teams/:team_id/chats— Create a new chatGET /api/v2/teams/:team_id/chats/:chat_id— Fetch a chat (thought summaries included; thought signatures stripped)PATCH /api/v2/teams/:team_id/chats/:chat_id— Update chat metadataPOST /api/v2/teams/:team_id/chats/:chat_id/stream— Send a message (NDJSON stream, includingthought_delta/thought_usage)
