Skip to content

Authentication

How does authentication work with Tallyfy Answers API?

All API requests to Tallyfy Answers require authentication using an API key. This API key validates your identity and permissions when accessing Tallyfy Answers endpoints.

Tallyfy uses a centralized identity and access management system at account.tallyfy.com for all products.

This system handles sign up, sign in, SSO, and account management functions like password recovery across all Tallyfy products.

If your account is a member of multiple organizations, you can easily switch between them.

Click your name/profile picture in the top-right corner and select “Switch organization” to access other roles and organizations associated with your account.

What API key header is required?

Add the following header to all your Tallyfy Answers API requests:

X-Answers-API-Key: your_api_key

Replace your_api_key with the actual API key provided to your Tallyfy account.

How do you obtain a Tallyfy Answers API key?

To get a Tallyfy Answers API key:

  1. Log in to your Tallyfy Answers account
  2. Navigate to the API Settings section
  3. Click Generate API Key
  4. Copy the generated key for use in your applications

What are API key security best practices?

  • Do not share your Tallyfy API key in public repositories or client-side code
  • Store your API key in environment variables or secure configuration files
  • Regenerate your API key if you suspect it has been compromised
  • Use different API keys for development and production environments

What does an authenticated request look like?

Terminal window
curl -X GET https://go.tallyfy.com/api/answers/collections/my_collection \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json"

How do you troubleshoot authentication errors?

If you receive a 401 Unauthorized response, check that:

  • Your Tallyfy Answers API key is valid and active
  • You’ve correctly included the X-Answers-API-Key header
  • Your account has the necessary permissions for the requested operation

Objects > Get an object

The Tallyfy Answers API provides a GET endpoint that retrieves individual objects from collections using their unique identifier and returns complete object data with all properties including system-generated timestamps.

Answers > Search

Tallyfy Answers search enables users to find specific objects within collections using natural language queries or specific terms through a query-based operation system.

Objects > Delete an object

The DELETE endpoint permanently removes specific objects from Tallyfy Answers collections using unique identifiers with no recovery option and returns confirmation upon successful deletion.

Collections > Delete a collection

The DELETE endpoint permanently removes collections and all their objects from Tallyfy Answers with no recovery option and requires careful consideration of alternatives like data export or backup before execution.