Create authenticated URL knowledge source

POST

/knowledge/sources

Requires explicit knowledge:write scope, active integration actor, settings.general and Business plan. Tenant comes only from token. URL settings match the dashboard; one encrypted header, never returned. Queued does not mean completed.

Requisição

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢201Criado

application/json

Successful operation

Bodyapplication/json

🟠401Não Autorizado

🟠403Proibido

🟠404Registo Não Encontrado

🟠409

🟠422Erro de Parâmetro

🟠429

Request Example

Shell

JavaScript

Java

Swift

curl --location '/knowledge/sources' \
--header 'Content-Type: application/json' \
--data '{
    "kind": "url",
    "url": "http://example.com",
    "title": "string",
    "refreshIntervalHours": 1,
    "authHeaderName": "string",
    "authHeaderValue": "string"
}'

Response Example

201 - Exemplo 1

{
    "source": {
        "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
        "kind": "string",
        "title": "string",
        "status": "pending",
        "authHeaderConfigured": true,
        "refreshIntervalHours": 1,
        "errorCode": "string",
        "url": "string",
        "indexedAt": "2019-08-24T14:15:22.123Z",
        "createdAt": "2019-08-24T14:15:22.123Z",
        "chunkCount": 0,
        "bytes": 0
    },
    "queued": true,
    "usedByAgents": [
        {
            "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
            "name": "string"
        }
    ],
    "agentsWithExplicitSources": 0,
    "warnings": [
        "string"
    ]
}

Modificado em 2026-10-22 18:13:52

Página anterior

List knowledge sources without secrets

Próxima página

Update URL source configuration