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>

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".

Response:

• HTTP Status Code: 201 OK on success.
• Returns the created category/attribute details.