A user object contains information about a user. It contains relationships to different boards and organizations.
Findinguser_idSome of our endpoints include a
user_idin our path parameter. Thisuser_idrepresents the user we want to fetch and modify.You can find
user_idof users in your organization by using the get user's boards in organization endpoint.
If you want the data of boards and organizations to be included with the user object then make sure ?include=boards,organizations is added to the end of the GET request URL. eg: GET https://api.padlet.dev/v1/me?include=boards,organizations
An example of a user object is displayed below.
{
"id": "user_abcd1234efgh5678",
"type": "user",
"attributes": {
"email": "[email protected]",
"name": "Tony Stark",
"username": "ironman",
"displayName": "Tony",
"avatar": "https://padlet.net/avatars/ironman.png",
"bio": "Genius, billionaire, playboy, philanthropist. I am Iron Man."
},
"relationships": {
"boards": {
"data": [
{
"type": "board",
"id": "abcd1234efgh5678"
}
]
},
"organizations": {
"data": [
{
"type": "organization",
"id": "abcd1234efgh5678"
}
]
}
}
}User object properties
| Properties | Type | Description |
|---|---|---|
id | string | User ID |
type | string | Always "user". |
attributes.email | string | Email address of the user |
attributes.name | string | Full name of the user |
attributes.username | string | Username of the user |
attributes.displayName | string | Display name of the user |
attributes.avatar | string | URL to the user's avatar image |
attributes.bio | string | User's biography or description |
relationships.boards | object | List of board objects created by the user. Only contains type and id as per JSON:API specification. |
relationships.organizations | object | List of organization objects that user belongs to. Only contains type and id as per JSON:API specification. |
