Skip to main content
PUT
/
sources
/
{source_id}
/
curation
Update Source Curation
curl --request PUT \
  --url https://apigcp.trynia.ai/v2/sources/{source_id}/curation \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "trust_level": "low",
  "overlay_kind": "custom",
  "overlay_summary": "<string>",
  "overlay_guidance": "<string>",
  "recommended_queries": [
    "<string>"
  ],
  "clear_overlay": false
}
'
{
  "source_id": "<string>",
  "source_type": "repository",
  "trust_signals": {
    "trust_level": "medium",
    "trust_tier": "medium",
    "scope": "private",
    "is_global": false,
    "is_verified": false,
    "overlay_available": false,
    "annotation_count": 0
  },
  "overlay": {
    "summary": "<string>",
    "kind": "custom",
    "guidance": "<string>",
    "recommended_queries": [
      "<string>"
    ],
    "updated_at": "<string>"
  },
  "annotations": [
    {
      "id": "<string>",
      "content": "<string>",
      "kind": "note",
      "created_at": "<string>",
      "updated_at": "<string>"
    }
  ],
  "created_at": "<string>",
  "updated_at": "<string>"
}

Authorizations

Authorization
string
header
required

API key must be provided in the Authorization header

Path Parameters

source_id
string
required

Query Parameters

type
enum<string> | null

Source type hint

Available options:
repository,
documentation,
research_paper,
huggingface_dataset,
local_folder,
slack,
google_drive

Body

application/json
trust_level
enum<string> | null

Trust preference for this source

Available options:
low,
medium,
high
overlay_kind
enum<string> | null

Overlay provenance

Available options:
custom,
nia_verified
overlay_summary
string | null

Short curated source summary

overlay_guidance
string | null

Longer guidance for coding agents

Suggested prompts for this source

clear_overlay
boolean
default:false

Remove any existing curated overlay

Response

Successful Response

Full curation state for a source.

source_id
string
required

Source identifier

source_type
enum<string>
required

Source type

Available options:
repository,
documentation,
research_paper,
huggingface_dataset,
local_folder,
slack,
google_drive
trust_signals
SourceTrustSignals · object

Derived trust signals

overlay
SourceCuratedOverlay · object

Curated overlay if present

annotations
SourceAnnotation · object[]

Saved annotations for the source

created_at
string | null

Curation record creation timestamp (ISO)

updated_at
string | null

Curation record update timestamp (ISO)