> ## 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.