List your conversations with Rigel

agent.conversation_list

GET/api/v1/households/{household_id}/agent/conversations

Route

The conversations you started with Rigel, newest first. Conversations are private to the person who started them: nobody else in the household can list or read yours.

Parameters#

List your conversations with Rigel: parameters
Field	Description
`household_id`pathstringrequired	The household's ID.

Response#

200 Your conversations.

List your conversations with Rigel: response fields
Field	Description
`items`array of objectsrequired	Newest first.
`items[].id`stringrequired	The conversation's ID.
`items[].title`string or nullrequired	A short name taken from the first message.
`items[].created_at`integerrequired	When it started, UTC milliseconds.
`items[].updated_at`integerrequired	When the last message was saved, UTC milliseconds.

Errors#

Every error has the same envelope: error.code, error.message, error.details, error.recovery and error.request_id.

List your conversations with Rigel: errors
Status	Code	When
`401`	`unauthenticated`	The request has no valid session.
`404`	`not_found`	The household doesn't exist, or you aren't a member of it.

Examples#

These are real. Each was recorded from a sample household, the Okafors, running through the whole API when this site was built.

List your conversations with Rigel

Conversations are private to the person who started them, so this is your list.

Request, curl

curl 'https://rigel.house/api/v1/households/hh_01M6V9CS6GGVFCY7NAS8ZTQV95/agent/conversations' \
  -H "Cookie: rigel_session=$RIGEL_SESSION"

Request, TypeScript

const response = await fetch("https://rigel.house/api/v1/households/hh_01M6V9CS6GGVFCY7NAS8ZTQV95/agent/conversations", {
  headers: {
    Cookie: `rigel_session=${process.env.RIGEL_SESSION}`,
  },
});
const data = await response.json();

Request, HTTP

GET /api/v1/households/hh_01M6V9CS6GGVFCY7NAS8ZTQV95/agent/conversations HTTP/1.1
Host: rigel.house
Cookie: rigel_session=<your session>

Response, 200

HTTP/1.1 200 OK
Content-Type: application/json
X-Request-Id: req_01M6V9CTC282D498A9N0Z6PMKW

{
  "items": [
    {
      "id": "agc_01M6V9CTBYGRF0AY79C9HQH1M1",
      "title": "What's for dinner on Monday?",
      "created_at": 1794064679148,
      "updated_at": 1794064685148
    }
  ]
}