> For the complete documentation index, see [llms.txt](https://docs.ox.security/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/unions/credential.md).

# credential

Represents all possible credential types that can be used for authentication.

### Examples

```graphql
union Credential = 
  | UserPasswordOnlyCredentials
  | TokenCredentials
  | UserPasswordCredentials
  | UrlOnlyCredentials
  | TokenAndUserCredentials
  | JiraServiceAccountCredentials
  | JiraServiceAccountOAuth2Credentials
  | ClientIdSecretKeyCredentials
  | AWSAssumeRoleCredentials
  | AWSAssumeRoleCredentialsOnprem
  | UserPasswordAndTenantCredentials
  | TokenAndProjectIdCredentials
  | TenantClientsubscriptionIdSecretCredentials
  | TenantIdClientIdClientSecretCredentials
  | GitHubAppCredentials
  | GitHubAppSelfHostedCredentials
  | BitbucketAppCredentials
  | APISecretAndAccessKeyCredentials
  | OrganizationIdAndApiKeyCredentials
  | ClientIdSecretApiUrlCredentials
  | OrganizationIdAndClientIdSecretApiUrlCredentials
  | TokenOnlyCredentials
  | AWSEKSCredentials
  | ClientIdClientSecretCredentials
  | ClientIdClientSecretNoHostCredentials
  | AzureCloudCredentials
  | AppIdAndTokenCredentials
  | WebhookCredentials
  | AksCredentials
  | GKECredentials
  | ServicePrincipalCredentials
  | IdentityProvider
  | BrokerCredentials
  | K8sInspectorCredentials
  | RuntimeSensor
  | BotIdentityProvider
  | AzureOpenAIApiCredentials
  | GcpWorkloadIdentityFederationCredentials
  | DatadogKeysCredentials
```

### Types

| Type                                                                                                                                                                                                     | Description                                                                                         |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| [`UserPasswordOnlyCredentials`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/user-password-only-credentials.md)                                                | Credentials using username and password only                                                        |
| [`TokenCredentials`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/token-credentials.md)                                                                        | Credentials using a token for authentication                                                        |
| [`UserPasswordCredentials`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/user-password-credentials.md)                                                         | Credentials using username and password with additional fields                                      |
| [`UrlOnlyCredentials`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/url-only-credentials.md)                                                                   | Credentials using only a URL                                                                        |
| [`TokenAndUserCredentials`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/token-and-user-credentials.md)                                                        | Credentials using token and username                                                                |
| [`JiraServiceAccountCredentials`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/jira-service-account-credentials.md)                                            | Credentials for Jira service account authentication                                                 |
| [`JiraServiceAccountOAuth2Credentials`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/jira-service-account-o-auth2credentials.md)                               | Credentials for Jira service account authentication via OAuth 2.0 client\_credentials               |
| [`ClientIdSecretKeyCredentials`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/client-id-secret-key-credentials.md)                                             | Credentials using client ID and secret key                                                          |
| [`AWSAssumeRoleCredentials`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/aws-assume-role-credentials.md)                                                      | Credentials for AWS role assumption                                                                 |
| [`AWSAssumeRoleCredentialsOnprem`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/aws-assume-role-credentials-onprem.md)                                         | Credentials for AWS role assumption in on-premises environments                                     |
| [`UserPasswordAndTenantCredentials`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/user-password-and-tenant-credentials.md)                                     | Credentials using username, password and tenant information                                         |
| [`TokenAndProjectIdCredentials`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/token-and-project-id-credentials.md)                                             | Credentials using token and project ID                                                              |
| [`TenantClientsubscriptionIdSecretCredentials`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/tenant-clientsubscription-id-secret-credentials.md)               | Credentials using tenant, client, subscription ID and secret                                        |
| [`TenantIdClientIdClientSecretCredentials`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/tenant-id-client-id-client-secret-credentials.md)                     | Credentials using tenant ID, client ID and client secret                                            |
| [`GitHubAppCredentials`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/git-hub-app-credentials.md)                                                              | Credentials for GitHub App authentication                                                           |
| [`GitHubAppSelfHostedCredentials`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/git-hub-app-self-hosted-credentials.md)                                        | Credentials for a customer-registered self-hosted GitHub App                                        |
| [`BitbucketAppCredentials`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/bitbucket-app-credentials.md)                                                         |                                                                                                     |
| [`APISecretAndAccessKeyCredentials`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/api-secret-and-access-key-credentials.md)                                    | Credentials using API secret and access key                                                         |
| [`OrganizationIdAndApiKeyCredentials`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/organization-id-and-api-key-credentials.md)                                | Credentials using organization ID and API key                                                       |
| [`ClientIdSecretApiUrlCredentials`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/client-id-secret-api-url-credentials.md)                                      | Credentials using client ID, secret, and API URL                                                    |
| [`OrganizationIdAndClientIdSecretApiUrlCredentials`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/organization-id-and-client-id-secret-api-url-credentials.md) | Credentials using Organization ID, client ID, client Secret, and API URL                            |
| [`TokenOnlyCredentials`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/token-only-credentials.md)                                                               | Credentials using only a token                                                                      |
| [`AWSEKSCredentials`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/awseks-credentials.md)                                                                      | Credentials for AWS EKS authentication                                                              |
| [`ClientIdClientSecretCredentials`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/client-id-client-secret-credentials.md)                                       | Credentials using client ID and client secret                                                       |
| [`ClientIdClientSecretNoHostCredentials`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/client-id-client-secret-no-host-credentials.md)                         | Credentials using client ID and client secret without host URL                                      |
| [`AzureCloudCredentials`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/azure-cloud-credentials.md)                                                             | Credentials for Azure Cloud authentication                                                          |
| [`AppIdAndTokenCredentials`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/app-id-and-token-credentials.md)                                                     | Credentials using application ID and token                                                          |
| [`WebhookCredentials`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/webhook-credentials.md)                                                                    | Credentials using webhook URL                                                                       |
| [`AksCredentials`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/aks-credentials.md)                                                                            | Credentials for Azure Kubernetes Service authentication                                             |
| [`GKECredentials`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/gke-credentials.md)                                                                            | Credentials for Google Kubernetes Engine authentication                                             |
| [`ServicePrincipalCredentials`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/service-principal-credentials.md)                                                 | Credentials for service principal authentication                                                    |
| [`IdentityProvider`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/identity-provider.md)                                                                        | Credentials for identity provider authentication                                                    |
| [`BrokerCredentials`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/broker-credentials.md)                                                                      | Credentials for broker authentication                                                               |
| [`K8sInspectorCredentials`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/k8s-inspector-credentials.md)                                                         | Credentials for Kubernetes inspector                                                                |
| [`RuntimeSensor`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/runtime-sensor.md)                                                                              | Credentials for Runtime Sensor                                                                      |
| [`BotIdentityProvider`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/bot-identity-provider.md)                                                                 | Credentials for bot identity provider authentication                                                |
| [`AzureOpenAIApiCredentials`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/azure-open-ai-api-credentials.md)                                                   | Credentials for Azure OpenAI API (token, endpoint, deployment name)                                 |
| [`GcpWorkloadIdentityFederationCredentials`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/gcp-workload-identity-federation-credentials.md)                     | Keyless GCP Workload Identity Federation credentials (token is a non-secret ox\_oidc\_wif envelope) |
| [`DatadogKeysCredentials`](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/datadog-keys-credentials.md)                                                           | Credentials for Datadog (API key, application key, site API host)                                   |

### References

#### Fields with this object:

* [{} Connector.credentials](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/connector.md)
* [{} CredentialResponse.credential](https://docs.ox.security/api-documentation/api-reference/api--connectors/types/objects/credential-response.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.ox.security/api-documentation/api-reference/api--connectors/types/unions/credential.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
