Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Requests made to Xray's GraphQL API must also be authenticated using the same end point endpoint for REST API authentication.

The authentication process uses a Client IdID and a Client Secret, both of which are based on an API Key created for a specific user in Xray Global Settings: API Keys global settings.

Thus, the first step for you is to obtain the token based on the Client Id ID and Client Secret of your assigned API Key. You can then use any GraphQL or REST API end pointsendpoints.


Note
titleAPI Rate Limit

As Like Jira, Xray limits the rate for API requests to ensure that services are reliable and responsive to customers.

Xray Standard has a limit of 300 per 5 minutes & Xray Enterprise of 1000 per 5 minutes. Please check Jira documentation to learn more about about Jira Cloud API Rate Limit.

...

This is just an entry page that contains basic information about GraphQL API. You can access the complete schema documentation in the following URL:

Info

https://us.xray.cloud.getxray.app/

doc

v2/graphql


Xray GraphQL API Endpoint

Info

https://xray.cloud.getxray.app/api/v2/graphql


Info
titleXray GraphQL API endpoint

For deployments that use data residency, please use the url URL that matches your Xray region for more performant API.

Available endpoints by zone

Location

Region

Endpoint

USAConsists of USA region

https://us.xray.cloud.getxray.app/

doc

v2/graphql

/

EUConsists of Europe (Frankfurt) region

https://eu.xray.cloud.getxray.app/

doc

v2/graphql

/

AustraliaConsists of Australia (Sydney) region

https://au.xray.cloud.getxray.app/

doc

v2/graphql

/


Discovering the Xray Cloud GraphQL API

...

It's helpful to picture a graph: dots connected by lines. The dots are nodes, the lines are edges. A connection defines a relationship between nodes.

Anchor
items
items

Item

Item is is a generic term for an object. You can look up a an item directly, or you can access related items via a connection. If you specify a item that does not return a scalar, you must include subfields until all fields return scalars.

Anchor
resolver
resolver

Resolver

Resolver is is a generic term for a query, mutation, or complex field. A complex field is any field in Xray Cloud GraphQL API that is not a scalar with with the exception of the fields field results.

Here are some links that provide extra information and tools related with to GraphQL:

  • GraphQL Documentation - here you can find general information about all aspects of GraphQL.
  • Insomnia - a powerful HTTP client with native GraphQL support.