Skip to content

Organisation Teams ​

Please note that teams are a direct child entity of an organisation. For majority for the teams API functions, you will need to retrieve the organisation ID before hand.

Get all ​

Endpoint ​

sh
GET https://art.ayima.com/api/teams

parameters ​

N/A

Response ​

json
{
    "data": [
        {
            "id": "...",
            "name": "...",
            "website": "...",
            "keywords": "...",
            "visible_to_client": "...",
            "team_members": "...",
            "reports": "...",
            "websites": "...",
            "is_favourite": "...",
            "created_at": "..."
        }
    ]
}

Get organisation teams ​

Endpoint ​

sh
GET https://art.ayima.com/api/organisations/{organisationId}/teams

Parameters ​

N/A

Response ​

json
{
    "data": [
        {
            "id": "...",
            "name": "...",
            "website": "...",
            "keywords": "...",
            "visible_to_client": "...",
            "team_members": "...",
            "reports": "...",
            "websites": "...",
            "is_favourite": "...",
            "created_at": "..."
        }
    ]
}

Get singular organisation team ​

Endpoint ​

sh
GET https://art.ayima.com/api/organisations/{organisationId}/teams/{teamId}

Parameters ​

N/A

Response ​

json
{
    "data": {
        "id": "...",
        "name": "...",
        "website": "...",
        "keywords": "...",
        "visible_to_client": "...",
        "team_members": "...",
        "reports": "...",
        "websites": "...",
        "is_favourite": "...",
        "created_at": "..."
    }
}

Create ​

Endpoint ​

sh
POST https://art.ayima.com/api/organisations/{organisationId}/teams

parameters ​

nametypedescriptionrequired
nameStringThe name for the team you would like to create.✅
websiteStringThe website address that is based associated with the team. Please note this is not used for report creation- simply used to get metadata such as logo for the organisation.✅
visible_to_clientBooleanIndication if the team should be visible to clients.✅

Response ​

json
{
    "created": true
}

Update ​

sh
PUT https://art.ayima.com/api/organisations/{organisationId}/teams/{teamId}

parameters ​

nametypedescriptionrequired
nameStringThe name for the team you would like to create.✅
websiteStringThe website address that is based associated with the team. Please note this is not used for report creation- simply used to get metadata such as logo for the organisation.✅
visible_to_clientBooleanIndication if the team should be visible to clients.✅

Response ​

json
{
    "updated": true
}

Get Reports ​

sh
GET https://art.ayima.com/api/organisations/{organisationId}/teams/{teamId}/reports

Parameters ​

N/A

Response ​

json
{
  "data": [
        {
            "id": "...",
            "secret": "...",
            "name": "...",
            "is_building": "...",
            "build_reason": "...",
            "build_percent": "...",
            "back_fill_from": "...",
            "original_name": "...",
            "gs_data_studio_enabled": "...",
            "gs_data_studio_secret": "...",
            "group_stats_as": "...",
            "visible_to_client": "...",
.....