Create Agent-Corpus Connection

POST

/api/v2/agents/{agent_id}/corpora/{corpus_id}

Allows creating a new agent-corpus connection.

Staging behaviour:

Creates a new agent-corpus connection for staging version instead of the published agent.

Changes are propagated to the published agent via the Publish API(POST api/v2/agents/{agent_id}/publish).

Request Headers:

X-Authorization-Consistency-Token (string, optional): Authorization consistency token for read-after-write consistency. Pass the token received from a previous write operation to ensure this read reflects that write.

Returns:

A Response with the created agent-corpus connection or error message.

Current Version:

2.0.0

Request

Path Params

Header Params

Responses

🟢200OK

application/json

Success

Bodyapplication/json

🟠400Bad Request

🟠403Record Not Found

🟠404Server Error

🔴500

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff --request POST 'https:///api/v2/agents//corpora/' \
--header 'Organization-Id;' \
--header 'Ocp-Apim-Subscription-Key: ' \
--header 'Authorization: Bearer '

Response Example

200 - Example 1

{
    "message": "string",
    "success": true,
    "data": {
        "id": 0,
        "created_by": "string",
        "modified_by": "string",
        "created_on": "2019-08-24T14:15:22.123Z",
        "modified_on": "2019-08-24T14:15:22.123Z",
        "agent": {
            "id": 0,
            "agent_type": {
                "id": 0,
                "name": "string"
            },
            "instructions": [
                {
                    "id": 0,
                    "created_by": "string",
                    "modified_by": "string",
                    "created_on": "2019-08-24T14:15:22.123Z",
                    "modified_on": "2019-08-24T14:15:22.123Z",
                    "instruction": "string",
                    "is_deleted": true,
                    "parent": 0,
                    "agent": 0
                }
            ],
            "agent_name": "string",
            "domain": "string",
            "prefix_prompt": "string",
            "alias": "string",
            "is_deleted": true,
            "created_by": "string",
            "access": "string",
            "project": 0,
            "llm_config": 0
        },
        "corpus": {
            "id": 0,
            "indexing_mode": {
                "id": 0,
                "mode": "exhaustive"
            },
            "name": "string",
            "description": "string",
            "owner": {
                "id": 0,
                "email": "[email protected]",
                "is_superuser": true,
                "first_name": "string",
                "last_name": "string",
                "organization": {
                    "id": 0,
                    "org_name": "string"
                }
            },
            "tags": [
                "string"
            ]
        },
        "is_enabled": true,
        "is_default": true,
        "is_deleted": true,
        "parent": 0,
        "connected_by": 0
    }
}

Get Agent-Corpus Connection Details

Update Agent-Corpus Connection