Skipper

GraphQL schema reference · API guide · SDKs

Skipper, the AI assistant: conversations and reports.

Types used by more than one domain are on Shared types.

Queries

Query.skipperConversation

Get a single Skipper conversation with full message history.

skipperConversation(
  id: ID!
): SkipperConversation!

Returns: SkipperConversation! (SkipperConversation)

Arguments

• id: ID!

SDK

Operation	TypeScript	Go	Python
GetSkipperConversation	GetSkipperConversationDocument	GetSkipperConversation	get_skipper_conversation

Query.skipperConversations

List Skipper AI consultant conversations for the current user.

skipperConversations(
  limit: Int
  offset: Int
): [SkipperConversationSummary!]!

Returns: [SkipperConversationSummary!]! (SkipperConversationSummary)

Arguments

• limit: Int
• offset: Int

SDK

Operation	TypeScript	Go	Python
GetSkipperConversations	GetSkipperConversationsDocument	GetSkipperConversations	get_skipper_conversations

Query.skipperReport

Fetch a single Skipper investigation report by id. Returns null when the report does not exist or is not owned by the current tenant.

skipperReport(
  id: ID!
): SkipperReport

Returns: SkipperReport (SkipperReport)

Arguments

• id: ID!

SDK

Operation	TypeScript	Go	Python
GetSkipperReport	GetSkipperReportDocument	GetSkipperReport	get_skipper_report

Query.skipperReports

List Skipper investigation reports for the current tenant. Returns newest first with read/unread status and counts.

skipperReports(
  limit: Int
  offset: Int
): SkipperReportsConnection!

Returns: SkipperReportsConnection! (SkipperReportsConnection)

Arguments

• limit: Int
• offset: Int

SDK

Operation	TypeScript	Go	Python
GetSkipperReports	GetSkipperReportsDocument	GetSkipperReports	get_skipper_reports

Query.skipperUnreadReportCount

Get count of unread Skipper investigation reports.

skipperUnreadReportCount: Int!

Returns: Int!

SDK

Operation	TypeScript	Go	Python
GetSkipperUnreadReportCount	GetSkipperUnreadReportCountDocument	GetSkipperUnreadReportCount	get_skipper_unread_report_count

Mutations

Mutation.deleteSkipperConversation

Delete a Skipper conversation.

deleteSkipperConversation(
  id: ID!
): Boolean!

Returns: Boolean!

Arguments

• id: ID!

SDK

Operation	TypeScript	Go	Python
DeleteSkipperConversation	DeleteSkipperConversationDocument	DeleteSkipperConversation	delete_skipper_conversation

Mutation.markSkipperReportsRead

Mark Skipper investigation reports as read. Pass specific IDs, or omit to mark all as read. Returns the number of reports marked.

markSkipperReportsRead(
  ids: [ID!]
): Int!

Returns: Int!

Arguments

• ids: [ID!]

SDK

Operation	TypeScript	Go	Python
MarkSkipperReportsRead	MarkSkipperReportsReadDocument	MarkSkipperReportsRead	mark_skipper_reports_read

Mutation.updateSkipperConversation

Update the title of a Skipper conversation.

updateSkipperConversation(
  id: ID!
  title: String!
): SkipperConversationSummary!

Returns: SkipperConversationSummary! (SkipperConversationSummary)

Arguments

• id: ID!
• title: String!

SDK

Operation	TypeScript	Go	Python
UpdateSkipperConversation	UpdateSkipperConversationDocument	UpdateSkipperConversation	update_skipper_conversation

Types

SkipperConversation

object

• id: ID!
• title: String!
• messages: [SkipperMessage!]! (SkipperMessage)
• createdAt: Time! (Time)
• updatedAt: Time! (Time)

SkipperConversationSummary

object

• id: ID!
• title: String!
• createdAt: Time! (Time)
• updatedAt: Time! (Time)

SkipperMessage

object

• id: ID!
• role: String!
• content: String!
• confidence: String
• sources: JSON (JSON)
• toolsUsed: JSON (JSON)
• confidenceBlocks: JSON (JSON)
• tokensInput: Int!
• tokensOutput: Int!
• createdAt: Time! (Time)

SkipperReport

object

• id: ID!
• trigger: String!
• summary: String!
• metricsReviewed: [String!]!
• rootCause: String!
• recommendations: [SkipperReportRecommendation!]! (SkipperReportRecommendation)
• createdAt: Time! (Time)
• readAt: Time (Time)

SkipperReportRecommendation

object

• text: String!
• confidence: String!

SkipperReportsConnection

object

• nodes: [SkipperReport!]! (SkipperReport)
• totalCount: Int!
• unreadCount: Int!