# Integrations

## GET /integrations/atlassian/confluence/start/

>

```json
{"openapi":"3.1.1","info":{"title":"Turngate API","version":"v1"},"servers":[{"url":"https://api.turngate.io/"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"apiKey","name":"Authorization","in":"header"}}},"paths":{"/integrations/atlassian/confluence/start/":{"get":{"operationId":"integrations_atlassian_confluence_start_list","description":"","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"confluence_oauth_state":{"type":"string"}}}}}}},"tags":["integrations"]}}}}
```

## GET /integrations/atlassian/jira/start/

>

```json
{"openapi":"3.1.1","info":{"title":"Turngate API","version":"v1"},"servers":[{"url":"https://api.turngate.io/"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"apiKey","name":"Authorization","in":"header"}}},"paths":{"/integrations/atlassian/jira/start/":{"get":{"operationId":"integrations_atlassian_jira_start_list","description":"","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"jira_oauth_state":{"type":"string"}}}}}}},"tags":["integrations"]}}}}
```

## GET /integrations/box/start/

>

```json
{"openapi":"3.1.1","info":{"title":"Turngate API","version":"v1"},"servers":[{"url":"https://api.turngate.io/"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"apiKey","name":"Authorization","in":"header"}}},"paths":{"/integrations/box/start/":{"get":{"operationId":"integrations_box_start_list","description":"","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"csrf_token":{"type":"string"}}}}}}},"tags":["integrations"]}}}}
```

## GET /integrations/datasources/

> View for Listing and creating on /integration/datasources.

```json
{"openapi":"3.1.1","info":{"title":"Turngate API","version":"v1"},"servers":[{"url":"https://api.turngate.io/"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"DataSource":{"required":["uuid","type","name"],"type":"object","properties":{"uuid":{"title":"Uuid","type":"string","format":"uuid"},"type":{"$ref":"#/components/schemas/IntegrationType"},"name":{"title":"Name","type":"string","maxLength":255,"minLength":1},"expiry":{"title":"Expiry","type":"string","format":"date-time"},"created_at":{"title":"Created at","type":"string","format":"date-time","readOnly":true},"secret_name":{"title":"Secret name","type":"string","readOnly":true,"minLength":1},"enabled":{"title":"Enabled","type":"boolean"}}},"IntegrationType":{"required":["name"],"type":"object","properties":{"id":{"title":"ID","type":"integer","readOnly":true},"uuid":{"title":"Uuid","type":"string","format":"uuid","readOnly":true},"name":{"title":"Name","type":"string","maxLength":255,"minLength":1},"slug":{"title":"Slug","type":"string","format":"slug","pattern":"^[-a-zA-Z0-9_]+$","maxLength":50},"token_def":{"title":"Token def","type":"object"},"logo_data":{"title":"Logo data","type":"string"},"difficulty":{"title":"Difficulty","type":"integer","maximum":2147483647,"minimum":0},"oauth_start_url":{"title":"Oauth start url","type":"string","readOnly":true},"oauth_form":{"title":"Oauth form","type":"object","readOnly":true}}}}},"paths":{"/integrations/datasources/":{"get":{"operationId":"integrations_datasources_list","description":"View for Listing and creating on /integration/datasources.","parameters":[{"name":"search","in":"query","description":"A search term.","required":false,"type":"string"},{"name":"page","in":"query","description":"A page number within the paginated result set.","required":false,"type":"integer"},{"name":"page_size","in":"query","description":"Number of results to return per page.","required":false,"type":"integer"}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"required":["count","results"],"type":"object","properties":{"count":{"type":"integer"},"next":{"type":"string","format":"uri"},"previous":{"type":"string","format":"uri"},"results":{"type":"array","items":{"$ref":"#/components/schemas/DataSource"}}}}}}}},"tags":["integrations"]}}}}
```

## POST /integrations/datasources/

> View for Listing and creating on /integration/datasources.

```json
{"openapi":"3.1.1","info":{"title":"Turngate API","version":"v1"},"servers":[{"url":"https://api.turngate.io/"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"DataSourceCreate":{"required":["name"],"type":"object","properties":{"uuid":{"title":"Uuid","type":"string","format":"uuid"},"organization":{"type":"integer","title":"Organization"},"type":{"type":"integer","title":"Type"},"name":{"title":"Name","type":"string","maxLength":255,"minLength":1},"secret_name":{"title":"Secret name","type":"string","readOnly":true,"minLength":1},"enabled":{"title":"Enabled","type":"boolean"},"expiry":{"title":"Expiry","type":"string","format":"date-time"},"token":{"title":"Token","type":"object"},"code":{"title":"Code","description":"Authorization code from OAuth2 flow","type":"string","minLength":1},"state":{"title":"State","description":"State from /start endpoint","type":"string","minLength":1}}}}},"paths":{"/integrations/datasources/":{"post":{"operationId":"integrations_datasources_create","description":"View for Listing and creating on /integration/datasources.","responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSourceCreate"}}}}},"tags":["integrations"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSourceCreate"}}},"required":true}}}}}
```

## GET /integrations/datasources/{uuid}/

>

```json
{"openapi":"3.1.1","info":{"title":"Turngate API","version":"v1"},"servers":[{"url":"https://api.turngate.io/"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"DataSourceUpdate":{"required":["uuid","name"],"type":"object","properties":{"uuid":{"title":"Uuid","type":"string","format":"uuid"},"type":{"$ref":"#/components/schemas/IntegrationType"},"name":{"title":"Name","type":"string","maxLength":255,"minLength":1},"expiry":{"title":"Expiry","type":"string","format":"date-time"},"created_at":{"title":"Created at","type":"string","format":"date-time","readOnly":true},"secret_name":{"title":"Secret name","type":"string","readOnly":true,"minLength":1},"enabled":{"title":"Enabled","type":"boolean"}}},"IntegrationType":{"required":["name"],"type":"object","properties":{"id":{"title":"ID","type":"integer","readOnly":true},"uuid":{"title":"Uuid","type":"string","format":"uuid","readOnly":true},"name":{"title":"Name","type":"string","maxLength":255,"minLength":1},"slug":{"title":"Slug","type":"string","format":"slug","pattern":"^[-a-zA-Z0-9_]+$","maxLength":50},"token_def":{"title":"Token def","type":"object"},"logo_data":{"title":"Logo data","type":"string"},"difficulty":{"title":"Difficulty","type":"integer","maximum":2147483647,"minimum":0},"oauth_start_url":{"title":"Oauth start url","type":"string","readOnly":true},"oauth_form":{"title":"Oauth form","type":"object","readOnly":true}}}}},"paths":{"/integrations/datasources/{uuid}/":{"get":{"operationId":"integrations_datasources_read","description":"","responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSourceUpdate"}}}}},"tags":["integrations"]}}}}
```

## PUT /integrations/datasources/{uuid}/

>

```json
{"openapi":"3.1.1","info":{"title":"Turngate API","version":"v1"},"servers":[{"url":"https://api.turngate.io/"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"DataSourceUpdate":{"required":["uuid","name"],"type":"object","properties":{"uuid":{"title":"Uuid","type":"string","format":"uuid"},"type":{"$ref":"#/components/schemas/IntegrationType"},"name":{"title":"Name","type":"string","maxLength":255,"minLength":1},"expiry":{"title":"Expiry","type":"string","format":"date-time"},"created_at":{"title":"Created at","type":"string","format":"date-time","readOnly":true},"secret_name":{"title":"Secret name","type":"string","readOnly":true,"minLength":1},"enabled":{"title":"Enabled","type":"boolean"}}},"IntegrationType":{"required":["name"],"type":"object","properties":{"id":{"title":"ID","type":"integer","readOnly":true},"uuid":{"title":"Uuid","type":"string","format":"uuid","readOnly":true},"name":{"title":"Name","type":"string","maxLength":255,"minLength":1},"slug":{"title":"Slug","type":"string","format":"slug","pattern":"^[-a-zA-Z0-9_]+$","maxLength":50},"token_def":{"title":"Token def","type":"object"},"logo_data":{"title":"Logo data","type":"string"},"difficulty":{"title":"Difficulty","type":"integer","maximum":2147483647,"minimum":0},"oauth_start_url":{"title":"Oauth start url","type":"string","readOnly":true},"oauth_form":{"title":"Oauth form","type":"object","readOnly":true}}}}},"paths":{"/integrations/datasources/{uuid}/":{"put":{"operationId":"integrations_datasources_update","description":"","responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSourceUpdate"}}}}},"tags":["integrations"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSourceUpdate"}}},"required":true}}}}}
```

## DELETE /integrations/datasources/{uuid}/

>

```json
{"openapi":"3.1.1","info":{"title":"Turngate API","version":"v1"},"servers":[{"url":"https://api.turngate.io/"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"apiKey","name":"Authorization","in":"header"}}},"paths":{"/integrations/datasources/{uuid}/":{"delete":{"operationId":"integrations_datasources_delete","description":"","responses":{"204":{"description":""}},"tags":["integrations"]}}}}
```

## PATCH /integrations/datasources/{uuid}/

>

```json
{"openapi":"3.1.1","info":{"title":"Turngate API","version":"v1"},"servers":[{"url":"https://api.turngate.io/"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"DataSourceCreate":{"required":["name"],"type":"object","properties":{"uuid":{"title":"Uuid","type":"string","format":"uuid"},"organization":{"type":"integer","title":"Organization"},"type":{"type":"integer","title":"Type"},"name":{"title":"Name","type":"string","maxLength":255,"minLength":1},"secret_name":{"title":"Secret name","type":"string","readOnly":true,"minLength":1},"enabled":{"title":"Enabled","type":"boolean"},"expiry":{"title":"Expiry","type":"string","format":"date-time"},"token":{"title":"Token","type":"object"},"code":{"title":"Code","description":"Authorization code from OAuth2 flow","type":"string","minLength":1},"state":{"title":"State","description":"State from /start endpoint","type":"string","minLength":1}}}}},"paths":{"/integrations/datasources/{uuid}/":{"patch":{"operationId":"integrations_datasources_partial_update","description":"","responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSourceCreate"}}}}},"tags":["integrations"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSourceCreate"}}},"required":true}}}}}
```

## GET /integrations/dropbox/start/

>

```json
{"openapi":"3.1.1","info":{"title":"Turngate API","version":"v1"},"servers":[{"url":"https://api.turngate.io/"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"apiKey","name":"Authorization","in":"header"}}},"paths":{"/integrations/dropbox/start/":{"get":{"operationId":"integrations_dropbox_start_list","description":"","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"dropbox-auth-csrf-token":{"type":"string"}}}}}}},"tags":["integrations"]}}}}
```

## GET /integrations/github/start/

>

```json
{"openapi":"3.1.1","info":{"title":"Turngate API","version":"v1"},"servers":[{"url":"https://api.turngate.io/"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"apiKey","name":"Authorization","in":"header"}}},"paths":{"/integrations/github/start/":{"get":{"operationId":"integrations_github_start_list","description":"","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"github_oauth_state":{"type":"string"}}}}}}},"tags":["integrations"]}}}}
```

## GET /integrations/google-workspaces/start/

>

```json
{"openapi":"3.1.1","info":{"title":"Turngate API","version":"v1"},"servers":[{"url":"https://api.turngate.io/"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"apiKey","name":"Authorization","in":"header"}}},"paths":{"/integrations/google-workspaces/start/":{"get":{"operationId":"integrations_google-workspaces_start_list","description":"","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"oauth_state":{"type":"string"}}}}}}},"tags":["integrations"]}}}}
```

## GET /integrations/integration-markdown/{integration\_uuid}/

>

```json
{"openapi":"3.1.1","info":{"title":"Turngate API","version":"v1"},"servers":[{"url":"https://api.turngate.io/"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"SetupMarkdown":{"required":["title","markdown"],"type":"object","properties":{"title":{"title":"Title","type":"string","maxLength":255,"minLength":1},"markdown":{"title":"Markdown","type":"string","minLength":1}}}}},"paths":{"/integrations/integration-markdown/{integration_uuid}/":{"get":{"operationId":"integrations_integration-markdown_read","description":"","parameters":[{"name":"search","in":"query","description":"A search term.","required":false,"type":"string"},{"name":"page","in":"query","description":"A page number within the paginated result set.","required":false,"type":"integer"},{"name":"page_size","in":"query","description":"Number of results to return per page.","required":false,"type":"integer"}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"required":["count","results"],"type":"object","properties":{"count":{"type":"integer"},"next":{"type":"string","format":"uri"},"previous":{"type":"string","format":"uri"},"results":{"type":"array","items":{"$ref":"#/components/schemas/SetupMarkdown"}}}}}}}},"tags":["integrations"]}}}}
```

## GET /integrations/integration-types/

>

```json
{"openapi":"3.1.1","info":{"title":"Turngate API","version":"v1"},"servers":[{"url":"https://api.turngate.io/"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"IntegrationType":{"required":["name"],"type":"object","properties":{"id":{"title":"ID","type":"integer","readOnly":true},"uuid":{"title":"Uuid","type":"string","format":"uuid","readOnly":true},"name":{"title":"Name","type":"string","maxLength":255,"minLength":1},"slug":{"title":"Slug","type":"string","format":"slug","pattern":"^[-a-zA-Z0-9_]+$","maxLength":50},"token_def":{"title":"Token def","type":"object"},"logo_data":{"title":"Logo data","type":"string"},"difficulty":{"title":"Difficulty","type":"integer","maximum":2147483647,"minimum":0},"oauth_start_url":{"title":"Oauth start url","type":"string","readOnly":true},"oauth_form":{"title":"Oauth form","type":"object","readOnly":true}}}}},"paths":{"/integrations/integration-types/":{"get":{"operationId":"integrations_integration-types_list","description":"","parameters":[{"name":"search","in":"query","description":"A search term.","required":false,"type":"string"},{"name":"page","in":"query","description":"A page number within the paginated result set.","required":false,"type":"integer"},{"name":"page_size","in":"query","description":"Number of results to return per page.","required":false,"type":"integer"}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"required":["count","results"],"type":"object","properties":{"count":{"type":"integer"},"next":{"type":"string","format":"uri"},"previous":{"type":"string","format":"uri"},"results":{"type":"array","items":{"$ref":"#/components/schemas/IntegrationType"}}}}}}}},"tags":["integrations"]}}}}
```

## GET /integrations/salesforce/start/

>

```json
{"openapi":"3.1.1","info":{"title":"Turngate API","version":"v1"},"servers":[{"url":"https://api.turngate.io/"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"apiKey","name":"Authorization","in":"header"}}},"paths":{"/integrations/salesforce/start/":{"get":{"operationId":"integrations_salesforce_start_list","description":"","parameters":[{"name":"subdomain","in":"query","description":"SalesForce Subdomain","type":"string"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"csrf_token":{"type":"string"}}}}}}},"tags":["integrations"]}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://support.turngate.io/api-documentation/integrations.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.