Sourced
llms.txt
View Markdown

Domains ยท version 0.1.0

Add or update a docs domain

POST/api/projects/{projectId}/domains

Request

cURL
curl -X POST 'https://sourced.sh/api/projects/{projectId}/domains' \
  -H 'Authorization: Bearer $SOURCED_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{}'
TypeScript
const response = await fetch("https://sourced.sh/api/projects/{projectId}/domains", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SOURCED_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({}),
});
const data = await response.json();
Python
import os
import requests

response = requests.request(
    "POST",
    "https://sourced.sh/api/projects/{projectId}/domains",
    headers={"Authorization": f"Bearer {os.environ['SOURCED_API_KEY']}"},
    json={},
)
data = response.json()

Parameters

Path parameters

NameTypeRequiredDescription
projectIdstringYesProject identifier.

Request body

Required.

application/json

Schema
type: object
required: domain
properties:
  domain (required): string

Responses

201

Domain configuration and DNS records.

application/json

Schema
type: object
required: project, domain, dns
properties:
  project (required): Project
    Project:
      type: object
      required: id, name, createdAt
      properties:
        id (required): string
        name (required): string
        apiName: string
        mode: string enum flagship | stainless_compatible | custom | openapi | stainless_migration
          New writes use `flagship` or `stainless_compatible`; legacy `custom`, `openapi`, and `stainless_migration` records may still be returned.
        status: string enum created | active | archived
        createdAt (required): string
        updatedAt: string
        runCount: integer
  domain (required): DomainConfig
    DomainConfig:
      type: object
      required: id, domain, status, verificationToken, cnameTarget
      properties:
        id (required): string
        projectId: string
        domain (required): string
        status (required): string enum pending | verified | failed
        verificationToken (required): string
        cnameTarget (required): string
        lastVerifiedAt: string
        createdAt: string
        updatedAt: string
  dns (required): array
    type: array

400

401

403

404

Was this helpful?