---
title: "Add a Paladin context source"
method: POST
path: "/paladin/{paladin_id}/context-sources"
tags: ["paladin"]
---

# Add a Paladin context source

`POST /paladin/{paladin_id}/context-sources`

Configures a context source (a Slack channel or a document) for a Paladin to read. Idempotent, so re-adding an existing source returns it.

## Path parameters

- `paladin_id` string, uuid, required

## Request body

- CreatePaladinContextSourceInfo — Information for adding a context source to a Paladin.
  - `source_kind` 'SLACK_CHANNEL' | 'DOCUMENT', required — The kind of source a Paladin can read. A SLACK_CHANNEL is a Slack channel; a DOCUMENT is a Notion or Confluence page.
  - `third_party_provider` 'SLACK' | 'NOTION' | 'CONFLUENCE', required — The integration a Paladin context source comes from.
  - `remote_id` string, required — The provider's identifier for the source. The Slack channel ID for a channel, or the Notion/Confluence page ID for a document.
  - `name` string — An optional human-readable name for the source.
  - `url` string — An optional link to the source.

## Response `200`

The configured context source.

- PaladinContextSource — # PaladinContextSource Object ### Description A context source (a Slack channel or a document) that a Paladin is configured to read during access-request review.
  - `id` string, uuid, required — The ID of the context source.
  - `paladin_id` string, uuid, required — The ID of the Paladin this source belongs to.
  - `source_kind` 'SLACK_CHANNEL' | 'DOCUMENT', required — The kind of source a Paladin can read. A SLACK_CHANNEL is a Slack channel; a DOCUMENT is a Notion or Confluence page.
  - `third_party_provider` 'SLACK' | 'NOTION' | 'CONFLUENCE', required — The integration a Paladin context source comes from.
  - `remote_id` string, required — The provider's identifier for the source. The Slack channel ID for a channel, or the Notion/Confluence page ID for a document.
  - `name` string, required — A human-readable name for the source.
  - `url` string, required — A link to the source.

---

[API](https://skmtc.net/opal/apis/opal-api.md) · [All operations](https://skmtc.net/opal/apis/opal-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/opal/opal-api/revisions/5b5b5f694e25/schema)