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:

/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:

Authorization: Bearer fidel80_your_api_key_here

See API Keys for setup instructions.

Request format

GraphQL requests use HTTP POST with a JSON body:

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:

{
  "query": "...",
  "variables": {}
}

Example

A request to generate a verification token follows this structure:

{
  "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.

The hostname is environment-specific. Use the Fidel80 base URL provided for your test or production environment.

Getting Started

Authentication

API Reference

Integration Guides

Resources

title: “GraphQL API” description: “Understand the Fidel80 GraphQL endpoint, authentication, and request format.”

Endpoint

Authentication

Request format

Example

Errors