{"type":"api","title":"List Integrations","meta":{"id":"/apps/pubhub/media/cloud-security-apis-in-eft/d2a1854d5c0ed9069a7f0bc54a9b813f3075ddc9/ac5e908c-3245-3ba5-9e49-5ab5d54d743e","info":{"title":"Cisco Secure Access Third-Party Integrations API","version":"1.0.0","description":"Create and manage the third-party applications integrated with Secure Access.\nSecure Access integrates with third-party applications, which support either REST APIs or Webhooks.","contact":{"name":"Cloud Security Developer Community"}},"security":[{"oauthFlow":[]}],"tags":[{"name":"Integrations","description":"Integration management"},{"name":"Credentials","description":"Credential management"},{"name":"Integration Types","description":"Integration types"},{"name":"Secure Access"}],"x-parser-conf":{"overview":{"markdownPath":"secure-access/reference/admin/third-party-integrations-overview.md","uri":"secure-access-api-reference-third-party-integrations-overview"}},"openapi":"3.1.0","servers":[{"url":"https://api.sse.cisco.com/{basePath}","variables":{"basePath":{"default":"admin/v2"}}}],"securitySchemes":{"oauthFlow":{"type":"oauth2","description":"The client credential flow.","flows":{"clientCredentials":{"tokenUrl":"https://api.sse.cisco.com/auth/v2/token","scopes":{"admin.integrations:write":"Update, delete integrations","admin.integrations:read":"Read integrations"}}}}}},"spec":{"summary":"List Integrations","operationId":"getIntegrations","description":"List the third-party applications integrated in the organization. Filter the collection by `type` and `status`.","security":[{"oauthFlow":["admin.integrations:read"]}],"tags":["Integrations","Secure Access"],"parameters":[{"description":"Filter for the integrations by the status.","example":"active","in":"query","name":"status","schema":{"description":"The status of the integrations.","enum":["created","active","inactive"],"type":"string"},"$$ref":"#/components/parameters/status"},{"description":"The integrations listed by the type.","example":"chrome-enterprise.v1","in":"query","name":"type","schema":{"description":"The type of the integration.","enum":["chrome-enterprise.v1","webhook.v1","jamf.v1","intune.v1"],"type":"string"},"$$ref":"#/components/parameters/type"},{"description":"The place to start reading in the collection. The default offset is 0.","explode":false,"in":"query","name":"offset","schema":{"description":"The number of a record in the collection.","format":"int64","minimum":0,"type":"integer"},"example":10,"$$ref":"#/components/parameters/offset"},{"description":"The maximum number of items returned in the response counting from the offset.","explode":false,"in":"query","name":"limit","schema":{"description":"The maximum number of items in the collection returned in the response.","format":"int64","minimum":0,"type":"integer"},"example":50,"$$ref":"#/components/parameters/limit"}],"responses":{"200":{"headers":{"Content-Type":{"schema":{"type":"string"},"description":"The MIME content type of the response body.","example":"application/json","$$ref":"#/components/headers/Content-Type"},"Date":{"schema":{"type":"string","pattern":"^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$"},"description":"The date and time (ISO 8601-formatted timestamp) when the system returned the response.","example":"2023-03-14T18:34:25Z","$$ref":"#/components/headers/Date"}},"content":{"application/json":{"schema":{"type":"object","description":"The paginated list of integrations returned in the response.","properties":{"data":{"description":"The list of integrations in the organization.","items":{"type":"object","description":"The properties of the integrated third-party application.","properties":{"createdAt":{"description":"The date and time when the system created the integration.","format":"date-time","type":"string","example":"2024-01-15T10:30:00Z","$$ref":"#/components/schemas/integrationCreatedAt"},"createdBy":{"description":"The username of the administrator who created the integration.","type":"string","example":"user@admin.com","$$ref":"#/components/schemas/integrationCreatedBy"},"createdFromIp":{"type":"string","description":"The IP address of the device or network where the integration was created.","example":"192.168.1.100","$$ref":"#/components/schemas/createdFromIp"},"credentials":{"type":"array","description":"The list of credentials associated with the integration.","items":{"type":"object","description":"The properties of the credentials resource.","properties":{"createdAt":{"description":"The date and time when the system created the credentials for the integration.","format":"date-time","type":"string","example":"2024-01-15T10:30:00Z","$$ref":"#/components/schemas/credentialCreatedAt"},"createdBy":{"description":"The username of the administrator who created the credentials for the integration.","type":"string","example":"user@admin.com","$$ref":"#/components/schemas/credentialCreatedBy"},"createdFromIp":{"type":"string","description":"The IP address of the device or network where the integration was created.","example":"192.168.1.100","$$ref":"#/components/schemas/createdFromIp"},"href":{"description":"The URL for the credentials resource.","type":"string","example":"https://api.sse.cisco.com/admin/v2/integrations/123/credentials/456","$$ref":"#/components/schemas/credentialHref"},"name":{"description":"The name of the credentials.","type":"string","example":"credential one","$$ref":"#/components/schemas/credentialName"},"tags":{"type":"array","description":"The list of tags associated with the credentials.","items":{"type":"string","description":"The tag associated with the credentials."},"example":["credential one"],"$$ref":"#/components/schemas/credentialTags"},"type":{"description":"The authentication method used to obtain the credential.","enum":["google-service-account","basic-auth","piam-token","iroh-token"],"type":"string","example":"piam-token","$$ref":"#/components/schemas/credentialType"},"value":{"type":"object","description":"The properties of the value object in the credentials.","properties":{"href":{"description":"The URL for the credentials resource.","type":"string","example":"https://api.sse.cisco.com/admin/v2/integrations/123/credentials/456","$$ref":"#/components/schemas/credentialHref"},"password":{"description":"The password for the credential.","type":"string","example":"SecurePassword124!"},"serviceAccountId":{"description":"The ID of the Service Account.","type":"string","example":"service-account-123"},"serviceAccountKey":{"description":"The key for the Service Account.","type":"string","example":"-----BEGIN PRIVATE KEY-----\n MIIEvQ..."},"token":{"description":"The access token for the authentication of the credentials.","type":"string","example":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."},"username":{"description":"The username associated with the credential.","type":"string"}},"example":{"username":"api_user","password":"secure_password123","token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9"},"$$ref":"#/components/schemas/credentialValue"}},"required":["href","name","type","value","tags","createdBy","createdAt","createdFromIp"],"example":{"createdBy":"admin@company.com","createdAt":"2024-01-15T10:30:00Z","createdFromIp":"10.1.1.50","href":"https://api.sse.cisco.com/admin/v2/integrations/123/credentials/456","name":"Database Credential","type":"basic-auth","tags":["database","production"],"value":{"username":"db_user","password":"encrypted_password"}},"$$ref":"#/components/schemas/Credential"},"$$ref":"#/components/schemas/credentials"},"href":{"description":"The URL for the integration.","type":"string","example":"https://api.sse.cisco.com/admin/v2/integrations/123","$$ref":"#/components/schemas/integrationHref"},"intuneConfig":{"type":"object","description":"The configuration settings for the integration of the Azure AD application.","properties":{"clientCredentialId":{"description":"The Azure AD client ID.","type":"string","example":"credentialid1","$$ref":"#/components/schemas/clientCredentialIdIntune"},"clientCredentialSecret":{"description":"The Azure AD client secret.","type":"string","example":"credentialsecret1","$$ref":"#/components/schemas/clientCredentialSecretIntune"},"clientCredentialTokenUrl":{"description":"The OAuth 2.0 token endpoint URL for the authentication of the Azure AD application.","type":"string","example":"tokenauthurl@abc.com","$$ref":"#/components/schemas/clientCredentialTokenUrlIntune"},"moduleInstanceId":{"description":"The unique ID for the Iroh module instance that manages the Intune integration.","type":"string","example":"iroh-jamf-instance","$$ref":"#/components/schemas/moduleInstanceIdIntune"}},"example":{"clientCredentialId":"intune-client-123","clientCredentialSecret":"secret-value","clientCredentialTokenUrl":"https://login.microsoftonline.com/tenant/oauth2/v2.0/token","moduleInstanceId":"iroh-module-456"},"$$ref":"#/components/schemas/IntuneConfig"},"jamfConfig":{"type":"object","description":"The configured settings for the Jamf Pro integration.","properties":{"clientCredentialId":{"description":"The Jamf Pro client ID.","type":"string","example":"credentialid1","$$ref":"#/components/schemas/clientCredentialIdJamf"},"clientCredentialSecret":{"description":"The Jamf Pro client secret.","type":"string","example":"credentialsecret1","$$ref":"#/components/schemas/clientCredentialSecretJamf"},"moduleInstanceId":{"description":"The unique ID for the Iroh module instance that manages the Jamf Pro integration.","type":"string","example":"iroh-jamf-instance","$$ref":"#/components/schemas/moduleInstanceIdJamf"},"urlJamf":{"description":"The base URL of the Jamf Pro server.","type":"string","example":"https://company.jamfcloud.com","$$ref":"#/components/schemas/urlJamf"}},"example":{"clientCredentialId":"jamf-client-789","clientCredentialSecret":"jamf-secret","moduleInstanceId":"iroh-jamf-instance","url":"https://company.jamfcloud.com"},"$$ref":"#/components/schemas/JamfConfig"},"name":{"description":"The name of the integration.","maxLength":250,"minLength":1,"type":"string","example":"integration one","$$ref":"#/components/schemas/integrationName"},"region":{"description":"The region where the system deployed the integration.","type":"string","example":"us-west1","$$ref":"#/components/schemas/integrationRegion"},"status":{"description":"The status of the integration.","type":"string","enum":["active","created","inactive"],"example":"active","$$ref":"#/components/schemas/integrationStatus"},"tags":{"type":"array","description":"The list of tags associated with the integration.","items":{"type":"string","description":"The tag associated with the integration."},"example":["integration one"],"$$ref":"#/components/schemas/integrationTags"},"type":{"description":"The type of the integration.","enum":["chrome-enterprise.v1","webhook.v1","jamf.v1","intune.v1"],"type":"string","example":"jamf.v1","$$ref":"#/components/schemas/integrationType"},"updatedFromIp":{"type":"string","description":"The IP address of the device or network where the integration was last updated.","example":"192.168.1.101","$$ref":"#/components/schemas/updatedFromIp"},"webhookConfig":{"type":"object","description":"The configuration settings for the Webhook integration.","required":["url"],"properties":{"headers":{"additionalProperties":{"type":"string","description":"The HTTP headers for the Webhook integration."},"type":"object","$$ref":"#/components/schemas/headers"},"queryParams":{"type":"object","description":"The query parameters for the Webhook integration.","additionalProperties":{"type":"string"},"$$ref":"#/components/schemas/queryParams"},"url":{"description":"The URL of the Webhook integration for receiving notifications.","type":"string","example":"https://api.company.com/webhook/integration-events","$$ref":"#/components/schemas/urlWebHook"}},"example":{"url":"https://api.company.com/webhook","headers":{"Content-Type":"application/json","Authorization":"Bearer token123"},"queryParams":{"source":"integration-service","version":"v1"}},"$$ref":"#/components/schemas/WebhookConfig"}},"required":["href","name","type","createdBy","createdAt","createdFromIp","status"],"example":{"createdBy":"admin@company.com","createdAt":"2024-01-15T10:30:00Z","createdFromIp":"192.168.1.101","href":"https://api.sse.cisco.com/admin/v2/integrations/123","name":"Production Webhook","type":"webhook.v1","status":"active","region":"us-west-2","tags":["production","webhook"],"webhookConfig":{"url":"https://api.company.com/webhook","headers":{"Content-Type":"application/json"}}},"$$ref":"#/components/schemas/Integration"},"type":"array"},"limit":{"description":"The maximum number of items returned in the collection, counting from the offset.","format":"int64","minimum":0,"type":"integer","example":100,"$$ref":"#/components/schemas/limit"},"offset":{"description":"The place to start reading in the collection.","format":"int64","minimum":0,"default":0,"type":"integer","example":10,"$$ref":"#/components/schemas/offset"},"total":{"description":"The total number of items in the collection.","format":"int64","minimum":0,"type":"integer","example":500,"$$ref":"#/components/schemas/total"}},"required":["total","offset","limit","data"],"example":{"total":25,"offset":0,"limit":10,"data":[{"createdBy":"admin@company.com","createdAt":"2024-01-15T10:30:00Z","createdFromIp":"192.168.1.10","href":"https://api.sse.cisco.com/admin/v2/integrations/123","name":"Production Webhook","type":"webhook.v1","status":"active"}]},"$$ref":"#/components/schemas/ListIntegrationsOutputBody"}}},"description":"OK"},"400":{"description":"Bad Request","headers":{"Content-Type":{"schema":{"type":"string"},"description":"The MIME content type of the response body.","example":"application/json","$$ref":"#/components/headers/Content-Type"},"Date":{"schema":{"type":"string","pattern":"^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$"},"description":"The date and time (ISO 8601-formatted timestamp) when the system returned the response.","example":"2023-03-14T18:34:25Z","$$ref":"#/components/headers/Date"}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Bad Request","example":"Not found IAM key info for org 12355."},"status":{"type":"integer","description":"The HTTP status code returned in the response.","example":400}}}}},"$$ref":"#/components/responses/400Error"},"401":{"description":"Unauthorized","headers":{"Content-Type":{"schema":{"type":"string"},"description":"The MIME content type of the response body.","example":"application/json","$$ref":"#/components/headers/Content-Type"},"Date":{"schema":{"type":"string","pattern":"^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$"},"description":"The date and time (ISO 8601-formatted timestamp) when the system returned the response.","example":"2023-03-14T18:34:25Z","$$ref":"#/components/headers/Date"}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Unauthorized","example":"Authorization token is invalid."},"status":{"type":"integer","description":"The HTTP status code returned in the response.","example":401}}}}},"$$ref":"#/components/responses/401Error"},"403":{"description":"Forbidden","headers":{"Content-Type":{"schema":{"type":"string"},"description":"The MIME content type of the response body.","example":"application/json","$$ref":"#/components/headers/Content-Type"},"Date":{"schema":{"type":"string","pattern":"^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$"},"description":"The date and time (ISO 8601-formatted timestamp) when the system returned the response.","example":"2023-03-14T18:34:25Z","$$ref":"#/components/headers/Date"}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message explaining the reason for failure.","example":"Forbidden"},"status":{"type":"integer","description":"The HTTP status code returned in the response.","example":403}}}}},"$$ref":"#/components/responses/403Error"},"404":{"description":"Not Found","headers":{"Content-Type":{"schema":{"type":"string"},"description":"The MIME content type of the response body.","example":"application/json","$$ref":"#/components/headers/Content-Type"},"Date":{"schema":{"type":"string","pattern":"^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$"},"description":"The date and time (ISO 8601-formatted timestamp) when the system returned the response.","example":"2023-03-14T18:34:25Z","$$ref":"#/components/headers/Date"}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message explaining the reason for failure.","example":"Not Found"},"status":{"type":"integer","description":"The HTTP status code returned in the response.","example":404}}}}},"$$ref":"#/components/responses/404Error"},"500":{"description":"Internal Server Error","headers":{"Content-Type":{"schema":{"type":"string"},"description":"The MIME content type of the response body.","example":"application/json","$$ref":"#/components/headers/Content-Type"},"Date":{"schema":{"type":"string","pattern":"^[0-90-90-90-9-0-90-9-0-90-9T0-90-9:0-90-9:0-90-9Z]+$"},"description":"The date and time (ISO 8601-formatted timestamp) when the system returned the response.","example":"2023-03-14T18:34:25Z","$$ref":"#/components/headers/Date"}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message explaining the reason for failure.","example":"Internal Server Error"},"status":{"type":"integer","description":"The HTTP status code returned in the response.","example":500}}}}},"$$ref":"#/components/responses/500Error"}},"method":"get","path":"/integrations"}}