Get all custom profile fields
GET https://cs6170-23.zulipchat.com/api/v1/realm/profile_fields
Get all the custom profile fields
configured for the user's organization.
Usage examples
#!/usr/bin/env python3
import zulip
# Pass the path to your zuliprc file here.
client = zulip.Client(config_file="~/zuliprc")
# Fetch all the custom profile fields in the user's organization.
result = client.call_endpoint(
url="/realm/profile_fields",
method="GET",
)
print(result)
curl -sSX GET -G https://cs6170-23.zulipchat.com/api/v1/realm/profile_fields \
-u BOT_EMAIL_ADDRESS:BOT_API_KEY
Parameters
This endpoint does not accept any parameters.
Response
Return values
Example response(s)
Changes: As of Zulip 7.0 (feature level 167), if any
parameters sent in the request are not supported by this
endpoint, a successful JSON response will include an
ignored_parameters_unsupported
array.
A typical successful JSON response may look like:
{
"custom_fields": [
{
"editable_by_user": false,
"field_data": "",
"hint": "",
"id": 1,
"name": "Phone number",
"order": 1,
"required": true,
"type": 1
},
{
"editable_by_user": true,
"field_data": "",
"hint": "What are you known for?",
"id": 2,
"name": "Biography",
"order": 2,
"required": true,
"type": 2
},
{
"editable_by_user": true,
"field_data": "",
"hint": "Or drink, if you'd prefer",
"id": 3,
"name": "Favorite food",
"order": 3,
"required": false,
"type": 1
},
{
"display_in_profile_summary": true,
"editable_by_user": true,
"field_data": "{\"0\":{\"text\":\"Vim\",\"order\":\"1\"},\"1\":{\"text\":\"Emacs\",\"order\":\"2\"}}",
"hint": "",
"id": 4,
"name": "Favorite editor",
"order": 4,
"required": true,
"type": 3
},
{
"editable_by_user": false,
"field_data": "",
"hint": "",
"id": 5,
"name": "Birthday",
"order": 5,
"required": false,
"type": 4
},
{
"display_in_profile_summary": true,
"editable_by_user": true,
"field_data": "",
"hint": "Or your personal blog's URL",
"id": 6,
"name": "Favorite website",
"order": 6,
"required": false,
"type": 5
},
{
"editable_by_user": false,
"field_data": "",
"hint": "",
"id": 7,
"name": "Mentor",
"order": 7,
"required": true,
"type": 6
},
{
"editable_by_user": true,
"field_data": "{\"subtype\":\"github\"}",
"hint": "Enter your GitHub username",
"id": 8,
"name": "GitHub",
"order": 8,
"required": true,
"type": 7
},
{
"editable_by_user": true,
"hint": "What pronouns should people use to refer to you?",
"id": 9,
"name": "Pronouns",
"order": 9,
"required": false,
"type": 8
}
],
"msg": "",
"result": "success"
}