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": "...",
.....