Developers
Set your API contextPick a region and space ID once. Every sample fills in your base URL.
Where do I find these?

In Coevera: open your space's API application and choose Show Access. It shows the space ID and the base URL, whose host starts with your region.

From the API: if you know the space ID, the discovery endpoint GET /api/discovery/spaces/{space_id} returns its region and base URLs, without credentials.

Only the region and space ID are kept, in this browser. Never paste a key or password here.

More in the quickstart

GraphQLRepositoriesproductType

entities.productType

Read product type records with the productType repository, and change them with the product type mutations. Same records as the REST ProductTypes entity.

Queries

Fields of entities { productType { … } }.

KindFieldReturns
QUERYgetById(entityId: ID!)
Returns the record with the given id, or null when there is none. Deleted records are returned as well.
ProductTypeEntity
QUERYgetByIds(entityIds: [ID!]!)
Returns the records with the given ids; ids without a record are left out. Deleted records are returned as well.
[ProductTypeEntity!]!
QUERYgetAll(limit: Int, offset: Int, filter: ProductTypeFilterInput, orderBy: [ProductTypeOrderByInput!], includeDeleted: Boolean)
Returns the records that match the filter, paged with limit and offset.
[ProductTypeEntity!]!
QUERYgetByCriteria(filter: ProductTypeFilterInput, orderBy: [ProductTypeOrderByInput!], includeDeleted: Boolean, before: String, after: String, first: Int, last: Int)
Returns the records that match the filter as a cursor-paginated connection.
ProductTypeEntityConnection
QUERYgetPublished(limit: Int, offset: Int, filter: ProductTypeFilterInput, orderBy: [ProductTypeOrderByInput!], includeDeleted: Boolean)
Returns the published records that match the filter, paged with limit and offset.
[ProductTypeEntity!]!
QUERYgetDrafts(filter: ProductTypeFilterInput, orderBy: [ProductTypeOrderByInput!])
Returns the records that match the filter, with pending unpublished changes applied where a draft exists.
[ProductTypeEntity!]!
QUERYgetDraftById(entityId: ID!)
Returns the record with the given id, with its pending unpublished changes applied when a draft exists.
ProductTypeEntity!

Types

The types this repository uses, each with its fields and their descriptions. Types several repositories share, such as PageInfo and the filter fields, are in the types index.

ProductTypeEntity object 16 fields: hasDraft, isDeleteProtected, formEditApi, …

Product type that classifies products and defines their form.

FieldTypeDescription
hasDraftBooleanTrue when the record has unpublished draft changes, including pending translation changes, that can be published.
isDeleteProtectedBoolean!True when the record is protected against deletion because it must always exist in the space. Deleting a record that is not protected can still fail on other checks. Read-only.
formEditApiFormTyped, read-only view of a form layout of this type: formEditApi mirrors the edit form (formEdit), formLostApi the form shown when archiving as lost (formLost).
canChangeReadonlyBooleanFalse for types whose read-only setting is fixed, such as the recurrent appointment type; true otherwise.
idID!Unique identifier of entity.
isDeletedBooleanSpecifies if the entity is considered deleted.
modifiedDateTimeLast modification time.
createdDateTimeCreation time.
opptyProductRelationTypeOpptyProductRelationTypeEntityOpportunity / quote line-item type paired with this product type. Drives the form used when adding products of this type as line items.
formEditJSONString!JSON definition of the form layout used by the UI when creating or editing products of this type. This payload conforms to the Form JSON Schema: GET /api/v100/rest/schemas/Form.json on your region's API host
isReadonlyBoolean!True when the product type is system-managed and cannot be edited or deleted by users.
nameString!Name of the entity and its default text representation.
opptyProductRelationTypeIdID!Id of the paired opportunity/quote line-item type.
isPublishedBooleanTrue when the entity configuration is published; false while it exists only as an unpublished draft.
revisionIntRevision when entity was lastly changed.
instancePermissions[EntityPermsEnum!]! (1 args)Permissions the current user has on this record, out of the requested ones.
ProductTypeEntityConnection object pageInfo: PageInfo!, edges: [ProductTypeEntityEdge]!, totalCount: Int

Paginated list of ProductType records.

FieldTypeDescription
pageInfoPageInfo!Pagination data for this connection.
edges[ProductTypeEntityEdge]!Contains the nodes in this connection.
totalCountIntTotal number of items in the connection.
ProductTypeEntityEdge object node: ProductTypeEntity, cursor: String!

A Relay edge containing a ProductTypeEntity and its cursor.

FieldTypeDescription
nodeProductTypeEntityThe item at the end of the edge
cursorString!A cursor for use in pagination
ProductTypeFilterInput input AND, OR, NOT, globalSearchQuery, one condition per field

Filter conditions for ProductType records. Conditions on different fields are combined with AND; use OR, AND and NOT for other combinations.

Input fieldTypeDescription
OR[ProductTypeFilterInput!]Matches records that meet at least one of the listed filters.
AND[ProductTypeFilterInput!]Matches records that meet all of the listed filters.
NOTProductTypeFilterInputMatches records that do not meet this filter.
globalSearchQueryStringSearch term matched against the fields that the global search covers for this entity.
idEntityFilterStringFieldUnique identifier of entity.
isDeletedBooleanSpecifies if the entity is considered deleted.
modifiedEntityFilterDateTimeFieldLast modification time.
createdEntityFilterDateTimeFieldCreation time.
isReadonlyBooleanTrue when the product type is system-managed and cannot be edited or deleted by users.
nameEntityFilterStringFieldName of the entity and its default text representation.
opptyProductRelationTypeIdEntityFilterStringFieldId of the paired opportunity/quote line-item type.
isPublishedBooleanTrue when the entity configuration is published; false while it exists only as an unpublished draft.
revisionEntityFilterNumberFieldRevision when entity was lastly changed.
opptyProductRelationTypeOpptyProductRelationTypeFilterInputOpportunity / quote line-item type paired with this product type. Drives the form used when adding products of this type as line items. Matches records where a related record meets these conditions.
ProductTypeOrderByInput input Asc or Desc per field

Sorting of ProductType records. Set exactly one field in each item; list several items to sort by more fields, in order of priority.

Input fieldTypeDescription
idOrderByEnumUnique identifier of entity.
isDeletedOrderByEnumSpecifies if the entity is considered deleted.
modifiedOrderByEnumLast modification time.
createdOrderByEnumCreation time.
opptyProductRelationType[OpptyProductRelationTypeOrderByNestedInput!]Opportunity / quote line-item type paired with this product type. Drives the form used when adding products of this type as line items. Sorts by fields of the related record, listed in order of priority.
isReadonlyOrderByEnumTrue when the product type is system-managed and cannot be edited or deleted by users.
nameOrderByEnumName of the entity and its default text representation.
opptyProductRelationTypeIdOrderByEnumId of the paired opportunity/quote line-item type.
isPublishedOrderByEnumTrue when the entity configuration is published; false while it exists only as an unpublished draft.
revisionOrderByEnumRevision when entity was lastly changed.