Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The Trustwell Genesis Foods API provides a powerful way to access food data, perform analyses, query standard entities, and create new ingredients or recipes. Built on GraphQL, the API allows you to define precisely what data you need and retrieve it efficiently. This guide will walk you through how to authenticate and start making queries and mutations using the API.

Obtaining your API Key

Note
  • Only Administrators with API Access will have the ability to generate an API Key.

  • Treat your API Key like a password. Keep it secret; keep it safe.

  • For questions, please contact Trustwell Support

To start using the Genesis Foods API, follow these steps:

  1. Log into the Genesis Foods application.

  2. In the lower left, click the vertical ellipsis next to your Organization Name / Username.

  3. Select Profile.

    image-20241010-225201.pngImage Added
  4. Select API Tokens along the top.

    image-20241010-225301.pngImage Added
  5. Click Create API Token.

  6. Enter a Label.

  7. Click Create Token.

  8. Once created, we recommend using the Copy button to copy the string to the clipboard.

    Generate an API Key.

    Only Administrators with API Access will have the ability to generate an API Key

    image-20241010-230028.pngImage Added

    • Important: This is the only time you will be able to obtain this Token. Should this be lost, the Token should be deleted and a new one created.

    • Preserve this Token string as you would other secrets / passwords.

  9. Include this API Key in the request headers for every request you make.

...

  • The API enforces rate and usage limits.

  • Requests are only processed over HTTPS. HTTP requests will be redirected to the corresponding HTTPS resource.

  • The Genesis Foods API uses GraphQL and has a single endpoint. For more information on how GraphQL works, please visit http https://graphql.org/.

Authentication/Authorization

You can generate an API Key through the Genesis Foods application, provided your user has the necessary permissions. If you do not have access to generate API Keys, please contact your Account Manager Trustwell Support for assistance.

Include your API Key in the request headers

...


API Reference Documentation

The Genesis Foods GraphQL API reference documentation.

https://docs.trustwell.com/genesis/api/

API Playground

The Genesis Foods GraphQL API Playground with example code.

Genesis Foods GraphQL API Playground

https://github.com/esha/genesis-foods-api-playground

API Operations: Queries and Mutations Examples

...

Below are examples of common API operations, showing how to construct requests and handle responses for both queries and mutations.

Info

Genesis GraphQL API URLEndpoint

Production: https://api.trustwell.com/genesis

Preview: TBD: https://api-preview.trustwell.com/genesis

In the examples below, many responses have been truncated for readability.

...