Sign in

5b5b5f694e25

latestOpenAPI 3.1.02026-08-13160205478.7 KB
paladin

Add a Paladin context source

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

post/paladin/{paladin_id}/context-sources

Path parameters

paladin_idstring uuid required

The ID of the Paladin.

Request body

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_idstring required

The provider's identifier for the source. The Slack channel ID for a channel, or the Notion/Confluence page ID for a document.

namestring

An optional human-readable name for the source.

urlstring

An optional link to the source.

Example request

{
  "source_kind": "SLACK_CHANNEL",
  "third_party_provider": "SLACK",
  "remote_id": "C0123456789",
  "name": "#access-requests"
}

Response

The configured context source.

idstring uuid required

The ID of the context source.

paladin_idstring 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_idstring required

The provider's identifier for the source. The Slack channel ID for a channel, or the Notion/Confluence page ID for a document.

namestring required

A human-readable name for the source.

urlstring required

A link to the source.

Example response

{
  "id": "8a1f2c3d-4b5e-6f70-8192-a3b4c5d6e7f8",
  "paladin_id": "32acc112-21ff-4669-91c2-21e27683eaa1",
  "source_kind": "SLACK_CHANNEL",
  "third_party_provider": "SLACK",
  "remote_id": "C0123456789",
  "name": "#access-requests",
  "url": "https://example.slack.com/archives/C0123456789"
}