---
updatedAt: 2025-09-29T20:17:48.000Z
agentTools:
  projectIndex: https://docs.bitwave.io/llms.txt
---

# /orgs/{orgId}/connections/{connectionId}/token

# OpenAPI definition

```json
{
  "components": {
    "schemas": {
      "ConnectionsErrorResponse": {
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "required": [
          "code",
          "message"
        ],
        "type": "object",
        "additionalProperties": false
      },
      "KeyBasedToken": {
        "properties": {
          "key": {
            "type": "string"
          },
          "secret": {
            "type": "string"
          }
        },
        "required": [
          "key"
        ],
        "type": "object",
        "additionalProperties": false
      },
      "UsernameBasedToken": {
        "properties": {
          "user": {
            "type": "string"
          },
          "password": {
            "type": "string"
          }
        },
        "required": [
          "user",
          "password"
        ],
        "type": "object",
        "additionalProperties": false
      },
      "JwtBasedToken": {
        "properties": {
          "jwt": {
            "type": "string"
          }
        },
        "required": [
          "jwt"
        ],
        "type": "object",
        "additionalProperties": false
      },
      "KeyBasedPassToken": {
        "properties": {
          "apiKey": {
            "type": "string"
          },
          "passphrase": {
            "type": "string"
          },
          "signingKey": {
            "type": "string"
          }
        },
        "required": [
          "apiKey",
          "passphrase",
          "signingKey"
        ],
        "type": "object",
        "additionalProperties": false
      },
      "MarketplaceAffiliateToken": {
        "properties": {
          "affiliateId": {
            "type": "number",
            "format": "double"
          },
          "submitterId": {
            "type": "number",
            "format": "double"
          }
        },
        "required": [
          "affiliateId",
          "submitterId"
        ],
        "type": "object",
        "additionalProperties": false
      },
      "PrivateKeyToken": {
        "properties": {
          "apiKey": {
            "type": "string"
          },
          "privateKey": {
            "type": "string"
          }
        },
        "required": [
          "apiKey",
          "privateKey"
        ],
        "type": "object",
        "additionalProperties": false
      },
      "AccessToken": {
        "properties": {
          "value": {
            "type": "string"
          }
        },
        "required": [
          "value"
        ],
        "type": "object",
        "additionalProperties": false
      },
      "OAuthToken": {
        "properties": {
          "accessToken": {
            "type": "string"
          },
          "refreshToken": {
            "type": "string"
          }
        },
        "required": [
          "accessToken",
          "refreshToken"
        ],
        "type": "object",
        "additionalProperties": false
      },
      "ApiKeyToken": {
        "properties": {
          "apiKey": {
            "type": "string"
          }
        },
        "required": [
          "apiKey"
        ],
        "type": "object",
        "additionalProperties": false
      }
    }
  },
  "info": {
    "title": "api-svc",
    "version": "1.0.1",
    "contact": {}
  },
  "openapi": "3.0.0",
  "paths": {
    "/orgs/{orgId}/connections/{connectionId}/token": {
      "get": {
        "operationId": "GetConnectionToken",
        "responses": {
          "200": {
            "description": "Ok",
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/KeyBasedToken"
                    },
                    {
                      "$ref": "#/components/schemas/UsernameBasedToken"
                    },
                    {
                      "$ref": "#/components/schemas/JwtBasedToken"
                    },
                    {
                      "$ref": "#/components/schemas/KeyBasedPassToken"
                    },
                    {
                      "$ref": "#/components/schemas/MarketplaceAffiliateToken"
                    },
                    {
                      "$ref": "#/components/schemas/PrivateKeyToken"
                    },
                    {
                      "$ref": "#/components/schemas/ConnectionsErrorResponse"
                    },
                    {
                      "$ref": "#/components/schemas/AccessToken"
                    },
                    {
                      "$ref": "#/components/schemas/OAuthToken"
                    },
                    {
                      "$ref": "#/components/schemas/ApiKeyToken"
                    }
                  ]
                }
              }
            }
          }
        },
        "tags": [
          "Connections"
        ],
        "security": [
          {
            "jwt": [
              "urn:orgs:*:connections:*:tokens",
              "urn:orgs:$orgId:connection-token:read"
            ]
          }
        ],
        "parameters": [
          {
            "in": "path",
            "name": "orgId",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "connectionId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    }
  },
  "servers": [
    {
      "url": "https://api.bitwave.io/"
    }
  ],
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```