Skip to main content

Client Type

The Client type represents an organization or entity that owns brands.

Type Definition​

"""
Represents a client organization.
"""
type Client {
  """
  Unique identifier for the client.
  """
  id: Int!

  """
  Name of the client organization.
  """
  name: String!

  """
  Optional logo URL.
  """
  logo: String

  """
  List of brands owned by this client.
  """
  brands: [Brand!]!
}

Fields​

FieldTypeDescription
idInt!Required. Unique identifier
nameString!Required. Organization name
logoStringOptional. Logo URL
brands[Brand!]!Required. List of brands

Example Query​

query GetClient {
  client(id: 123) {
    id
    name
    logo
    brands {
      id
      name
      productionRuns {
        id
        description
      }
    }
  }
}

Best Practices​

  1. Authentication

    • Always include valid JWT with client_list claim
    • Handle token expiration gracefully

  2. Performance

    • Request only needed fields
    • Consider caching strategies

  3. Security

    • Validate client access
    • Audit sensitive actions
    • Rate limit operations