PUT

api

public

teams

{teamId}

profile

Update Team Profile

curl --request PUT \
  --url https://spaces.nexudus.com/api/public/teams/{teamId}/profile \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "Name": "<string>"
}
'

import requests

url = "https://spaces.nexudus.com/api/public/teams/{teamId}/profile"

payload = { "Name": "<string>" }
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({Name: '<string>'})
};

fetch('https://spaces.nexudus.com/api/public/teams/{teamId}/profile', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "401 Unauthorized": {},
  "403 Forbidden": {},
  "400 Bad Request": {},
  "404 Not Found": {}
}

Update Team Profile

Updates the profile information for a specific team, including display name, social media links, and public visibility. Only team administrators can call this endpoint; partial updates are supported.

Authentication

Requires a valid customer bearer token. The customer must be a team administrator of the specified team.

Path Parameters

number

required

Numeric identifier of the team. Returned as Id in the Records array from GET /api/public/teams/my.

Request Body

The request body should contain the team profile fields to update. Only include fields that are being modified — partial updates are supported.

Basic Information

string

required

Display name of the team. Cannot be empty.

string

Full-length team description. May contain HTML. Omit to leave unchanged.

string

Short tagline shown in team cards and selectors.

boolean

When true, the team profile is visible in the public member directory.

string

Team website URL. Must be a valid URL format when provided.

string

Space-separated tags describing the team.

All social media fields are optional string values. Must be valid URL format when provided (except Skype which accepts a username).

Field	Description
`Twitter`	X / Twitter profile URL
`Facebook`	Facebook page URL
`Linkedin`	LinkedIn company page URL
`Instagram`	Instagram profile URL
`Github`	GitHub org or user URL
`Pinterest`	Pinterest profile URL
`Skype`	Skype username
`Telegram`	Telegram handle
`Flickr`	Flickr profile URL
`Vimeo`	Vimeo channel URL
`Tumblr`	Tumblr blog URL
`Blogger`	Blogger profile URL

Response

Returns HTTP 200 OK with an empty body on success.

Examples

PUT /api/public/teams/55/profile
Authorization: Bearer {token}
Content-Type: application/json

{
  "Name": "Tech Innovators Updated",
  "ProfileSummary": "Building the future, one innovation at a time — now with AI focus",
  "ProfileIsPublic": true,
  "ProfileWebsite": "https://techinnovators-ai.example.com",
  "ProfileTags": "technology startup innovation collaboration AI machine-learning",
  "Twitter": "https://twitter.com/techinnovators_ai",
  "Linkedin": "https://linkedin.com/company/techinnovators-ai",
  "Github": "https://github.com/techinnovators-ai"
}

Status: 200 OK
Body: (empty)

TypeScript Integration

import { endpoints } from '@/api/endpoints'
import { Team } from '@/types/endpoints/TeamList'

const updateTeamProfile = async (teamId: number, profileData: Partial<Team>) => {
  await httpClient.put(endpoints.teams.one(teamId), profileData)
}

Usage in Portal

Context	Source file
Team Professional Profile Page (`/team/profile/{teamId}`)	`src/views/user/team/profile/TeamProfessionalProfilePage.tsx`
Team Professional Profile form component	`src/views/user/team/profile/components/TeamProfessionalProfile.tsx`

Error Responses

error

The customer is not authenticated or the session has expired.

error

The customer is not an administrator of the specified team.

error

Invalid request data — for example, missing required Name field or invalid URL format in a social media field.

error

Team with the specified ID does not exist.

Method	Endpoint	Description
`GET`	`/api/public/teams/{teamId}/profile`	Get current team profile
`GET`	`/api/public/teams/my`	List the customer’s teams
`GET`	`/api/public/teams/{teamId}/kpi`	Team KPI metrics
`GET`	`/api/public/teams/{teamId}/attendance`	Team attendance data
`GET`	`/api/public/teams/{teamId}/metrics`	Team performance metrics

Update Team Profile ImagesUploads, replaces, or deletes team profile images (logo and up to 3 additional images).

Update Team Profile

curl --request PUT \
  --url https://spaces.nexudus.com/api/public/teams/{teamId}/profile \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "Name": "<string>"
}
'

import requests

url = "https://spaces.nexudus.com/api/public/teams/{teamId}/profile"

payload = { "Name": "<string>" }
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({Name: '<string>'})
};

fetch('https://spaces.nexudus.com/api/public/teams/{teamId}/profile', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "401 Unauthorized": {},
  "403 Forbidden": {},
  "400 Bad Request": {},
  "404 Not Found": {}
}

​Update Team Profile

​Authentication

​Path Parameters

​Request Body

​Basic Information

​Social Media

​Response

​Examples

​Update team name and social links

​TypeScript Integration

​Usage in Portal

​Error Responses

​Related Endpoints

Update Team Profile

Authentication

Path Parameters

Request Body

Basic Information

Social Media

Response

Examples

Update team name and social links

TypeScript Integration

Usage in Portal

Error Responses

Related Endpoints