Base URL
GraphQL Endpoint:https://api.talview.com/v1/graphql
Apollo Studio 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 theAuthorization header for all requests.
For detailed instructions on generating and using access tokens, see the Authentication Guide.
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: Use this interactive reference to browse types, fields, and arguments defined in the Graph API.
- SDL (Schema Definition Language): View the full SDL for a deep dive into the underlying schema structure.