EaserixDocs
DevelopersAPI referenceLinksBio

Create a bio page

Claims a handle (3–30 lowercase letters/numbers/-/_, reserved names rejected). The public page renders at esrx.ly/@handle once published.

View as Markdown
POST
/v1/bio

Authorization

bearer
AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/bio" \  -H "Content-Type: application/json" \  -d '{    "handle": "string"  }'
{  "page": {    "id": "string",    "handle": "string",    "publicUrl": "string",    "title": "string",    "bio": "string",    "theme": {      "preset": "string",      "layout": "classic",      "background": "string",      "text": "string",      "accent": "string",      "bgKind": "solid",      "bgImageUrl": "string",      "bgFit": "cover",      "bgScrim": 0,      "bgZoom": 0,      "bgPosX": 0,      "bgPosY": 0,      "shape": "sharp",      "fill": "solid",      "shadow": "none",      "font": "string",      "bold": true,      "avatarUrl": "string",      "customLayout": {        "align": "center",        "avatar": 0,        "band": 0,        "arch": true,        "rule": true      },      "socials": {        "property1": "string",        "property2": "string"      }    },    "published": true,    "views": 0,    "items": [      {        "id": "string",        "label": "string",        "url": "string",        "icon": 0,        "featured": true      }    ],    "created": "2019-08-24T14:15:22Z",    "updated": "2019-08-24T14:15:22Z"  }}

List the caller's bio pages

The caller's bio pages with their items, newest first, paginated the same way GET /v1/campaigns is.

Update a bio page

Partial update. When items is present, it's synced against the existing set (max 30): an item whose id matches an existing one is updated in place (keeping that id), an item with no id (or one that doesn't match) is created, and any existing item left out is deleted. For adding, editing, or removing a single item without resending the whole list, prefer POST/PATCH/DELETE on /v1/bio/{id}/items instead.