Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Sources

List sources

get

Returns a list of sources.

Query parameters
typestringOptional

Filter by source type

Responses
200

Sources

application/json
get/api/sources
GET /api/sources HTTP/1.1
Accept: */*

{
  "data": [
    {
      "active": true,
      "config": {
        "endpoint": "https://example.salesforce.com"
      },
      "external_id": "src-crm",
      "id": 1,
      "type": "salesforce"
    }
  ]
}

Create a source

post

Creates a source.

Body
Responses
201

Created

application/json
post/api/sources
POST /api/sources HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 111

{
  "source": {
    "config": {
      "endpoint": "https://example.salesforce.com"
    },
    "external_id": "src-crm",
    "type": "salesforce"
  }
}
{
  "data": {
    "active": true,
    "config": {
      "endpoint": "https://example.salesforce.com"
    },
    "dynamic_content": {
      "endpoint": {
        "origin": "user",
        "value": "https://example.salesforce.com"
      }
    },
    "external_id": "src-crm",
    "id": 1,
    "inserted_at": "2026-05-12T10:00:00Z",
    "type": "salesforce",
    "updated_at": "2026-05-12T10:00:00Z"
  }
}

Get a source by external ID

get

Fetches a source by external ID.

Path parameters
external_idstringRequired

Source external ID

Responses
200

Source

application/json
get/api/sources/{external_id}
GET /api/sources/{external_id} HTTP/1.1
Accept: */*

{
  "data": {
    "active": true,
    "config": {
      "endpoint": "https://example.salesforce.com"
    },
    "dynamic_content": {
      "endpoint": {
        "origin": "user",
        "value": "https://example.salesforce.com"
      }
    },
    "external_id": "src-crm",
    "id": 1,
    "inserted_at": "2026-05-12T10:00:00Z",
    "type": "salesforce",
    "updated_at": "2026-05-12T10:00:00Z"
  }
}

Update a source or source configuration

put

Update either the source properties or the source configuration. Use 'source' key for general source updates or 'source_config' key for configuration updates.

Path parameters
external_idstringRequired

Source external ID

Body

Update request that can contain either 'source' (general source update) or 'source_config' (configuration update). Only one of them should be provided.

or
Responses
200

Updated

application/json
put/api/sources/{external_id}
PUT /api/sources/{external_id} HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 87

{
  "source": {
    "config": {
      "endpoint": "https://example.salesforce.com"
    },
    "type": "salesforce"
  }
}
{
  "data": {
    "active": true,
    "config": {
      "endpoint": "https://example.salesforce.com"
    },
    "dynamic_content": {
      "endpoint": {
        "origin": "user",
        "value": "https://example.salesforce.com"
      }
    },
    "external_id": "src-crm",
    "id": 1,
    "inserted_at": "2026-05-12T10:00:00Z",
    "type": "salesforce",
    "updated_at": "2026-05-12T10:00:00Z"
  }
}

Delete a source

delete

Deletes a source.

Path parameters
external_idstringRequired

Source external ID

Responses
204

Source deleted

No content
delete/api/sources/{external_id}
DELETE /api/sources/{external_id} HTTP/1.1
Accept: */*

No content

Update a source or source configuration

patch

Update either the source properties or the source configuration. Use 'source' key for general source updates or 'source_config' key for configuration updates.

Path parameters
external_idstringRequired

Source external ID

Body

Update request that can contain either 'source' (general source update) or 'source_config' (configuration update). Only one of them should be provided.

or
Responses
200

Updated

application/json
patch/api/sources/{external_id}
PATCH /api/sources/{external_id} HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 87

{
  "source": {
    "config": {
      "endpoint": "https://example.salesforce.com"
    },
    "type": "salesforce"
  }
}
{
  "data": {
    "active": true,
    "config": {
      "endpoint": "https://example.salesforce.com"
    },
    "dynamic_content": {
      "endpoint": {
        "origin": "user",
        "value": "https://example.salesforce.com"
      }
    },
    "external_id": "src-crm",
    "id": 1,
    "inserted_at": "2026-05-12T10:00:00Z",
    "type": "salesforce",
    "updated_at": "2026-05-12T10:00:00Z"
  }
}

Last updated