LogoLogo
Book a DemoWebsite
  • Overview
  • Basics
    • Design Your Data
    • Templates
    • Fields
    • Research Questions
    • Profiles
  • Client
    • Templates
    • Fields
    • Research Questions
    • Profiles
  • API Reference
    • Templates
    • Fields
    • Research Questions
    • Profiles
  • Quick Starts
    • Company
Powered by GitBook
On this page
  1. API Reference

Profiles

Basic Profile Operations

PreviousResearch QuestionsNextQuick Starts

Last updated 3 months ago


Profile CRUD Operations

Profile Snapshot Operations

Add Created Field to Profile

get
Authorizations
Query parameters
specificationstringOptional
Responses
200Success
application/json
get
GET /prod/v0/profiles/ HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200Success
[
  {
    "id": 1,
    "tags": [
      {
        "id": 1,
        "name": "text",
        "description": "text"
      }
    ],
    "specification": "text",
    "template": {
      "id": 1,
      "name": "text",
      "description": "text",
      "fields": [
        {
          "id": 1,
          "name": "text",
          "description": "text",
          "type": "text",
          "rel_template": 1,
          "enum_values": [
            "text"
          ],
          "enum_many": true,
          "sources": [
            "text"
          ]
        }
      ],
      "questions": [
        "text"
      ]
    },
    "snapshots": [
      {
        "id": 1,
        "status": "text",
        "answers": [
          {
            "id": 1,
            "answer": null
          }
        ],
        "fields": [
          {
            "id": 1,
            "field": {
              "id": 1,
              "name": "text",
              "description": "text",
              "type": "text",
              "rel_template": 1,
              "enum_values": [
                "text"
              ],
              "enum_many": true,
              "sources": [
                "text"
              ]
            },
            "status": "text",
            "value": null
          }
        ],
        "reports": [
          {
            "id": 1,
            "outline": {
              "id": 1,
              "outline": null,
              "perspective": "text"
            },
            "report": null
          }
        ]
      }
    ]
  }
]
get
Authorizations
Path parameters
idintegerRequired

A unique integer value identifying this profile.

Responses
200Success
application/json
get
GET /prod/v0/profiles/{id}/ HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200Success
{
  "id": 1,
  "tags": [
    {
      "id": 1,
      "name": "text",
      "description": "text"
    }
  ],
  "specification": "text",
  "template": {
    "id": 1,
    "name": "text",
    "description": "text",
    "fields": [
      {
        "id": 1,
        "name": "text",
        "description": "text",
        "type": "text",
        "rel_template": 1,
        "enum_values": [
          "text"
        ],
        "enum_many": true,
        "sources": [
          "text"
        ]
      }
    ],
    "questions": [
      "text"
    ]
  },
  "snapshots": [
    {
      "id": 1,
      "status": "text",
      "answers": [
        {
          "id": 1,
          "answer": null
        }
      ],
      "fields": [
        {
          "id": 1,
          "field": {
            "id": 1,
            "name": "text",
            "description": "text",
            "type": "text",
            "rel_template": 1,
            "enum_values": [
              "text"
            ],
            "enum_many": true,
            "sources": [
              "text"
            ]
          },
          "status": "text",
          "value": null
        }
      ],
      "reports": [
        {
          "id": 1,
          "outline": {
            "id": 1,
            "outline": null,
            "perspective": "text"
          },
          "report": null
        }
      ]
    }
  ]
}
delete
Authorizations
Path parameters
idintegerRequired

A unique integer value identifying this profile.

Responses
204
No response body
delete
DELETE /prod/v0/profiles/{id}/ HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
204

No response body

No content

get
Authorizations
Responses
200Success
application/json
get
GET /prod/v0/snapshots/ HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200Success
[
  {
    "id": 1,
    "status": "text",
    "answers": [
      {
        "id": 1,
        "answer": null
      }
    ],
    "fields": [
      {
        "id": 1,
        "field": {
          "id": 1,
          "name": "text",
          "description": "text",
          "type": "text",
          "rel_template": 1,
          "enum_values": [
            "text"
          ],
          "enum_many": true,
          "sources": [
            "text"
          ]
        },
        "status": "text",
        "value": null
      }
    ],
    "reports": [
      {
        "id": 1,
        "outline": {
          "id": 1,
          "outline": null,
          "perspective": "text"
        },
        "report": null
      }
    ]
  }
]
get
Authorizations
Path parameters
idintegerRequired

A unique integer value identifying this snapshot.

Responses
200Success
application/json
get
GET /prod/v0/snapshots/{id}/ HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200Success
{
  "id": 1,
  "status": "text",
  "answers": [
    {
      "id": 1,
      "answer": null
    }
  ],
  "fields": [
    {
      "id": 1,
      "field": {
        "id": 1,
        "name": "text",
        "description": "text",
        "type": "text",
        "rel_template": 1,
        "enum_values": [
          "text"
        ],
        "enum_many": true,
        "sources": [
          "text"
        ]
      },
      "status": "text",
      "value": null
    }
  ],
  "reports": [
    {
      "id": 1,
      "outline": {
        "id": 1,
        "outline": null,
        "perspective": "text"
      },
      "report": null
    }
  ]
}
get
Authorizations
Path parameters
profile_idstringRequiredPattern: ^\d+$
Responses
200Success
application/json
get
GET /prod/v0/profiles/{profile_id}/snapshots/ HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200Success
[
  {
    "id": 1,
    "answers": [
      {
        "id": 1,
        "answer": null
      }
    ],
    "fields": [
      {
        "id": 1,
        "field": {
          "id": 1,
          "name": "text",
          "description": "text",
          "type": "text",
          "rel_template": 1,
          "enum_values": [
            "text"
          ],
          "enum_many": true,
          "sources": [
            "text"
          ]
        },
        "status": "text",
        "value": null
      }
    ],
    "reports": [
      {
        "id": 1,
        "outline": {
          "id": 1,
          "outline": null,
          "perspective": "text"
        },
        "report": null
      }
    ]
  }
]
get
Authorizations
Path parameters
profile_idstringRequiredPattern: ^\d+$
snapshot_idstringRequired
Responses
200Success
application/json
get
GET /prod/v0/profiles/{profile_id}/snapshots/{snapshot_id}/ HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200Success
{
  "id": 1,
  "answers": [
    {
      "id": 1,
      "answer": null
    }
  ],
  "fields": [
    {
      "id": 1,
      "field": {
        "id": 1,
        "name": "text",
        "description": "text",
        "type": "text",
        "rel_template": 1,
        "enum_values": [
          "text"
        ],
        "enum_many": true,
        "sources": [
          "text"
        ]
      },
      "status": "text",
      "value": null
    }
  ],
  "reports": [
    {
      "id": 1,
      "outline": {
        "id": 1,
        "outline": null,
        "perspective": "text"
      },
      "report": null
    }
  ]
}
get

Get the latest snapshot health for a profile

Authorizations
Path parameters
profile_idintegerRequired
Responses
200
No response body
get
GET /prod/v0/health/profile/{profile_id}/latest/ HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

No response body

No content

  • Profile CRUD Operations
  • GET/prod/v0/profiles/
  • POST/prod/v0/profiles/
  • GET/prod/v0/profiles/{id}/
  • PUT/prod/v0/profiles/{id}/
  • PATCH/prod/v0/profiles/{id}/
  • DELETE/prod/v0/profiles/{id}/
  • Profile Snapshot Operations
  • GET/prod/v0/snapshots/
  • GET/prod/v0/snapshots/{id}/
  • GET/prod/v0/profiles/{profile_id}/snapshots/
  • POST/prod/v0/profiles/{profile_id}/snapshots/
  • GET/prod/v0/profiles/{profile_id}/snapshots/{snapshot_id}/
  • GET/prod/v0/health/profile/{profile_id}/latest/
  • Add Created Field to Profile
  • POST/prod/v0/created-fields/{field_id}/profile/
post
Authorizations
Body
idintegerRead-onlyRequired
template_idintegerWrite-onlyRequired
specificationstring ยท max: 510Required
templateall ofRead-onlyRequired
Responses
201Success
application/json
post
POST /prod/v0/profiles/ HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 86

{
  "template_id": 1,
  "tags": [
    {
      "name": "text",
      "description": "text"
    }
  ],
  "specification": "text"
}
201Success
{
  "id": 1,
  "tags": [
    {
      "id": 1,
      "name": "text",
      "description": "text"
    }
  ],
  "specification": "text",
  "template": {
    "id": 1,
    "name": "text",
    "description": "text",
    "fields": [
      {
        "id": 1,
        "name": "text",
        "description": "text",
        "type": "text",
        "rel_template": 1,
        "enum_values": [
          "text"
        ],
        "enum_many": true,
        "sources": [
          "text"
        ]
      }
    ],
    "questions": [
      "text"
    ]
  },
  "snapshots": [
    {
      "id": 1,
      "status": "text",
      "answers": [
        {
          "id": 1,
          "answer": null
        }
      ],
      "fields": [
        {
          "id": 1,
          "field": {
            "id": 1,
            "name": "text",
            "description": "text",
            "type": "text",
            "rel_template": 1,
            "enum_values": [
              "text"
            ],
            "enum_many": true,
            "sources": [
              "text"
            ]
          },
          "status": "text",
          "value": null
        }
      ],
      "reports": [
        {
          "id": 1,
          "outline": {
            "id": 1,
            "outline": null,
            "perspective": "text"
          },
          "report": null
        }
      ]
    }
  ]
}
put
Authorizations
Path parameters
idintegerRequired

A unique integer value identifying this profile.

Body
idintegerRead-onlyRequired
template_idintegerWrite-onlyRequired
specificationstring ยท max: 510Required
templateall ofRead-onlyRequired
Responses
200Success
application/json
put
PUT /prod/v0/profiles/{id}/ HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 86

{
  "template_id": 1,
  "tags": [
    {
      "name": "text",
      "description": "text"
    }
  ],
  "specification": "text"
}
200Success
{
  "id": 1,
  "tags": [
    {
      "id": 1,
      "name": "text",
      "description": "text"
    }
  ],
  "specification": "text",
  "template": {
    "id": 1,
    "name": "text",
    "description": "text",
    "fields": [
      {
        "id": 1,
        "name": "text",
        "description": "text",
        "type": "text",
        "rel_template": 1,
        "enum_values": [
          "text"
        ],
        "enum_many": true,
        "sources": [
          "text"
        ]
      }
    ],
    "questions": [
      "text"
    ]
  },
  "snapshots": [
    {
      "id": 1,
      "status": "text",
      "answers": [
        {
          "id": 1,
          "answer": null
        }
      ],
      "fields": [
        {
          "id": 1,
          "field": {
            "id": 1,
            "name": "text",
            "description": "text",
            "type": "text",
            "rel_template": 1,
            "enum_values": [
              "text"
            ],
            "enum_many": true,
            "sources": [
              "text"
            ]
          },
          "status": "text",
          "value": null
        }
      ],
      "reports": [
        {
          "id": 1,
          "outline": {
            "id": 1,
            "outline": null,
            "perspective": "text"
          },
          "report": null
        }
      ]
    }
  ]
}
patch
Authorizations
Path parameters
idintegerRequired

A unique integer value identifying this profile.

Body
idintegerRead-onlyOptional
template_idintegerWrite-onlyOptional
specificationstring ยท max: 510Optional
templateall ofRead-onlyOptional
Responses
200Success
application/json
patch
PATCH /prod/v0/profiles/{id}/ HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 86

{
  "template_id": 1,
  "tags": [
    {
      "name": "text",
      "description": "text"
    }
  ],
  "specification": "text"
}
200Success
{
  "id": 1,
  "tags": [
    {
      "id": 1,
      "name": "text",
      "description": "text"
    }
  ],
  "specification": "text",
  "template": {
    "id": 1,
    "name": "text",
    "description": "text",
    "fields": [
      {
        "id": 1,
        "name": "text",
        "description": "text",
        "type": "text",
        "rel_template": 1,
        "enum_values": [
          "text"
        ],
        "enum_many": true,
        "sources": [
          "text"
        ]
      }
    ],
    "questions": [
      "text"
    ]
  },
  "snapshots": [
    {
      "id": 1,
      "status": "text",
      "answers": [
        {
          "id": 1,
          "answer": null
        }
      ],
      "fields": [
        {
          "id": 1,
          "field": {
            "id": 1,
            "name": "text",
            "description": "text",
            "type": "text",
            "rel_template": 1,
            "enum_values": [
              "text"
            ],
            "enum_many": true,
            "sources": [
              "text"
            ]
          },
          "status": "text",
          "value": null
        }
      ],
      "reports": [
        {
          "id": 1,
          "outline": {
            "id": 1,
            "outline": null,
            "perspective": "text"
          },
          "report": null
        }
      ]
    }
  ]
}
post
Authorizations
Path parameters
profile_idstringRequiredPattern: ^\d+$
Body
idintegerRead-onlyRequired
Responses
201Success
application/json
post
POST /prod/v0/profiles/{profile_id}/snapshots/ HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 2

{}
201Success
{
  "id": 1,
  "answers": [
    {
      "id": 1,
      "answer": null
    }
  ],
  "fields": [
    {
      "id": 1,
      "field": {
        "id": 1,
        "name": "text",
        "description": "text",
        "type": "text",
        "rel_template": 1,
        "enum_values": [
          "text"
        ],
        "enum_many": true,
        "sources": [
          "text"
        ]
      },
      "status": "text",
      "value": null
    }
  ],
  "reports": [
    {
      "id": 1,
      "outline": {
        "id": 1,
        "outline": null,
        "perspective": "text"
      },
      "report": null
    }
  ]
}
post

Attach a created field to a profile

Authorizations
Path parameters
field_idstringRequiredPattern: ^\d+$
Body
profile_idintegerWrite-onlyRequired
Responses
201
No response body
post
POST /prod/v0/created-fields/{field_id}/profile/ HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "profile_id": 1
}
201

No response body

No content