Families

All Families

You can get a list of all the families of a campaign by using the following endpoint.

{warning} Don't forget that all endpoints documented here need to be prefixed with api/1.0/campaigns/{campaign.id}/.

Method URI Headers
GET/HEAD families Default

URL Parameters

The list of returned families can be filtered. The available filters are available here: API filters.

Results

{
    "data": [
        {
            "id": 1,
            "name": "Adams",
            "entry": "\n<p>Lorem Ipsum.</p>\n",
            "image": "{path}",
            "image_full": "{url}",
            "image_thumb": "{url}",
            "has_custom_image": false,
            "is_private": true,
            "entity_id": 5,
            "tags": [],
            "created_at":  "2019-01-30T00:01:44.000000Z",
            "created_by": 1,
            "updated_at":  "2019-08-29T13:48:54.000000Z",
            "updated_by": 1,
            "location_id": 4,
            "type": "",
            "family_id": 2,
            "members": [
              "3"
            ]
        }
    ]
}

Family

To get the details of a single family, use the following endpoint.

Method URI Headers
GET/HEAD families/{family.id} Default

Results

{
    "data": {
        "id": 1,
        "name": "Adams",
        "entry": "\n<p>Lorem Ipsum.</p>\n",
        "image": "{path}",
        "image_full": "{url}",
        "image_thumb": "{url}",
        "has_custom_image": false,
        "is_private": true,
        "entity_id": 5,
        "tags": [],
        "created_at":  "2019-01-30T00:01:44.000000Z",
        "created_by": 1,
        "updated_at":  "2019-08-29T13:48:54.000000Z",
        "updated_by": 1,
        "location_id": 1,
        "type": "",
        "family_id": 2,
        "members": [
          "3"
        ]
    }

}

{info} Additional note: members represents an array of characters.id.

Create a Family

To create a family, use the following endpoint.

Method URI Headers
POST families Default

Body

Parameter Type Detail
name string (Required) Name of the family
entry string The html description of the family
type string The type of family
location_id integer The family's location id
family_id integer The parent family id
tags array Array of tag ids
image_url string URL to a picture to be used for the family
entity_image_uuid string Gallery image UUID for the entity image (limited to superboosted campaigns)
entity_header_uuid string Gallery image UUID for the entity header (limited to superboosted campaigns)
is_private boolean If the family is only visible to admin members of the campaign

Results

{success} Code 200 with JSON body of the new family.

Update a Family

To update a family, use the following endpoint.

Method URI Headers
PUT/PATCH families/{family.id} Default

Body

The same body parameters are available as for when creating a family.

Results

{success} Code 200 with JSON body of the updated family.

Delete a Family

To delete a family, use the following endpoint.

Method URI Headers
DELETE families/{family.id} Default

Results

{success} Code 200 with JSON.