> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fidel80.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GraphQL API

***

## title: "GraphQL API" description: "Understand the Fidel80 GraphQL endpoint, authentication, and request format."

Fidel80 exposes its developer API through GraphQL.

## Endpoint

Send GraphQL requests to:

```text theme={null}
/graphql/
```

Use the base URL assigned to the Fidel80 environment for your organization.

## Authentication

Authenticated developer requests use a Fidel80 API key.

Send the key in the HTTP `Authorization` header:

```http theme={null}
Authorization: Bearer fidel80_your_api_key_here
```

See [API Keys](https://docs.fidel80.com/authentication/api-keys.md) for setup instructions.

## Request format

GraphQL requests use HTTP `POST` with a JSON body:

```http theme={null}
POST /graphql/
Content-Type: application/json
Authorization: Bearer fidel80_your_api_key_here
```

The JSON body contains a GraphQL query or mutation and optional variables:

```json theme={null}
{
  "query": "...",
  "variables": {}
}
```

## Example

A request to generate a verification token follows this structure:

```json theme={null}
{
  "query": "mutation GenerateVerificationToken($input: GenerateVerificationTokenInput!) { generateVerificationToken(input: $input) { success message tokenString } }",
  "variables": {
    "input": {
      "workflowId": 123,
      "workflowVersionId": 456
    }
  }
}
```

## Errors

If Fidel80 cannot complete a GraphQL operation, the response may contain an `errors` array.

Examples include:

* authentication is required,
* the API key is invalid or expired,
* the workflow does not exist or is not accessible,
* the workflow is not active,
* the workflow version does not belong to the selected workflow,
* subscription or verification usage limits prevent the operation.

> [!NOTE]
>
> The hostname is environment-specific. Use the Fidel80 base URL provided for your test or production environment.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.