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.

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"
            }
        }
    ]
}
  • POST /api/v2/teams/:team_id/chats — Create a new chat
  • GET /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 metadata
  • POST /api/v2/teams/:team_id/chats/:chat_id/stream — Send a message (NDJSON stream, including thought_delta / thought_usage)