Skip to main content
POST
/
api
/
v1
/
app-connections
/
humanitec
cURL
curl --request POST \
  --url https://us.infisical.com/api/v1/app-connections/humanitec \
  --header 'Content-Type: application/json' \
  --data '{
  "method": "api-token",
  "credentials": {
    "apiToken": "<string>"
  },
  "name": "<string>",
  "description": "<string>",
  "projectId": "<string>",
  "isPlatformManagedCredentials": true,
  "gatewayId": "<any>"
}'
{
  "appConnection": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "description": "<string>",
    "version": 1,
    "orgId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "isPlatformManagedCredentials": false,
    "gatewayId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "projectId": "<string>",
    "credentialsHash": "<string>",
    "project": {
      "name": "<string>",
      "id": "<string>",
      "type": "<string>",
      "slug": "<string>"
    },
    "app": "humanitec",
    "method": "api-token",
    "credentials": {}
  }
}

Body

application/json
name
string
required

The name of the Humanitec Connection to create. Must be slug-friendly.

Required string length: 1 - 64
method
enum<string>
required

The method used to authenticate with Humanitec.

Available options:
api-token
credentials
object
required

The credentials used to connect with Humanitec.

description
string | null

An optional description for the Humanitec Connection.

Maximum length: 256
projectId
string

The ID of the project to create the Humanitec Connection in.

isPlatformManagedCredentials
boolean

Not supported for Humanitec Connections.

gatewayId

Not supported for Humanitec Connections.

Response

Default Response

appConnection
object
required