Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.heychocolate.com/llms.txt

Use this file to discover all available pages before exploring further.

​
createApiKey

Create a new API key for your organization. 
mutation {
  createApiKey(input: {
    label: "Production Backend"
    permissions: ["read", "write", "calculate"]
  }) {
    apiKey
    id
    prefix
    label
    permissions
    createdAt
  }
}
The full API key is only returned once at creation time. Store it securely.
Input:
FieldTypeRequiredDescription
labelString!YesDescriptive label for the key
permissions[String!]NoPermission scopes (default: all)

​
revokeApiKey

Revoke an existing API key. 
mutation {
  revokeApiKey(id: "key_abc123") {
    success
    revokedAt
  }
}

​
updateCustomer

Update customer profile data. 
mutation {
  updateCustomer(input: {
    name: "Acme Sustainability BV"
    webhookUrl: "https://acme.com/webhooks/heychocolate"
  }) {
    id
    name
    webhookUrl
    updatedAt
  }
}
Input:
FieldTypeRequiredDescription
nameStringNoDisplay name
webhookUrlStringNoDefault webhook URL