GraphQL

Execute a GraphQL operation

Send a GraphQL query or mutation. Authorization is evaluated for every selected field.

Authentication

Authorizationbearer token

Requires podcasts.read — Read podcasts, seasons, episodes, feeds, and analytics.

Body parameters

application/json

querystringrequired

The GraphQL document to execute.

variablesobject

Variables referenced by the GraphQL document.

operationNamestring | null

Selects an operation when the document contains more than one.

Responses

200Successful response

400The request is invalid

401Authentication is missing or invalid

403The token does not have the required scope

429Rate limit exceeded

const response = await fetch('https://api.ufw.dev/v1/graphql', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "query": "query { viewer { id } }",
    "variables": {}
  }),
});

const data = await response.json();

Response200

{
  "data": {
    "viewer": {
      "id": "acc_7Kd2Rm9QpX",
      "displayName": "Ada Lovelace"
    }
  }
}