Queries#

Quickslice generates a GraphQL query for each Lexicon record type at the /graphql endpoint. Queries are public; no authentication required.

Endpoints: Lexicon queries and mutations use /graphql. Admin operations (labels, reports, settings) use /admin/graphql.

Relay Connections#

Queries return data in the Relay Connection format:

query {
  xyzStatusphereStatus {
    edges {
      node {
        uri
        status
        createdAt
      }
      cursor
    }
    pageInfo {
      hasNextPage
      endCursor
    }
    totalCount
  }
}

• edges: Array of results, each containing a node (the record) and cursor (for pagination)
• pageInfo: Pagination metadata
• totalCount: Total number of matching records

Built-in Fields#

Every record includes these fields automatically:

The actorHandle field resolves the author's DID to their current handle, useful for display without a separate join:

query {
  xyzStatusphereStatus(first: 10) {
    edges {
      node {
        status
        actorHandle
      }
    }
  }
}

Filtering#

Use the where argument to filter records:

query {
  xyzStatusphereStatus(where: { status: { eq: "🎉" } }) {
    edges {
      node {
        status
        createdAt
      }
    }
  }
}

Filter Operators#

Filtering Ref Fields#

Reference fields (AT-URIs or strong refs pointing to other records) only support isNull. Use it to find records with or without a reference:

query {
  # Find root posts (no reply)
  appBskyFeedPost(where: { reply: { isNull: true } }) {
    edges {
      node {
        text
      }
    }
  }
}

query {
  # Find replies only
  appBskyFeedPost(where: { reply: { isNull: false } }) {
    edges {
      node {
        text
      }
    }
  }
}

Multiple Conditions#

Combine multiple conditions (they're ANDed together):

query {
  appBskyActorProfile(where: {
    displayName: { contains: "alice" }
    createdAt: { gt: "2025-01-01T00:00:00Z" }
  }) {
    edges {
      node {
        displayName
        description
      }
    }
  }
}

Sorting#

Use sortBy to order results:

query {
  xyzStatusphereStatus(sortBy: [{ field: createdAt, direction: DESC }]) {
    edges {
      node {
        status
        createdAt
      }
    }
  }
}

Multi-Field Sorting#

Sort by multiple fields (applied in order):

query {
  appBskyActorProfile(sortBy: [
    { field: displayName, direction: ASC }
    { field: createdAt, direction: DESC }
  ]) {
    edges {
      node {
        displayName
        createdAt
      }
    }
  }
}

Pagination#

Forward Pagination#

Use first to limit results and after to get the next page:

# First page
query {
  xyzStatusphereStatus(first: 10) {
    edges {
      node { status }
      cursor
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}

# Next page (use endCursor from previous response)
query {
  xyzStatusphereStatus(first: 10, after: "cursor_from_previous_page") {
    edges {
      node { status }
      cursor
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}

Backward Pagination#

Use last and before to paginate backward:

query {
  xyzStatusphereStatus(last: 10, before: "some_cursor") {
    edges {
      node { status }
      cursor
    }
    pageInfo {
      hasPreviousPage
      startCursor
    }
  }
}

PageInfo Fields#

Complete Example#

Combining filtering, sorting, and pagination:

query GetRecentStatuses($pageSize: Int!, $cursor: String) {
  xyzStatusphereStatus(
    where: { status: { in: ["👍", "🎉", "💙"] } }
    sortBy: [{ field: createdAt, direction: DESC }]
    first: $pageSize
    after: $cursor
  ) {
    edges {
      node {
        uri
        status
        createdAt
      }
      cursor
    }
    pageInfo {
      hasNextPage
      endCursor
    }
    totalCount
  }
}

Variables:

{
  "pageSize": 20,
  "cursor": null
}