team.profile.get
method
Usage info
This method is used to get the profile field definitions for this team.
The team_id
is only relevant when using an org-level token. This field will be ignored if the API call is sent using a workspace-level token.
The optional visibility
argument allows the client to filter the profile fields based on visibility. The following values are supported:
all
is the default, and returns all fields.visible
returns only fields for which theis_hidden
option is missing or false.hidden
returns only fields for which theis_hidden
option is true.
Response
The response contains a profile
item with an array of key value pairs. Right now only the fields
key is supported, which contains a list of field definitions for this team.
There are two ways to update a field. The value of is_scim
determines which method to use:
- If
is_scim
isTrue
, update the field via a SCIM API call - If
is_scim
isFalse
, update the field viausers.profile.set
. You'll need itsid
to do so. Field | Type | Description --------------|--------------|------------id
| String | The ID of either the section or fieldis_protected
| Boolean |is_scim
| Boolean | If true, can be updated via SCIM APIsfield_name
| String | The name of the fieldhint
| String | Any additional context the user may need to understand the fieldlabel
| String | The text that will appear under the field or sectionpossible_values
| String | The values that allowed to be chosen by the useroptions
| String| An object containing theis_protected
andis_scim
fieldsordering
| Integer | The placement of the field or section on the profilesection_id
| String | Theid
of the section the field is insection_type
| String | The type of content in the section. Users can only createcustom
section typestype
| String | The format the field supports. Can bedate
,link
,long_text
,options_list
,tags
,text
, oruser