Integrations

Create integration for projects

post

Register a new external integration linked to one or more projects. Credentials are encrypted at rest using AES-256.

Body

application/json

providerstring · enumRequired

Filter by integration provider

Possible values:

auth_typestring · enumRequired

Authentication type

Default: patPossible values:

credentialsobjectRequired

Credentials for authentication (e.g., token for PAT)

Example: {"token":"ghp_xxxx"}

projectsstring[]Optional

Project identifiers to associate with this integration (required if not global)

Example: ["flxbl-io/sf-core","acmecorp/sf-core"]

is_globalbooleanOptional

Store as global integration (available to all projects)

Example: true

configobjectOptional

Provider-specific configuration

Responses

201

Integration created successfully

400

Invalid configuration or project not found

post

/sfp/api/integrations

HTTPcURLJavaScriptPython

POST /sfp/api/integrations HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 154

{
  "provider": "github",
  "auth_type": "pat",
  "credentials": {
    "token": "ghp_xxxx"
  },
  "projects": [
    "flxbl-io/sf-core",
    "acmecorp/sf-core"
  ],
  "is_global": true,
  "config": {}
}

No content

Retrieve integration credentials

post

Fetch stored credentials for an integration by project. All access is audited.

Body

application/json

providerstring · enumOptional

Filter by integration provider

Possible values:

projectstringOptional

Filter by project identifier

Example: flxbl-io/sf-core

Responses

201

Credentials retrieved successfully

404

No integration found for specified filters

post

/sfp/api/integrations/credentials

HTTPcURLJavaScriptPython

POST /sfp/api/integrations/credentials HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 50

{
  "provider": "github",
  "project": "flxbl-io/sf-core"
}

No content