Skip to content

Pulse! Data Structures

1. Question Schema

Each question is a record in the questions API endpoint with this structure:

Field Type Description
id integer Primary key (range: 1000–1423)
question string The full question text
details string | null Additional context or instruction (rarely used)
category integer Foreign key to question category
category_name string Denormalised category display name
role integer Foreign key to question role (target respondent)
role_name string Denormalised role display name
qtype integer Foreign key to question type
qtype_name string Denormalised type display name
is_active boolean Whether the question is live in diagnostics
created_at datetime ISO 8601 creation timestamp (+02:00)
updated_at datetime ISO 8601 last-modified timestamp (+02:00)
updated_by integer User ID who last modified

Example

{
  "id": 1000,
  "question": "What behaviours (spoken / non-spoken) defines the culture of [xCo]?",
  "details": null,
  "category": 109,
  "category_name": "OMV-Core Values",
  "role": 100,
  "role_name": "All Employees",
  "qtype": 101,
  "qtype_name": "Text Box",
  "is_active": true,
  "created_at": "2025-12-09T08:12:40.225293+02:00",
  "updated_at": "2025-12-09T08:12:40.225320+02:00",
  "updated_by": 1
}

1. API Surface

All endpoints are RESTful, DRF Token-authenticated. Base URL: https://pulse.nostics.biz/api/

1.1 Core Data Endpoints

Endpoint Returns Key Filters
/api/questions/ Question bank (424 active) ?category=X&role=X&qtype=X&is_active=true&search=text
/api/question-categories/ Category definitions (302 → admin UI) Redirects; use via project-categories
/api/question-roles/ Role lookup table (8 roles) —
/api/question-types/ Type lookup table (3 types) —
/api/qcategory-sources/ Category source definitions —

2.2 Project & Assignment Endpoints

Endpoint Returns
/api/projects/ Diagnostic projects
/api/project-categories/ Categories assigned to a project, with category_source_name
/api/assignments/ Respondent assignments to projects

2.3 Response Endpoints

Endpoint Returns
/api/answers/ Individual question answers (?project=X&person=X&question=X)
/api/answers/workspace/{project_id}/{person_id}/ Person's workspace with progress, categories, questions, and answers
/api/reports/answers/ Aggregated answer reports

2.4 Entity Endpoints

Endpoint Returns
/api/companies/ Client/partner companies
/api/persons/ Individual respondents
/api/departments/ Company departments

2.5 Strategic & Knowledge Endpoints

Endpoint Returns
/api/company-strategic-fields/ Strategic field definitions
/api/company-strategic-metrics/ Strategic metric tracking
/api/knowledge-assets/ 7P Method work-breakdown structures and tools
/api/tool-tags/ Tag taxonomy for knowledge assets
Endpoint Returns
/api/workflows/ Diagnostic workflow definitions
/api/workflow-steps/ Step-by-step workflow breakdown
/api/workflow-instances/ Running workflow instances
/api/workflow-events/ Workflow event log
/api/feedback-surveys/ Post-diagnostic feedback

Pagination

All list endpoints support ?page=N&page_size=M. Default page size is 20; max is 10000. Use page_size=10000 for single-call full dataset retrieval.

7. Cross-References

Citations

[1] Pulse! REST API — https://pulse.nostics.biz/api/ — live production instance, DRF Token authentication via hermes-ai-agent service account. Data snapshot: 2026-06-29.