picked 0.0.101 → 0.0.102-next.2

package/docs/reference/management-api/schema/analytics-session.md

@@ -6,7 +6,7 @@ generated: true
 
 # Analytics session schema
 
-The operations and types that `analytics-session.graphql` adds to the Management API. See [Management API schema](/reference/management-api/schema) for every domain, the endpoint and authentication.
+See [Management API schema](/reference/management-api/schema) for every domain, the endpoint and authentication.
 
 ## Types
 
@@ -14,40 +14,35 @@ The operations and types that `analytics-session.graphql` adds to the Management
 
 ```graphql
 """
-One visit by a visitor: the analytics events one person produced on a site, from
-their first event until 30 minutes passed without another. A lead's `session` is
-the visit during which the lead was captured.
+A visit: the analytics events one visitor produced on a site, from their first event until 30
+minutes passed without another.
 """
 type AnalyticsSession {
-  """The identity resolver's session identifier."""
+  """The ID of the session."""
   id: ID!
   """
-  What the visit adds up to, each event counted once: when it started and ended,
-  how the visitor arrived, and on what device from where. Requires scope:
-  `ORGANIZATION_LEADS_READ`.
+  What the visit adds up to: when it started and ended, how the visitor arrived, and their device
+  and location.
+  Scope: `ORGANIZATION_LEADS_READ`.
   """
   summary: AnalyticsSessionSummary! @auth
   """
-  The visit's timeline: the events that read as the visitor's path, each once,
-  oldest first. Without a cursor, `last` ends the page with the capture event and
-  `first` starts it there; with neither, the page is the 20 events ending with the
-  capture. A page holds at most 100 events. The newest events can take a few
-  minutes to arrive. Requires scope: `ORGANIZATION_LEADS_READ`.
+  The visit's timeline, oldest first. Without a cursor, the page is anchored on the visit's capture
+  event, or on its latest event when it captured no lead: `last` ends the page there, `first`
+  starts it there, and with neither the page is the 20 events ending there. A page holds at most
+  100 events. The newest events can take a few minutes to arrive.
+  Scope: `ORGANIZATION_LEADS_READ`.
   """
   events(first: Int, after: String, last: Int, before: String): AnalyticsEventConnection! @auth
   """
-  The lead captured during the visit, or null when it captured none. A session
-  listed by `Project.analyticsSessions` that captured several gives the latest; one
-  reached through `Lead.session` gives that lead. Requires scope:
-  `ORGANIZATION_LEADS_READ`.
+  The lead captured during the visit. Null when the visit captured none. Reached through
+  `Lead.session`, it is that lead; otherwise it is the latest lead the visit captured.
+  Scope: `ORGANIZATION_LEADS_READ`.
   """
   lead: Lead @auth
   """
-  The Session reports on the visit, in order: the overview, the
-  journey through the experience's steps, and the full event log. Each is a
-  signed guest embed URL with the session's project and the session locked,
-  read from the project's analytics warehouse. Requires scope:
-  `ORGANIZATION_LEADS_READ`.
+  The Session reports on the visit: the overview, the journey and the event log, in that order.
+  Scope: `ORGANIZATION_LEADS_READ`.
   """
   reports: [AnalyticsSessionReport!]! @auth
 }
@@ -57,15 +52,13 @@ type AnalyticsSession {
 
 ```graphql
 """
-A report on one analytics session, embedded with the session's
-project and the session locked, so the embed shows that visit and no other.
+A report on one analytics session, embedded so that it shows that visit and no other.
 """
 type AnalyticsSessionReport {
   """Which of the Session reports this is."""
   kind: AnalyticsSessionReportKind!
   """
-  URL of a signed embed of the report, for an iframe. The
-  signature expires 3 hours after the field is read.
+  The URL of a signed embed of the report, for an iframe. It expires 3 hours after it is read.
   """
   embedUrl: String!
 }
@@ -74,7 +67,7 @@ type AnalyticsSessionReport {
 ### `AnalyticsSessionReportKind`
 
 ```graphql
-"""The Session reports."""
+"""The reports on one analytics session."""
 enum AnalyticsSessionReportKind {
   """
   How the visit ended, who the visitor was, when they were active and their other visits.
@@ -84,7 +77,7 @@ enum AnalyticsSessionReportKind {
   Every step entry in order, with time on step, submit outcomes, errors and clicks.
   """
   JOURNEY
-  """Every event the visit recorded, in order, in the visitor's clock."""
+  """Every event the visit recorded, in order, by the visitor's clock."""
   EVENT_LOG
 }
 ```
@@ -93,17 +86,14 @@ enum AnalyticsSessionReportKind {
 
 ```graphql
 """
-One of the project's Sessions reports: a Metabase dashboard over all of its
-sessions, signed for embedding with the project locked, so the embed shows that
-project's sessions and no other. Its date range is an editable filter inside the
-embed.
+A report on all of a project's analytics sessions, embedded so that it shows that project's
+sessions and no other. Its date range is a filter inside the embed.
 """
 type AnalyticsSessionsReport {
   """Which of the Sessions reports this is."""
   kind: AnalyticsSessionsReportKind!
   """
-  URL of a signed embed of the report, for an iframe. The
-  signature expires 3 hours after the field is read.
+  The URL of a signed embed of the report, for an iframe. It expires 3 hours after it is read.
   """
   embedUrl: String!
 }
@@ -112,7 +102,7 @@ type AnalyticsSessionsReport {
 ### `AnalyticsSessionsReportKind`
 
 ```graphql
-"""The Sessions reports."""
+"""The reports on all of a project's analytics sessions."""
 enum AnalyticsSessionsReportKind {
   """
   How sessions arrive: volume, channel, referrer, campaign, landing page, device, place and time of arrival.
@@ -123,7 +113,7 @@ enum AnalyticsSessionsReportKind {
   """
   JOURNEYS
   """
-  Which sessions convert: the funnel, the conversion rate by week and by segment.
+  Which sessions convert: the funnel, and the conversion rate by week and by segment.
   """
   CONVERSION
 }
@@ -132,21 +122,17 @@ enum AnalyticsSessionsReportKind {
 ### `AnalyticsSessionConnection`
 
 ```graphql
-"""
-Relay-style connection of analytics sessions, with both an `edges` list and a flat `nodes` accessor.
-"""
+"""A page of analytics sessions."""
 type AnalyticsSessionConnection {
-  """List of analytics-session edges."""
+  """The edges in this page."""
   edges: [AnalyticsSessionEdge!]!
-  """
-  Flat list of analytics sessions, equivalent to `edges[].node`. Convenience accessor.
-  """
+  """The items in this page."""
   nodes: [AnalyticsSession!]!
-  """Pagination metadata."""
+  """Where this page sits in the list."""
   pageInfo: PageInfo!
   """
-  Metrics over every session the connection's `window` holds, across all pages.
-  Pass `first: 0` on `Project.analyticsSessions` to read metrics without fetching a page.
+  Metrics over every session in the connection's `window`, across all pages. Pass `first: 0` on
+  `Project.analyticsSessions` to read the metrics without a page.
   """
   metrics: AnalyticsSessionMetrics!
 }
@@ -156,15 +142,13 @@ type AnalyticsSessionConnection {
 
 ```graphql
 """
-Metrics over the sessions an `AnalyticsSessionConnection` holds. Every metric
-ignores the connection's page.
+Metrics over the sessions an `AnalyticsSessionConnection` holds, across all pages.
 """
 type AnalyticsSessionMetrics {
   """
-  Sessions by when each started. A session is its events inside the window, so
-  a visit that began before the window counts from its first event inside it.
-  
-  `groupBy` splits the count; `CONVERTED` into `converted` and `not_converted`.
+  The number of sessions, by when each started. A session counts from its first event inside the
+  window, so a visit that began before the window counts. `groupBy: CONVERTED` splits the count
+  into `converted` and `not_converted`.
   """
   count(groupBy: AnalyticsSessionCountGroupBy): CountMetric!
 }
@@ -175,10 +159,7 @@ type AnalyticsSessionMetrics {
 ```graphql
 """What a session count can be split by."""
 enum AnalyticsSessionCountGroupBy {
-  """
-  Whether the session converted: one of its events inside the window captured a
-  lead, a `lead_created` or `lead_capture`.
-  """
+  """Whether one of the session's events inside the window captured a lead."""
   CONVERTED
 }
 ```
@@ -186,11 +167,11 @@ enum AnalyticsSessionCountGroupBy {
 ### `AnalyticsSessionEdge`
 
 ```graphql
-"""Edge type for `AnalyticsSessionConnection`."""
+"""An analytics session in a page of results."""
 type AnalyticsSessionEdge {
-  """Pagination cursor for this edge."""
+  """The cursor of this edge."""
   cursor: String!
-  """The analytics session."""
+  """The item."""
   node: AnalyticsSession!
 }
 ```
@@ -206,29 +187,30 @@ type AnalyticsSessionSummary {
   startedAt: DateTime!
   """When the session's last event happened, by the visitor's device clock."""
   endedAt: DateTime!
-  """How many events the session's `events` timeline lists."""
+  """The number of events the session's `events` timeline lists."""
   eventCount: Int!
-  """How many pages the visitor viewed."""
+  """The number of pages the visitor viewed."""
   pageViewCount: Int!
-  """Full URL of the first page the session's events happened on."""
+  """
+  The full URL of the session's first page. Null when no event recorded one.
+  """
   landingPageUrl: String
   """
-  Where the visitor came from, as the tracker classified the landing page's referrer.
+  Where the visitor came from. Null when the landing page had no referrer.
   """
   referrer: AnalyticsReferrer
-  """The UTM campaign the landing page's URL carried."""
+  """The UTM campaign of the landing page's URL. Null when it carried none."""
   campaign: AnalyticsCampaign
-  """The visitor's device, as parsed from their user agent."""
+  """The visitor's device. Null when it is unknown."""
   device: AnalyticsDevice
-  """Where the visitor was, as looked up from their IP address."""
+  """Where the visitor was. Null when it is unknown."""
   location: AnalyticsLocation
   """
-  The visitor's Google Analytics client ID, from the session's first event to carry one.
+  The visitor's Google Analytics client ID, from the first event to carry one. Null when none did.
   """
   gaid: String
   """
-  The visitor's Picked ID: the canonical id identity resolution gave them, from the session's
-  first event to carry one.
+  The visitor's Picked ID, from the first event to carry one. Null when none did.
   """
   visitorId: String
 }
@@ -237,7 +219,7 @@ type AnalyticsSessionSummary {
 ### `AnalyticsReferrer`
 
 ```graphql
-"""The site that referred a visitor, as the tracker classified its URL."""
+"""The site that referred a visitor. A field is null when it is unknown."""
 type AnalyticsReferrer {
   """The referrer's name, in lowercase, such as `google` or `facebook`."""
   source: String
@@ -251,7 +233,9 @@ type AnalyticsReferrer {
 ### `AnalyticsCampaign`
 
 ```graphql
-"""A visit's UTM campaign parameters."""
+"""
+A visit's UTM campaign parameters. A field is null when the URL did not carry it.
+"""
 type AnalyticsCampaign {
   """`utm_source`."""
   source: String
@@ -265,7 +249,9 @@ type AnalyticsCampaign {
 ### `AnalyticsDevice`
 
 ```graphql
-"""A visitor's device, as parsed from their user agent."""
+"""
+A visitor's device, as read from their user agent. A field is null when it is unknown.
+"""
 type AnalyticsDevice {
   """The class of device, such as `Desktop`, `Phone` or `Tablet`."""
   category: String
@@ -283,7 +269,9 @@ type AnalyticsDevice {
 ### `AnalyticsLocation`
 
 ```graphql
-"""Where a visitor was, as looked up from their IP address."""
+"""
+Where a visitor was, as looked up from their IP address. A field is null when it is unknown.
+"""
 type AnalyticsLocation {
   """The city's English name."""
   city: String
@@ -300,12 +288,11 @@ type AnalyticsLocation {
 
 ```graphql
 """
-One analytics event in a visitor's session: a page viewed, a step entered or
-submitted, a product added to the cart, a lead captured. Together, a session's
-events read as the visitor's path through the site.
+One analytics event in a visit: a page viewed, a step entered or submitted, a product added to the
+cart, a lead captured. A text field is null when the event did not record it.
 """
 type AnalyticsEvent {
-  """Unique event identifier."""
+  """The ID of the event."""
   id: ID!
   """
   The event type, such as `page_view`, `step_enter`, `cart_add` or `lead_created`.
@@ -313,17 +300,17 @@ type AnalyticsEvent {
   type: String!
   """When the event happened, by the visitor's device clock."""
   occurredAt: DateTime!
-  """Full URL of the page the event happened on."""
+  """The full URL of the page the event happened on."""
   pageUrl: String
-  """Path of the page the event happened on."""
+  """The path of the page the event happened on."""
   pagePath: String
-  """Title of the experience the event happened in."""
+  """The title of the experience the event happened in."""
   experienceTitle: String
-  """Title of the step the event concerns."""
+  """The title of the step the event concerns."""
   stepTitle: String
-  """Title of the form the event concerns."""
+  """The title of the form the event concerns."""
   formTitle: String
-  """Title of the modal the event concerns."""
+  """The title of the modal the event concerns."""
   modalTitle: String
   """
   The name of a product the event concerns: one of them, when it concerns several.
@@ -335,17 +322,13 @@ type AnalyticsEvent {
 ### `AnalyticsEventConnection`
 
 ```graphql
-"""
-Relay-style connection of analytics events, with both an `edges` list and a flat `nodes` accessor.
-"""
+"""A page of analytics events."""
 type AnalyticsEventConnection {
-  """List of analytics-event edges."""
+  """The edges in this page."""
   edges: [AnalyticsEventEdge!]!
-  """
-  Flat list of analytics events, equivalent to `edges[].node`. Convenience accessor.
-  """
+  """The items in this page."""
   nodes: [AnalyticsEvent!]!
-  """Pagination metadata."""
+  """Where this page sits in the list."""
   pageInfo: PageInfo!
 }
 ```
@@ -353,11 +336,11 @@ type AnalyticsEventConnection {
 ### `AnalyticsEventEdge`
 
 ```graphql
-"""Edge type for `AnalyticsEventConnection`."""
+"""An analytics event in a page of results."""
 type AnalyticsEventEdge {
-  """Pagination cursor for this edge."""
+  """The cursor of this edge."""
   cursor: String!
-  """The analytics event."""
+  """The item."""
   node: AnalyticsEvent!
 }
 ```

package/docs/reference/management-api/schema/analytics.md

@@ -6,13 +6,15 @@ generated: true
 
 # Analytics schema
 
-The operations and types that `analytics.graphql` adds to the Management API. See [Management API schema](/reference/management-api/schema) for every domain, the endpoint and authentication.
+See [Management API schema](/reference/management-api/schema) for every domain, the endpoint and authentication.
 
 ## Queries
 
 ### `pickedqlQuery`
 
-Execute a PickedQL query scoped to the caller's authorised projects.
+Runs a PickedQL query against one project's analytics data. A statement that does not parse, or
+queries a project's data without a `project_id` filter, fails with `VALIDATION_ERROR`.
+Scope: `ORGANIZATION_REPORTS_READ`.
 
 ```graphql
 pickedqlQuery(input: PickedqlQueryInput!): PickedqlQueryResult! @auth
@@ -23,10 +25,10 @@ pickedqlQuery(input: PickedqlQueryInput!): PickedqlQueryResult! @auth
 ### `PickedqlQueryInput`
 
 ```graphql
-"""Input for `pickedqlQuery` — execute a PickedQL statement."""
+"""The input of `pickedqlQuery`."""
 input PickedqlQueryInput {
   """
-  The SQL query to execute. Must include a tenant filter (e.g. `WHERE project_id = '…'`).
+  The PickedQL statement. A query of a project's data must filter on `project_id`.
   """
   sql: String!
 }
@@ -35,13 +37,13 @@ input PickedqlQueryInput {
 ### `PickedqlTableDataColumn`
 
 ```graphql
-"""Column metadata for a PickedQL query result."""
+"""A column of a PickedQL result."""
 type PickedqlTableDataColumn {
-  """The column identifier."""
+  """The column's name."""
   name: String!
-  """The data type (e.g. `String`, `UInt64`, `DateTime`)."""
+  """The column's data type, such as `String`, `UInt64` or `DateTime`."""
   dataType: String!
-  """Human-readable column label."""
+  """The column's label."""
   displayName: String!
 }
 ```
@@ -49,12 +51,12 @@ type PickedqlTableDataColumn {
 ### `PickedqlTableData`
 
 ```graphql
-"""Structured table data from a PickedQL query."""
+"""The rows and columns a PickedQL query returned."""
 type PickedqlTableData {
-  """Column definitions with name, type, and display name."""
+  """The columns, in order."""
   columns: [PickedqlTableDataColumn!]!
   """
-  Rows of cell values. Each row is a list of stringified cell values aligned with the `columns` array.
+  The rows. Each row holds one cell per column, as a string; null for a null cell.
   """
   rowData: [[String]!]!
 }
@@ -63,11 +65,11 @@ type PickedqlTableData {
 ### `PickedqlQueryResult`
 
 ```graphql
-"""Result of a PickedQL query (ShopifyQL-style structured shape)."""
+"""The result of a PickedQL query."""
 type PickedqlQueryResult {
-  """Structured table data, null if the query failed to parse or validate."""
+  """The rows and columns. Null when the query failed to run."""
   tableData: PickedqlTableData
-  """Parse or validation errors, empty if the query succeeded."""
+  """The errors that stopped the query from running. Empty when it ran."""
   parseErrors: [String!]!
 }
 ```

package/docs/reference/management-api/schema/api-key.md

@@ -6,13 +6,14 @@ generated: true
 
 # Api key schema
 
-The operations and types that `api-key.graphql` adds to the Management API. See [Management API schema](/reference/management-api/schema) for every domain, the endpoint and authentication.
+See [Management API schema](/reference/management-api/schema) for every domain, the endpoint and authentication.
 
 ## Queries
 
 ### `apiKeys`
 
-List API keys for an organisation. Requires authentication.
+Lists an organisation's API keys, newest first. Revoked keys are left out.
+Scope: `ORGANIZATION_API_KEYS_READ`.
 
 ```graphql
 apiKeys(input: ApiKeysInput!): [ApiKey!]! @auth
@@ -22,7 +23,9 @@ apiKeys(input: ApiKeysInput!): [ApiKey!]! @auth
 
 ### `apiKeyCreate`
 
-Create a new API key. Requires scope: `ORGANIZATION_API_KEYS_CREATE`. User authentication only (not API key).
+Creates an API key and returns the full key, once. A blank name, no scopes, or a scope the caller
+does not hold or the key cannot carry returns `VALIDATION_ERROR`.
+Scope: `ORGANIZATION_API_KEYS_CREATE`.
 
 ```graphql
 apiKeyCreate(input: ApiKeyCreateInput!): ApiKeyCreatePayload! @auth(only: USER)
@@ -30,7 +33,9 @@ apiKeyCreate(input: ApiKeyCreateInput!): ApiKeyCreatePayload! @auth(only: USER)
 
 ### `apiKeyRevoke`
 
-Revoke an API key. Requires scope: `ORGANIZATION_API_KEYS_DELETE`.
+Revokes an API key, which then stops authenticating at once. Cannot be undone; an unknown or
+revoked key returns `NOT_FOUND`.
+Scope: `ORGANIZATION_API_KEYS_DELETE`.
 
 ```graphql
 apiKeyRevoke(input: ApiKeyRevokeInput!): Boolean! @auth
@@ -42,38 +47,33 @@ apiKeyRevoke(input: ApiKeyRevokeInput!): Boolean! @auth
 
 ```graphql
 """
-An API key for programmatic access. Scoped to one organisation; may
-additionally be scoped to a single project. Carries a static list of
-authorisation scopes that gate every API operation the key performs.
-
-`keyPrefix` is the first few characters of the secret — used as a
-human-readable identifier in the dashboard and audit logs. The full
-secret is only returned once at creation time (see `ApiKeyCreatePayload`).
+A credential for a server-to-server integration. It belongs to an organisation, can belong to one
+project, and carries scopes. The full key is returned only once, by `apiKeyCreate`.
 """
 type ApiKey {
-  """Unique identifier for the API key."""
+  """The ID of the API key."""
   id: ID!
-  """Display name of the API key."""
+  """The name of the API key."""
   name: String!
   """
-  Prefix of the key for identification (e.g. `pk_abc12…`). Safe to log and display.
+  The first 8 and last 3 characters of the key, to tell keys apart. Safe to display.
   """
   keyPrefix: String!
   """
-  ID of the project this key is scoped to, or null when the key is org-wide.
+  The ID of the project the key belongs to. Null when the key covers the whole organisation.
   """
   projectId: String
-  """Name of the project this key is scoped to (denormalised for display)."""
+  """
+  The name of the project the key belongs to. Null when the key covers the whole organisation.
+  """
   projectName: String
-  """ID of the user who created this key."""
+  """The ID of the user who created the key."""
   createdBy: ID!
-  """Email of the user who created this key (denormalised for display)."""
+  """The email address of the user who created the key."""
   createdByEmail: String!
-  """When this key was created."""
+  """When the key was created."""
   createdAt: String!
-  """
-  Scopes this API key has access to. Must be a subset of the creator's scopes at creation time.
-  """
+  """The scopes the key holds."""
   scopes: [Scope!]!
 }
 ```
@@ -81,9 +81,9 @@ type ApiKey {
 ### `ApiKeyEdge`
 
 ```graphql
-"""Edge type for `ApiKeyConnection`."""
+"""An API key in a page of results."""
 type ApiKeyEdge {
-  """Pagination cursor for this edge."""
+  """The cursor of this edge."""
   cursor: String!
   """The API key."""
   node: ApiKey!
@@ -93,13 +93,13 @@ type ApiKeyEdge {
 ### `ApiKeyConnection`
 
 ```graphql
-"""Relay-style connection of API keys."""
+"""A page of API keys."""
 type ApiKeyConnection {
-  """List of API key edges."""
+  """The edges in this page."""
   edges: [ApiKeyEdge!]!
-  """Pagination metadata."""
+  """Where this page sits in the list."""
   pageInfo: PageInfo!
-  """Total number of API keys."""
+  """The total number of API keys."""
   totalCount: Int!
 }
 ```
@@ -108,14 +108,11 @@ type ApiKeyConnection {
 
 ```graphql
 """
-Payload returned by `apiKeyCreate`. WARNING: `apiKey` is the only place
-the full secret is exposed; subsequent reads return only the prefix.
-Show it to the user once and discard.
+The result of `apiKeyCreate`. `apiKey` is the only place the full key appears; later reads return
+`keyPrefix` only.
 """
 type ApiKeyCreatePayload {
-  """
-  The full API key — shown only once at creation time. Treat as sensitive.
-  """
+  """The full API key. Returned only here."""
   apiKey: String!
 }
 ```
@@ -123,9 +120,9 @@ type ApiKeyCreatePayload {
 ### `ApiKeysInput`
 
 ```graphql
-"""Input for listing API keys."""
+"""The input of `apiKeys`."""
 input ApiKeysInput {
-  """ID of the organisation to list keys for."""
+  """The ID of the organisation whose keys to list."""
   organizationId: ID!
 }
 ```
@@ -133,25 +130,20 @@ input ApiKeysInput {
 ### `ApiKeyCreateInput`
 
 ```graphql
-"""
-Input for `apiKeyCreate`. Scopes must be a subset of the creator's
-scopes — granting a scope the caller does not hold is rejected with
-`FORBIDDEN`.
-"""
+"""The input of `apiKeyCreate`."""
 input ApiKeyCreateInput {
-  """ID of the organisation to create the key in."""
+  """The ID of the organisation the key belongs to."""
   organizationId: ID!
-  """Display name for the API key."""
+  """The name of the key. Must not be blank."""
   name: String!
   """
-  Optional project ID to scope the key to. When null, the key is org-wide. A
-  project-scoped key is refused on any operation outside that project, including
-  organization-level ones.
+  The ID of the project to restrict the key to. Null for a key that covers the whole organisation.
+  A project key is refused on any operation outside that project, organisation-level ones included.
   """
   projectId: ID
   """
-  Required scopes for this API key. Must be a subset of the creator's scopes, and
-  of the project-level scopes when `projectId` is set.
+  The scopes the key holds. At least one, each held by the caller and assignable to an organisation
+  key, or to a project key when `projectId` is set.
   """
   scopes: [Scope!]!
 }
@@ -160,11 +152,11 @@ input ApiKeyCreateInput {
 ### `ApiKeyRevokeInput`
 
 ```graphql
-"""Input for `apiKeyRevoke` — invalidates the key immediately."""
+"""The input of `apiKeyRevoke`."""
 input ApiKeyRevokeInput {
-  """ID of the API key to revoke."""
+  """The ID of the API key to revoke."""
   keyId: ID!
-  """ID of the organisation the key belongs to."""
+  """Not read: the key's own organisation applies."""
   organizationId: ID!
 }
 ```