Welcome to the technical documentation for RandomCoffee’s API!

Our API is currently in beta, and we’re continuously working to improve it. If you have any questions, feature requests, or suggestions for improvement, we’d love to hear from you. Your feedback helps us make the API better for everyone!

Prerequisites

• A RandomCoffee workspace on the Enterprise Plan

Base URL

<https://api.random-coffee.com/api/v2>

Authentication

All endpoints require an API token for authentication. The token should be passed in the Authorization header using the Bearer schema.

Example:

Authorization: Bearer YOUR_API_TOKEN

1. Create a Category / Attribute

POST /data/attributes/

Create a new category or attribute for your company.

Request Body:

{
    "title": "Location",
    "description": "User's workplace location",
    "type": "select",
    "values": ["New York", "San Francisco", "Chicago"]
}

Request Body Parameters:

• title (string, required): The name of the category or attribute (e.g., "Location").
• description (string, required): A description of the category or attribute (e.g., "User's workplace location").
• type (string, optional): The type of the category. Can be "select" , "text" , "date", "integer" ,"array" or "boolean". Default is "select".
• values (array, optional): A list of predefined values for the category. Only applicable if the type is "select" or "array".