Create Connection

POST

https://api.sikaru.ai/v1/projects/:project_id/connections

POST

/v1/projects/:project_id/connections

curl -X POST https://api.sikaru.ai/v1/projects/project_id/connections \
     -H "Authorization: Bearer <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "config": {},
  "display_name": "string",
  "kind": "mcp"
}'

{
  "config": {
    "allowed_hosts": [
      "string"
    ],
    "auth": "none",
    "endpoint": "string",
    "header_name": "string",
    "oauth_client_id": "string",
    "oauth_scopes": [
      "string"
    ],
    "toolkit": "string"
  },
  "display_name": "string",
  "grants": [
    {
      "active": true,
      "agent_id": "string",
      "approval": "string",
      "environment": "string",
      "id": "string",
      "tools": {}
    }
  ],
  "id": "string",
  "kind": "string",
  "owner": "string",
  "ownership": "string",
  "revocation": "string",
  "slug": "string",
  "status": "string",
  "tools": [
    {
      "digest": "string",
      "input_schema": {},
      "name": "string",
      "description": "",
      "version": "string"
    }
  ],
  "version": 1,
  "account_status": "string",
  "expires_at": 1.1,
  "tool_count": 0,
  "tool_load": {
    "at": 1.1,
    "status": "loaded",
    "tool_count": 1,
    "removed": [
      "string"
    ],
    "removed_used_by": [
      "string"
    ]
  },
  "used_by": {
    "agents": [
      {
        "draft": true,
        "draft_valid": true,
        "id": "string",
        "live": true,
        "name": "string",
        "slug": "string"
      }
    ],
    "count": 1,
    "schedules": [
      "string"
    ]
  }
}

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

project_idstringRequired

Request

This endpoint expects an object.

configobjectRequired

display_namestringRequired1-120 characters

kindenumRequired

Allowed values:

credentialsobjectOptional

ownershipenumOptionalDefaults to workspace

Allowed values:

slugstring or nullOptionalformat: "^[a-z0-9][a-z0-9_-]{0,127}$"

Response

Successful Response

configobject

display_namestring

grantslist of objects

idstring

kindstring

ownerstring

ownershipstring

revocationstring

slugstring

statusstring

toolslist of objects

versioninteger

account_statusstring or nullOptional

expires_atdouble or nullOptional

tool_countintegerOptionalDefaults to 0

tool_loadobject or nullOptional

The latest tool discovery: loaded, unchanged, or failed (retry by discovering again).

used_byobjectOptional

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error