---
title: "Society Refresh Context"
method: POST
path: "/v1/societies/refresh-context"
tags: ["societies"]
---

# Society Refresh Context

`POST /v1/societies/refresh-context`

## Request

- Base URL: `https://api.evidenso.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.evidenso.com/v1/societies/refresh-context`
- Auth: none declared

Service token only (dt-api's scheduled refresh). Runs the SAME guards as
manual Add documents for the refresh's pinned owner and returns the complete
add-documents pipeline request, so an unattended refresh is exactly that run
on a timer — never a replay of the build payload.

A tenant problem aborts the whole run: the owner left the org (403), the
society is not theirs (404) or is shared with another org (409), the org has
no active billing (402), or there is no completed build (422). A source the
owner is not connected to is only left out and reported, so the rest still
refresh while the digest asks for a reconnect.

## Headers

- `authorization` string

## Request body

- RefreshContextRequest
  - `society_key` string, required: Composite 'market/name' society key.
  - `user_id` string, required: The refresh's pinned owner — whose connections are read.
  - `scope_by_integration` object: The society's stored per-source scope, plus this run's `since`.

## Response `200`

Successful Response

- RefreshContextResponse
  - `society_id` string, required
  - `society_key` string, required
  - `source_mode` string, required
  - `org_id` string, required
  - `display_name` string, required
  - `display_market` string, required
  - `society_description` string, required
  - `request_payload` object, required
  - `unavailable_sources` object: Sources left out of this run, with why — the owner must reconnect them.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/evidenso/apis/persona-rag-api.md) - [All operations](https://skmtc.dev/evidenso/apis/persona-rag-api/llms.txt) - [OpenAPI document](https://skmtc.dev/evidenso/apis/persona-rag-api/revisions/86408c178d4f?raw)