---
updatedAt: 2026-06-24T13:59:08.000Z
agentTools:
projectIndex: https://developers.dailymotion.com/llms.txt
---
# Get me
Return the current user's id, `username`, and the list of
profiles they can manage (each entry includes at least `profile_id` and
`name`). Use `fields` to limit which properties are returned. Not
cacheable—always reflects the token presented on the request. Requires
`account.read`
[scope](https://developers.dailymotion.com/v2/reference/api-scopes)
and a valid Bearer token.
### You are reading **API v2 documentation**
Still using the Legacy API? Access the Legacy API documentation.
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "Dailymotion API v2",
"description": "The Dailymotion API v2 allows you \nto access and manage your Dailymotion content.\n",
"version": "2.0.0"
},
"servers": [
{
"url": "https://api.dailymotion.com/v2",
"description": "Production"
}
],
"paths": {
"/me": {
"get": {
"tags": [
"Me"
],
"summary": "Get me",
"description": "Return the current user's id, `username`, and the list of\nprofiles they can manage (each entry includes at least `profile_id` and\n`name`). Use `fields` to limit which properties are returned. Not\ncacheable—always reflects the token presented on the request. Requires\n`account.read`\n[scope](https://developers.dailymotion.com/v2/reference/api-scopes)\nand a valid Bearer token.",
"operationId": "getMe",
"security": [
{
"Bearer": []
}
],
"parameters": [
{
"name": "fields",
"in": "query",
"required": false,
"schema": {
"type": "string",
"description": "Comma-separated field names to include. **Fields:** `profiles`, `user_id`, `username`.",
"title": "Fields"
},
"description": "Comma-separated field names to include. **Fields:** `profiles`, `user_id`, `username`."
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/MeGetResponse"
}
}
}
},
"401": {
"description": "**Authentication failed.** No ``Authorization: Bearer`` header, malformed JWT, expired passport, or invalid signature. Identity is not established—unlike **403**, the caller is not treated as an authenticated subject. Typical ``error.code`` values: ``INVALID_AUTHORIZATION``, ``AUTHORIZATION_EXPIRED``.",
"content": {
"application/json": {
"example": {
"error": {
"code": "AUTHORIZATION_EXPIRED",
"message": "Authorization expired.",
"correlation_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {
"param": "authorization"
},
"documentation_url": "https://developers.dailymotion.com/reference/api-errors"
}
},
"schema": {
"$ref": "#/components/schemas/DomainErrorEnvelope"
}
}
}
},
"403": {
"description": "**Authorization failed.** The bearer token was accepted, but the caller lacks required OAuth scopes or permissions, or an upstream service denied access to the resource. Typical ``error.code`` values: ``MISSING_PERMISSIONS``, ``UPSTREAM_ACCESS_DENIED``.",
"content": {
"application/json": {
"example": {
"error": {
"code": "MISSING_PERMISSIONS",
"message": "Missing required permissions: playlist:write. Required: playlist:read, playlist:write.",
"correlation_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {
"required_permissions": [
"playlist:read",
"playlist:write"
],
"missing_permissions": [
"playlist:write"
]
},
"documentation_url": "https://developers.dailymotion.com/reference/api-errors"
}
},
"schema": {
"$ref": "#/components/schemas/DomainErrorEnvelope"
}
}
}
},
"404": {
"description": "**Resource not found.** The path id does not exist, a parent resource in a nested URL is missing, or the object is not visible. Typical ``error.code``: ``RESOURCE_NOT_FOUND``.",
"content": {
"application/json": {
"example": {
"error": {
"code": "RESOURCE_NOT_FOUND",
"message": "Video with ID 'x1' not found.",
"correlation_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {
"object_id": "x1",
"reason": "object_not_found",
"object_type": "Video",
"param": "id"
},
"documentation_url": "https://developers.dailymotion.com/reference/api-errors"
}
},
"schema": {
"$ref": "#/components/schemas/DomainErrorEnvelope"
}
}
}
},
"422": {
"description": "**Unprocessable entity (422).** Invalid **path, query, and body parameters** (FastAPI/Pydantic). **Domain validation** (``DomainValidationError`` and subclasses). **Missing context** (e.g. ``MISSING_PARENT_ID``, ``MISSING_REQUIRED_VALUE``). All 422 responses share the same {\"error\": {\"code\", \"message\", \"correlation_id\", \"details\", \"documentation_url\"}} envelope; code and details vary by error origin.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DomainErrorEnvelope"
}
}
}
},
"429": {
"description": "**Rate limiting (reserved).** This BFF process does not currently return 429. Clients that reach the API through a gateway or CDN should still be prepared for 429 and ``Retry-After`` from those layers.",
"content": {
"application/json": {
"example": {
"error": {
"code": "TOO_MANY_REQUESTS",
"message": "Too many requests. Retry after the indicated delay.",
"correlation_id": "550e8400-e29b-41d4-a716-446655440000",
"details": {
"retry_after_seconds": 60
},
"documentation_url": "https://developers.dailymotion.com/reference/api-errors"
}
},
"schema": {
"$ref": "#/components/schemas/DomainErrorEnvelope"
}
}
}
}
}
}
}
},
"components": {
"schemas": {
"DomainErrorEnvelope": {
"properties": {
"error": {
"$ref": "#/components/schemas/DomainErrorPayload"
}
},
"type": "object",
"required": [
"error"
],
"title": "DomainErrorEnvelope",
"description": "Standard error body: ``{ \"error\": { ... } }``.\n\nPer-HTTP-status examples (401 vs 403 vs 404, etc.) are attached on each\nresponse in :func:`bff_api.entrypoints.api.openapi.responses.\nstandard_domain_error_responses`, not on this schema alone."
},
"DomainErrorPayload": {
"properties": {
"code": {
"type": "string",
"title": "Code",
"description": "Stable machine-readable error code (e.g. RESOURCE_NOT_FOUND, MISSING_PERMISSIONS)."
},
"message": {
"type": "string",
"title": "Message",
"description": "Human-readable summary."
},
"correlation_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Correlation Id",
"description": "Request correlation id for support (may be null)."
},
"details": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Details",
"description": "Structured context; shape depends on *code*."
},
"documentation_url": {
"type": "string",
"title": "Documentation Url",
"description": "Link to the public API error reference."
}
},
"type": "object",
"required": [
"code",
"message",
"documentation_url"
],
"title": "DomainErrorPayload",
"description": "Fields inside the ``error`` object for non-2xx domain errors."
},
"MeGetResponse": {
"properties": {
"user_id": {
"type": "string",
"title": "User Id",
"description": "User identifier. (default)",
"example": "xyz789"
},
"username": {
"type": "string",
"title": "Username",
"description": "User's canonical name. (default)",
"example": "john_doe"
},
"profiles": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array",
"title": "Profiles",
"description": "List of profiles the authenticated user can manage.\nIn an organization, a user can manage multiple profiles.\nThis field allows retrieving all manageable profiles directly,\nwithout querying `/organizations` or knowing their IDs in advance.\nEach entry is a mapping with at least ``profile_id`` and ``name`` (see\n:class:`GrpcMeRepository`); callers may assume dict-shaped rows. (default)",
"example": [
{
"name": "officialdailymotion",
"profile_id": "x1y2z3"
}
]
}
},
"type": "object",
"title": "Me Get Response",
"example": {
"user_id": "xyz789",
"username": "john_doe",
"profiles": [
{
"profile_id": "x1y2z3",
"name": "officialdailymotion"
}
]
}
}
},
"securitySchemes": {
"Bearer": {
"type": "http",
"description": "JWT token for authentication. Can be retrieved using https://oauth2.dailymotion.com/v1/token",
"scheme": "bearer"
}
}
},
"tags": [
{
"name": "Me",
"description": "Identity and manageable profiles for the authenticated caller."
}
]
}
```