Integrations

Integration management endpoints

List all integrations

get

Authorizations

bearerAuth

AuthorizationstringRequired

API Key with rest-api:* scope

Responses

200

List of integrations

application/json

get

/integrations

HTTPcURLJavaScriptPython

GET /api/v2/integrations HTTP/1.1
Host: api.jnkie.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

List of integrations

{
  "integrations": [
    {
      "id": 1,
      "user_id": 1,
      "type": "text",
      "name": "text",
      "config": {},
      "is_active": true,
      "supported": true,
      "created_at": "2026-01-11T07:19:42.382Z"
    }
  ]
}

Create a new integration

post

Authorizations

bearerAuth

AuthorizationstringRequired

API Key with rest-api:* scope

Body

application/json

typestring · min: 1Required

Integration type (use /integrations/types to get available types)

namestring · min: 2 · max: 100Required

configobjectRequired

Configuration object (varies by type, validated by integration handler)

Responses

201

Integration created

application/json

400

Validation error or unsupported integration type

401

Unauthorized

post

/integrations

HTTPcURLJavaScriptPython

POST /api/v2/integrations HTTP/1.1
Host: api.jnkie.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 41

{
  "type": "text",
  "name": "text",
  "config": {}
}

{
  "integration": {
    "id": 1,
    "user_id": 1,
    "type": "text",
    "name": "text",
    "config": {},
    "is_active": true,
    "supported": true,
    "created_at": "2026-01-11T07:19:42.382Z"
  }
}

Get available integration types

get

Authorizations

bearerAuth

AuthorizationstringRequired

API Key with rest-api:* scope

Responses

200

List of integration types

application/json

get

/integrations/types

HTTPcURLJavaScriptPython

GET /api/v2/integrations/types HTTP/1.1
Host: api.jnkie.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

List of integration types

{
  "types": [
    {
      "type": "text",
      "supported": true,
      "displayName": "text"
    }
  ]
}

Get integration details

get

Authorizations

bearerAuth

AuthorizationstringRequired

API Key with rest-api:* scope

Path parameters

integrationIdintegerRequired

Responses

200

Integration details

No content

get

/integrations/{integrationId}

HTTPcURLJavaScriptPython

GET /api/v2/integrations/{integrationId} HTTP/1.1
Host: api.jnkie.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Integration details

No content

Update integration

put

Authorizations

bearerAuth

AuthorizationstringRequired

API Key with rest-api:* scope

Path parameters

integrationIdintegerRequired

Body

application/json

namestring · min: 2 · max: 100Optional

configobjectOptional

Configuration object (validated by integration handler)

is_activebooleanOptional

Responses

200

Integration updated

No content

400

Validation error

404

Integration not found

put

/integrations/{integrationId}

HTTPcURLJavaScriptPython

PUT /api/v2/integrations/{integrationId} HTTP/1.1
Host: api.jnkie.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 44

{
  "name": "text",
  "config": {},
  "is_active": true
}

No content

Delete integration

delete

Authorizations

bearerAuth

AuthorizationstringRequired

API Key with rest-api:* scope

Path parameters

integrationIdintegerRequired

Responses

200

Integration deleted

No content

delete

/integrations/{integrationId}

HTTPcURLJavaScriptPython

DELETE /api/v2/integrations/{integrationId} HTTP/1.1
Host: api.jnkie.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Integration deleted

No content