DATPAQ User Avatar API
Dynamic user avatar generation in PNG, WebP, or SVG
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/datpaq-com:datpaq-com-user-avatar-api"
All apis
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.
Get an API 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 Specification
openapi: 3.2.0
info:
title: Datpaq Com User Avatar API
version: 1.1.0
contact:
name: Datpaq Support
url: https://datpaq.com
license:
name: Proprietary
description: 'Operations tagged User Avatar across 2 of this provider''s published API definitions: datpaq-com.yaml, datpaq-com-openapi.yaml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://datpaq.com/api/v1
description: Production
- url: https://staging.datpaq.com/api/v1
description: Staging
security:
- ApiKeyHeader: []
- ApiKeyQuery: []
tags:
- name: User Avatar
description: Dynamic user avatar generation in PNG, WebP, or SVG
paths:
/user-avatar:
get:
tags:
- User Avatar
operationId: userAvatarGenerate
summary: Generate a customizable user avatar image
description: Creates avatar images using Canvas (PNG/WebP) or native SVG. Supports initials-based avatars, custom colors, external image integration, and uploaded icons.
parameters:
- name: name
in: query
required: false
description: Display name to generate initials from
schema:
type: string
example: John Doe
- name: format
in: query
required: false
schema:
type: string
enum:
- png
- webp
- svg
default: png
- name: size
in: query
required: false
description: Avatar size in pixels (16–512)
schema:
type: integer
minimum: 16
maximum: 512
default: 128
- name: background
in: query
required: false
description: Background color hex without
schema:
type: string
pattern: ^[0-9A-Fa-f]{6}$
example: 4A90D9
- name: color
in: query
required: false
description: Text/icon color hex without
schema:
type: string
pattern: ^[0-9A-Fa-f]{6}$
example: FFFFFF
- name: rounded
in: query
required: false
description: Output a circular avatar
schema:
type: boolean
default: false
responses:
'200':
description: Avatar image binary or SVG markup
content:
image/png:
schema:
type: string
format: binary
image/webp:
schema:
type: string
format: binary
image/svg+xml:
schema:
type: string
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'429':
$ref: '#/components/responses/RateLimited'
default:
$ref: '#/components/responses/ServiceUnavailable'
servers:
- url: https://datpaq.com/api/v1
description: Production
- url: https://staging.datpaq.com/api/v1
description: Staging
/user-avatar/upload-icon:
post:
tags:
- User Avatar
operationId: userAvatarUploadIcon
summary: Upload a custom icon for avatar generation
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
required:
- file
properties:
file:
type: string
format: binary
description: Icon image file (PNG, SVG, or WebP, max 1MB)
responses:
'200':
description: Upload confirmation with icon ID
content:
application/json:
schema:
$ref: '#/components/schemas/GenericSuccess'
example:
success: true
url: https://datpaq.com/avatars/abc123.png
id: abc123
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'429':
$ref: '#/components/responses/RateLimited'
default:
$ref: '#/components/responses/ServiceUnavailable'
servers:
- url: https://datpaq.com/api/v1
description: Production
- url: https://staging.datpaq.com/api/v1
description: Staging
components:
schemas:
ErrorResponse:
type: object
properties:
error:
type: string
description: Human-readable error message
example: Invalid API key
correlationId:
type: string
description: Request tracking identifier for support
example: abc123-def456-789ghi
service:
type: string
description: Service name that produced the error
example: ip-geolocation
GenericSuccess:
type: object
description: Standard success envelope. The data property structure varies by endpoint.
properties:
correlationId:
type: string
description: Request tracking identifier
example: abc123-def456
data:
type: object
description: Response payload (structure varies by endpoint)
cached:
type: boolean
description: Whether the response was served from cache
example: false
responses:
BadRequest:
description: Bad request — missing or invalid parameters
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
RateLimited:
description: Rate limit exceeded — retry after the indicated period
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
ServiceUnavailable:
description: Service temporarily unavailable
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
Unauthorized:
description: Unauthorized — missing or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
securitySchemes:
ApiKeyHeader:
type: apiKey
in: header
name: x-api-key
description: API key passed via x-api-key request header
ApiKeyQuery:
type: apiKey
in: query
name: api_key
description: API key passed as api_key query parameter
x-refined-from:
- datpaq-com.yaml
- datpaq-com-openapi.yaml