A user object contains information about a user. It contains relationships to different boards and organizations.
Finding
user_id
Some of our endpoints include a
user_id
in our path parameter. Thisuser_id
represents the user we want to fetch and modify.You can find
user_id
of 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. |