Get Connection - Apinizer Dokümantasyonu

Endpoint

GET /apiops/projects/{projectName}/connections/{connectionName}/

Authentication

Requires a Personal API Access Token.

Authorization: Bearer YOUR_TOKEN

Request

Headers

Header	Value	Required
Authorization	Bearer	Yes

Path Parameters

Parameter	Type	Required	Description
projectName	string	Yes	Project name
connectionName	string	Yes	Connection name

Query Parameters

None

Response

Success Response (200 OK)

{
  "success": true,
  "resultList": [
    {
      "type": "email",
      "name": "my-email-connection",
      "description": "Email connection for notifications",
      "deployToWorker": true,
      "enabled": true,
      "host": "smtp.gmail.com",
      "port": 587,
      "username": "[email protected]",
      "password": "actual-password",
      "enableStartTls": true,
      "auth": true,
      "defaultEncoding": "UTF-8",
      "addressToTest": "[email protected]",
      "from": "[email protected]",
      "additionalProperties": []
    }
  ],
  "resultCount": 1
}

Response Fields

Field	Type	Description
success	boolean	Indicates if the request was successful
resultList	array	List containing single connection object
resultCount	integer	Always 1 for get operation

Connection Object Fields (Common)

Field	Type	Description
type	string	Connection type discriminator field. Identifies the connection type in API responses.
name	string	Connection name
description	string	Connection description
deployToWorker	boolean	Whether to deploy to worker
enabled	boolean	Whether connection is enabled

Note: Connection-specific fields vary by connection type. Secret fields are returned in full (not masked) when getting a single connection.

Error Response (400 Bad Request)

{
  "error": "bad_request",
  "error_description": "Connection name can not be empty!"
}

Error Response (401 Unauthorized)

{
  "error": "unauthorized_client",
  "error_description": "Invalid token"
}

Error Response (404 Not Found)

{
  "error": "not_found",
  "error_description": "Connection (name: my-email-connection) was not found!"
}

cURL Example

curl -X GET \
  "https://demo.apinizer.com/apiops/projects/MyProject/connections/my-email-connection/" \
  -H "Authorization: Bearer YOUR_TOKEN"

Full JSON Body Example

This endpoint does not require a request body.

Notes and Warnings

Secret Fields: Unlike list operations, secret fields (password, apiKey, etc.) are returned in full when getting a single connection
Security: Never log or expose connection responses containing secrets
Connection Types: Each connection type has different fields. See individual connection type documentation for details:
- Email Connection
- Kafka Connection
- Database Connection
- … (see Connections Index for complete list)

List Connections - List all connections (secrets masked)
Create Connection - Create a new connection
Update Connection - Update a connection
Delete Connection - Delete a connection
Email Connection - Email connection details

Home

​Endpoint

​Authentication

​Header

​Request

​Headers

​Path Parameters

​Query Parameters

​Response

​Success Response (200 OK)

​Response Fields

​Connection Object Fields (Common)

​Error Response (400 Bad Request)

​Error Response (401 Unauthorized)

​Error Response (404 Not Found)

​cURL Example

​Full JSON Body Example

​Notes and Warnings

​Related Documentation