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

# Getting Started

> Introduction to the Graph API

The Supergraph is a unified GraphQL API that provides access to all platform services including authentication, booking, delivery, proctoring, and reporting. It serves as the primary integration point for all internal and external systems.

## Base URL

**GraphQL Endpoint:**
`https://api.talview.com/v1/graphql`

**Apollo Studio Explorer:**
[https://studio.apollographql.com/public/talview/variant/current/explorer](https://studio.apollographql.com/public/talview/variant/current/explorer)

## Authentication

All API requests require authentication using OAuth2 Bearer tokens. You must include your access token in the `Authorization` header for all requests.

For detailed instructions on generating and using access tokens, see the [Authentication Guide](/graph-api-reference/authentication).

## Error Handling

The API follows standard GraphQL error conventions. Errors thrown in both RESTful APIs and GraphQL endpoint use HTTP statuses as framework for error codes.

| Status Code | Description |
| :- | :- |
| 200 | Success - OK, request accepted successfully |
| 400 | Bad Request - Invalid query or variables |
| 401 | Unauthorized - missing or invalid token |
| 403 | Forbidden - insufficient permissions |
| 422 | UnprocessableEntity - validation errors |
| 429 | Too many requests - rate limit exceeded |
| 500 | Internal Server Error |
| 502 | Server timed out |

## Schema Definition and Reference

To explore the full capabilities of the Talview Supergraph, developers should refer to the official schema documentation. These resources provide a comprehensive guide to all available queries, mutations, and subscriptions.

* **[Schema Reference](https://studio.apollographql.com/public/talview/variant/current/schema/reference)**: Use this interactive reference to browse types, fields, and arguments defined in the Graph API.
* **[SDL (Schema Definition Language)](https://studio.apollographql.com/public/talview/variant/current/schema/sdl?selectedSchema=%23%40%21api%21%40%23)**: View the full SDL for a deep dive into the underlying schema structure.

We recommend developers consult these references when building integrations to ensure they are utilizing the most up-to-date and efficient data fetching methods.


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