curl --request POST \
--url https://api.wellapp.ai/v1/medias \
--header 'Authorization: <authorization>' \
--header 'Content-Type: multipart/form-data' \
--form file='@example-file' \
--form 'data={"type":"media","attributes":{"media_type":"avatar","is_primary":true},"relationships":{"people":{"data":[{"type":"people","id":"550e8400-e29b-41d4-a716-446655440000"}]}}}'{
"data": [
{
"type": "media",
"id": "media1",
"attributes": {
"media_type": "avatar",
"url": "https://cdn.example.com/avatar.jpg",
"is_primary": true,
"uploaded_at": "2025-06-01T10:00:00Z",
"processed_at": "2025-06-01T10:00:00Z"
},
"relationships": {
"people": {
"data": [
{
"type": "people",
"id": "b6c22e98-c8d0-485e-9d3d-caa2bbaff77c"
}
]
},
"companies": {
"data": [
{
"type": "company",
"id": "b6c22e98-c8d0-485e-9d3d-caa2bbaff77a"
}
]
},
"workspaces": {
"data": [
{
"type": "workspace",
"id": "b6c22e98-c8d0-485e-9d3d-caa2bbaff77b"
}
]
}
},
"included": [
{
"type": "people",
"id": "people1",
"attributes": {
"first_name": "John",
"last_name": "Doe",
"job_title": "Software Engineer",
"created_at": "2025-05-01T09:00:00Z",
"updated_at": "2025-06-01T10:00:00Z"
}
},
{
"type": "company",
"id": "b6c22e98-c8d0-485e-9d3d-caa2bbaff77a",
"attributes": {
"name": "Tech Startup Inc",
"description": "An innovative technology company focused on AI and ML solutions",
"registration_tax_id": "12345678901",
"registration_registered_value": "123456789",
"created_at": "2025-08-03T10:38:40.967Z",
"updated_at": "2025-08-04T07:51:01.785Z"
}
},
{
"type": "workspace",
"id": "workspace_tenant",
"attributes": {
"name": "Marketing Team Workspace",
"description": "Collaborative workspace for the marketing team to manage campaigns and content",
"external_workspace_id": "fygr_123",
"created_at": "2024-01-05T08:00:00Z",
"updated_at": "2024-01-18T12:15:00Z"
}
}
]
}
]
}Create a new media record with relationships to people, companies, or workspaces
curl --request POST \
--url https://api.wellapp.ai/v1/medias \
--header 'Authorization: <authorization>' \
--header 'Content-Type: multipart/form-data' \
--form file='@example-file' \
--form 'data={"type":"media","attributes":{"media_type":"avatar","is_primary":true},"relationships":{"people":{"data":[{"type":"people","id":"550e8400-e29b-41d4-a716-446655440000"}]}}}'{
"data": [
{
"type": "media",
"id": "media1",
"attributes": {
"media_type": "avatar",
"url": "https://cdn.example.com/avatar.jpg",
"is_primary": true,
"uploaded_at": "2025-06-01T10:00:00Z",
"processed_at": "2025-06-01T10:00:00Z"
},
"relationships": {
"people": {
"data": [
{
"type": "people",
"id": "b6c22e98-c8d0-485e-9d3d-caa2bbaff77c"
}
]
},
"companies": {
"data": [
{
"type": "company",
"id": "b6c22e98-c8d0-485e-9d3d-caa2bbaff77a"
}
]
},
"workspaces": {
"data": [
{
"type": "workspace",
"id": "b6c22e98-c8d0-485e-9d3d-caa2bbaff77b"
}
]
}
},
"included": [
{
"type": "people",
"id": "people1",
"attributes": {
"first_name": "John",
"last_name": "Doe",
"job_title": "Software Engineer",
"created_at": "2025-05-01T09:00:00Z",
"updated_at": "2025-06-01T10:00:00Z"
}
},
{
"type": "company",
"id": "b6c22e98-c8d0-485e-9d3d-caa2bbaff77a",
"attributes": {
"name": "Tech Startup Inc",
"description": "An innovative technology company focused on AI and ML solutions",
"registration_tax_id": "12345678901",
"registration_registered_value": "123456789",
"created_at": "2025-08-03T10:38:40.967Z",
"updated_at": "2025-08-04T07:51:01.785Z"
}
},
{
"type": "workspace",
"id": "workspace_tenant",
"attributes": {
"name": "Marketing Team Workspace",
"description": "Collaborative workspace for the marketing team to manage campaigns and content",
"external_workspace_id": "fygr_123",
"created_at": "2024-01-05T08:00:00Z",
"updated_at": "2024-01-18T12:15:00Z"
}
}
]
}
]
}Bearer token for authentication
Image in png, jpg or svg format
Resource type identifier
"media"Type of media (avatar, logo, banner)
avatar, logo, banner Marks preferred media. Default: true
Type for people relationship
"people"UUID of the person to associate with this media
Type for company relationship
"company"UUID of the company to associate with this media
Type for workspace relationship
"workspace"UUID of the workspace to associate with this media
UUID of the external workspace to associate with this media
Media created successfully
Show child attributes
"media"Show child attributes
avatar, logo, banner URL to the media file
Whether this is the primary media
Timestamp when media processing completed
Show child attributes
Show child attributes
Show child attributes
Show child attributes
"people"Show child attributes
The person's first name
The person's last name
The person's full name (typically first_name + last_name)
Timestamp when the person was created
Timestamp when the person was last updated
Show child attributes
Show child attributes
"company"Show child attributes
The domain url from the website or email address of the company. Used as unique identifier in some cases.
500Show child attributes
Legal entity structure type.
Official company registration number.
Name of the official registration body.
Country of the registry authority. (string (ISO 3166-1 alpha-2))
UUID of the workspace associated with this company
Show child attributes
Show child attributes
"workspace"Show child attributes
Workspace name
Workspace description
external workspace id
Color of the avatar
Timestamp when the workspace was created
Timestamp when the workspace was last updated
Show child attributes
Show child attributes
"invoice_item"Show child attributes
Line identifier within the invoice
"1"
Stock Keeping Unit identifier
"WM-1001"
Product or service name
"Wireless Mouse"
Detailed description of the item
"Ergonomic wireless mouse with USB receiver"
Unit price in local currency
x >= 025
ISO 4217 currency code
"EUR"
Unit of measurement
"EA"
Minimum quantity allowed
x >= 01
Maximum quantity allowed
x >= 1500
Show child attributes
Tax rate as percentage
0 <= x <= 10020
Tax category
"standard"
Tax scheme identifier
"VAT"
Creation timestamp
"2025-05-11T13:42:12Z"
Last update timestamp
"2025-05-11T13:45:20Z"