---

Endpoint: https://v7.newspark.ca/gql
Type: GraphQL v1
Auth: (Not specified in schema – typically via Authorization header)

---

Root Schema

Query

• Vhost: Get access to Projects methods
• Applications: Interact with Application data
• Users: User management and lookup
• Transfers: File transfer services
• Assets: Media asset operations
• Channels: Channel hierarchy
• Groups: User grouping and permissions
• Authentication: Login and verification support

Mutation

(Details not included in your uploaded section — let me know if you’d like this added.)

---

Sample Query Structure

query {
  Users {
    user(id: 123) {
      id
      firstname
      email
    }
  }
}

---

Notable Object Types

MediaInfo

Details about an uploaded media file.

Field	Type	Description
id	String	Unique ID of the media
status	Int	0=Pending, 1=Processing, 2=Complete, 3=Failed
filetype	Int	0=Image, 1=Video, 2=Audio
filename	String	Original filename
filesize	BigInt	File size in bytes
contenttype	String	MIME type like "image/png"
upload	DateTime	Time of upload
tags	String	Space-separated tag list
location	String	Storage type (Amazon S3, etc)
user	UserInfo	Uploader’s details
publicUrl	String	Publicly accessible link
thumbUrl	String	Thumbnail image URL

---

UserInfo

Describes an end user.

Field	Type	Description
id	Int	User ID
email	String	Email address
firstname / lastname	String	User’s name
city, state, country, postalcode	String	Address info
birthdate	String	Date of birth
active, disabled	Boolean	Account status
created	String	Account creation date

---

Projects Queries

Method	Description
vhost(id: Int!)	Returns a MediaInfo object
getContentSummary(...)	Aggregate counts by vhost, channel, fileType, etc.
getUserSummary(...)	Active/registered user breakdowns
getTotals(...)	File usage and quota summaries

---

Users Queries

Method	Returns	Description
user(id: Int!)	UserInfo	Get a user by ID
users(...)	UserInfo	Filter, sort, and paginate through users
checkSSO(userName, vhost)	SSOResult	Check login for federated identity
sendVerificationCode(userId)	UserInfo	Triggers a verification email or SMS

---

🔧 Types and Filters

UserFilters Input

Field	Type	Description
firstname, lastname, user, city, country	String	Text filters
active, disabled	Boolean	Account status
groupid, eventid, nid	Int or [Int]	Association IDs
geo, deviceGeoCenter	String	Geolocation search
imFollowing, followingMe	Boolean	Social network behavior

---

ApplicationInfo

Field	Type	Description
id	ID	Unique application ID
name	String	Application name
maindomain	String	Main domain
class	String	Application class/type
settings	ApplicationSettings	Nested settings object
email	String	Admin/technical contact

---

Custom Scalars

• BigInt: Represents large integer values (as strings)
• DateTime: ISO 8601 UTC datetime
• ID, String, Int, Float, Boolean: Standard GraphQL types

---

Pagination Example

Most queries support optional params like start, limit, and sort.

query {
  Users {
    users(vhost: 2, start: 0, limit: 10, sort: "CREATED DESC") {
      id
      firstname
      email
    }
  }
}

---

Testing the API

You can test this GraphQL API using:

• Postman
• Insomnia
• In-browser tools like GraphQL Playground

Make requests to:

POST https://v7.newspark.ca/gql
Content-Type: application/json
Authorization: Bearer <your_token>

---

Would you like this exported as Markdown, HTML, or integrated into something like a Docusaurus or ReadMe.io layout? I can also refine descriptions for any other types you’re actively using.