Profile

Profile

Endpoints for viewing and updating your gallery or artist profile.

Get Profile

GET /v1/profile

Retrieve the profile for the entity bound to your API key.

Required scope: profile:read

Example

curl https://api.artland.com/v1/profile \
  -H "Authorization: Bearer ak_liv...n**Response (200):**
```json
{
  "id": 1,
  "type": "gallery",
  "name": "Gagosian",
  "slug": "gagosian",
  "description": "Contemporary art gallery in Zurich...",
  "external_url": "https://gallery.example.com",
  "ical_url": "https://gallery.example.com/calendar.ics",
  "social_instagram": "https://instagram.com/gallery",
  "social_twitter": "https://x.com/gallery",
  "location_city": "Zurich",
  "location_country": "CH"
}

---

Update Profile

PUT /v1/profile

Update profile fields for the entity bound to your API key.

Required scope: profile:write

Request Body

Field	Type	Description
description	string	Entity description
external_url	string	Website URL
ical_url	string	Calendar feed URL
social_instagram	string	Instagram profile URL
social_twitter	string	Twitter/X profile URL

All fields are optional — only send the fields you want to update.

Example

curl -X PUT https://api.artland.com/v1/profile \
  -H "Authorization: Bearer ak_liv...re" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Contemporary art gallery in Zurich specializing in abstract and minimalist works.",
    "external_url": "https://gallery.example.com",
    "ical_url": "https://gallery.example.com/calendar.ics",
    "social_instagram": "https://instagram.com/gallery",
    "social_twitter": "https://x.com/gallery"
  }'

Response (200):

{
  "id": 1,
  "type": "gallery",
  "name": "Gagosian",
  "description": "Contemporary art gallery in Zurich specializing in abstract and minimalist works.",
  "external_url": "https://gallery.example.com",
  "updated": true
}

---

iCalendar Integration

Setting ical_url on your profile enables a “Subscribe to calendar” link on your Artland profile page. This works with:

• Google Calendar
• Apple Calendar
• Microsoft Outlook

See iCal Integration for details.