Domains

Add a custom domain

Publish its `dnsRecords` at your DNS provider; it starts working once verified. Admins only.

POST
/v1/domains

Publish its dnsRecords at your DNS provider; it starts working once verified. Admins only.

Authorization

apiKey
headerAuthorizationBearer <token>

Request Body

  1. body
host*string

A hostname you control, e.g. go.yourbrand.com

Response Body

Response for status 201

application/json
  1. response
id*string
host*string
kind*string

subdomain = the workspace’s own on the short-link domain

Value in"subdomain""custom"
status*string
Value in"pending""verified""failed"
primary*boolean

New links go here when they name no domain

verifiedAt*|null
rootRedirectUrl*string|null
notFoundUrl*string|null
expiredUrl*string|null
dnsRecords*array<>

What to publish at your DNS provider

createdAt*string

ISO 8601 date-time

updatedAt*string

ISO 8601 date-time

curl -X POST 'https://api.tinbo.co/v1/domains' \  -H 'Content-Type: application/json' \  -d '{  "host": "string"}'
{  "id": "string",  "host": "string",  "kind": "subdomain",  "status": "pending",  "primary": true,  "verifiedAt": "string",  "rootRedirectUrl": "string",  "notFoundUrl": "string",  "expiredUrl": "string",  "dnsRecords": [    {      "type": "string",      "name": "string",      "value": "string"    }  ],  "createdAt": "string",  "updatedAt": "string"}