Microsoft 365 Teams.profile Photo API
The teams.profilePhoto API from Microsoft 365 — 2 operation(s) for teams.profilephoto.
The teams.profilePhoto API from Microsoft 365 — 2 operation(s) for teams.profilephoto.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/microsoft-365:microsoft-365-teams-profilephoto-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Teams.profile Photo API
version: v1.0
servers:
- url: https://graph.microsoft.com/v1.0/
description: Core
security:
- azureaadv2: []
tags:
- name: teams.profilePhoto
paths:
/teams/{team-id}/photo:
get:
tags:
- teams.profilePhoto
summary: Get profilePhoto
description: 'Get the specified profilePhoto or its metadata (profilePhoto properties). The supported sizes of HD photos on Microsoft 365 are as follows: 48x48, 64x64, 96x96, 120x120, 240x240,
360x360, 432x432, 504x504, and 648x648. Photos can be any dimension if they''re stored in Microsoft Entra ID. You can get the metadata of the largest available photo or specify a size to get the metadata for that photo size.
If the size you request is unavailable, you can still get a smaller size that the user has uploaded and made available.
For example, if the user uploads a photo that is 504x504 pixels, all but the 648x648 size of the photo is available for download.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/profilephoto-get?view=graph-rest-1.0
operationId: team_GetPhoto
parameters:
- name: team-id
in: path
description: The unique identifier of team
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: team
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.profilePhoto'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- teams.profilePhoto
summary: Update profilePhoto
description: Update the photo for the specified contact, group, team, or user in a tenant. The size of the photo you can update to is limited to 4 MB. You can use either PATCH or PUT for this operation.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/profilephoto-update?view=graph-rest-1.0
operationId: team_UpdatePhoto
parameters:
- name: team-id
in: path
description: The unique identifier of team
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: team
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.profilePhoto'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.profilePhoto'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
/teams/{team-id}/photo/$value:
get:
tags:
- teams.profilePhoto
summary: Get profilePhoto
description: 'Get the specified profilePhoto or its metadata (profilePhoto properties). The supported sizes of HD photos on Microsoft 365 are as follows: 48x48, 64x64, 96x96, 120x120, 240x240,
360x360, 432x432, 504x504, and 648x648. Photos can be any dimension if they''re stored in Microsoft Entra ID. You can get the metadata of the largest available photo or specify a size to get the metadata for that photo size.
If the size you request is unavailable, you can still get a smaller size that the user has uploaded and made available.
For example, if the user uploads a photo that is 504x504 pixels, all but the 648x648 size of the photo is available for download.'
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/profilephoto-get?view=graph-rest-1.0
operationId: team_GetPhotoContent
parameters:
- name: team-id
in: path
description: The unique identifier of team
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: team
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
default:
$ref: '#/components/responses/error'
put:
tags:
- teams.profilePhoto
summary: Update profilePhoto
description: Update the photo for the specified contact, group, team, or user in a tenant. The size of the photo you can update to is limited to 4 MB. You can use either PATCH or PUT for this operation.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/profilephoto-update?view=graph-rest-1.0
operationId: team_SetPhotoContent
parameters:
- name: team-id
in: path
description: The unique identifier of team
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: team
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
delete:
tags:
- teams.profilePhoto
summary: Delete media content for the navigation property photo in teams
description: The profile photo for the team.
operationId: team_DeletePhotoContent
parameters:
- name: team-id
in: path
description: The unique identifier of team
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: team
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
components:
schemas:
microsoft.graph.ODataErrors.InnerError:
type: object
additionalProperties:
type: object
description: The structure of this object is service-specific
microsoft.graph.profilePhoto:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: profilePhoto
type: object
properties:
height:
maximum: 2147483647
minimum: -2147483648
type:
- number
- 'null'
description: The height of the photo. Read-only.
format: int32
width:
maximum: 2147483647
minimum: -2147483648
type:
- number
- 'null'
description: The width of the photo. Read-only.
format: int32
additionalProperties:
type: object
microsoft.graph.ODataErrors.ErrorDetails:
required:
- code
- message
type: object
properties:
code:
type: string
message:
type: string
target:
type:
- string
- 'null'
additionalProperties:
type: object
microsoft.graph.ODataErrors.MainError:
required:
- code
- message
type: object
properties:
code:
type: string
message:
type: string
x-ms-primary-error-message: true
target:
type:
- string
- 'null'
details:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.ODataErrors.ErrorDetails'
innerError:
$ref: '#/components/schemas/microsoft.graph.ODataErrors.InnerError'
additionalProperties:
type: object
microsoft.graph.ODataErrors.ODataError:
required:
- error
type: object
properties:
error:
$ref: '#/components/schemas/microsoft.graph.ODataErrors.MainError'
additionalProperties:
type: object
microsoft.graph.entity:
title: entity
type: object
properties:
id:
type: string
description: The unique identifier for an entity. Read-only.
additionalProperties:
type: object
responses:
error:
description: error
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.ODataErrors.ODataError'
securitySchemes:
azureaadv2:
type: oauth2
flows:
authorizationCode:
authorizationUrl: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
tokenUrl: https://login.microsoftonline.com/common/oauth2/v2.0/token
scopes: {}