Whisperr Runtime API

{
  "components": {
    "parameters": {
      "AppIDPath": {
        "description": "whisp-go runtime app id or imported onboarding source_app_id.",
        "in": "path",
        "name": "app_id",
        "required": true,
        "schema": {
          "type": "string"
        }
      },
      "ConfigVersionIDPath": {
        "description": "Runtime config version id.",
        "in": "path",
        "name": "config_version_id",
        "required": true,
        "schema": {
          "type": "string"
        }
      },
      "DeliveryTemplateIDPath": {
        "description": "Email template id.",
        "in": "path",
        "name": "template_id",
        "required": true,
        "schema": {
          "type": "string"
        }
      },
      "DeliveryTemplateVersionIDPath": {
        "description": "Email template version id.",
        "in": "path",
        "name": "version_id",
        "required": true,
        "schema": {
          "type": "string"
        }
      },
      "ExternalUserIDPath": {
        "description": "Customer-project user id.",
        "in": "path",
        "name": "external_id",
        "required": true,
        "schema": {
          "type": "string"
        }
      },
      "WebhookTokenPath": {
        "description": "High-entropy webhook URL token.",
        "in": "path",
        "name": "token",
        "required": true,
        "schema": {
          "type": "string"
        }
      }
    },
    "responses": {
      "BadRequest": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        },
        "description": "Invalid request."
      },
      "NotFound": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        },
        "description": "Requested resource was not found."
      },
      "SchemaMigrationsPending": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        },
        "description": "The database schema is behind the running binary."
      },
      "Unauthorized": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        },
        "description": "Missing or invalid API key."
      }
    },
    "schemas": {
      "CompileDeliveryEmailTemplateRequest": {
        "properties": {
          "source": {
            "$ref": "#/components/schemas/DeliveryEmailTemplateDocument"
          }
        },
        "required": [
          "source"
        ],
        "type": "object"
      },
      "CreateDashboardAPIKeyRequest": {
        "additionalProperties": false,
        "properties": {
          "name": {
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "type": "object"
      },
      "CreateDashboardAPIKeyResponse": {
        "properties": {
          "api_key": {
            "$ref": "#/components/schemas/DashboardAPIKey"
          },
          "raw_key": {
            "description": "Raw API key secret, returned only when created.",
            "type": "string"
          }
        },
        "required": [
          "api_key",
          "raw_key"
        ],
        "type": "object"
      },
      "CreateDeliveryEmailTemplateRequest": {
        "properties": {
          "name": {
            "maxLength": 120,
            "type": "string"
          },
          "purpose": {
            "maxLength": 120,
            "type": "string"
          }
        },
        "required": [
          "name",
          "purpose"
        ],
        "type": "object"
      },
      "DashboardAPIKey": {
        "properties": {
          "app_id": {
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "environment": {
            "enum": [
              "production",
              "staging",
              "development"
            ],
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "key_prefix": {
            "type": "string"
          },
          "last_used_at": {
            "format": "date-time",
            "nullable": true,
            "type": "string"
          },
          "name": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "app_id",
          "key_prefix",
          "name",
          "environment",
          "created_at"
        ],
        "type": "object"
      },
      "DashboardAPIKeysResponse": {
        "properties": {
          "api_keys": {
            "items": {
              "$ref": "#/components/schemas/DashboardAPIKey"
            },
            "type": "array"
          }
        },
        "required": [
          "api_keys"
        ],
        "type": "object"
      },
      "DashboardApp": {
        "properties": {
          "environment": {
            "type": "string"
          },
          "id": {
            "description": "whisp-go runtime app id.",
            "type": "string"
          },
          "messaging_ready": {
            "type": "boolean"
          },
          "name": {
            "type": "string"
          },
          "onboarding_session_id": {
            "type": "string"
          },
          "organization_id": {
            "type": "string"
          },
          "organization_name": {
            "type": "string"
          },
          "organization_slug": {
            "type": "string"
          },
          "role": {
            "type": "string"
          },
          "runtime_config_activated_at": {
            "format": "date-time",
            "type": "string"
          },
          "runtime_config_status": {
            "type": "string"
          },
          "runtime_config_version": {
            "type": "integer"
          },
          "runtime_config_version_id": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "source_app_id": {
            "description": "Imported onboarding app id, when available.",
            "type": "string"
          }
        },
        "required": [
          "id",
          "organization_id",
          "organization_name",
          "organization_slug",
          "name",
          "slug",
          "environment",
          "role",
          "messaging_ready"
        ],
        "type": "object"
      },
      "DashboardEventsCatalogEvent": {
        "properties": {
          "code": {
            "type": "string"
          },
          "description": {
            "nullable": true,
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "is_active": {
            "type": "boolean"
          },
          "label": {
            "type": "string"
          },
          "rationale": {
            "nullable": true,
            "type": "string"
          },
          "suggested_wireable_on": {
            "items": {
              "enum": [
                "frontend",
                "backend"
              ],
              "type": "string"
            },
            "type": "array"
          },
          "variant_links": {
            "items": {
              "$ref": "#/components/schemas/DashboardVariantEventLink"
            },
            "type": "array"
          }
        },
        "required": [
          "id",
          "code",
          "label",
          "is_active",
          "suggested_wireable_on",
          "variant_links"
        ],
        "type": "object"
      },
      "DashboardEventsCatalogResponse": {
        "properties": {
          "config_version": {
            "nullable": true,
            "type": "integer"
          },
          "events": {
            "items": {
              "$ref": "#/components/schemas/DashboardEventsCatalogEvent"
            },
            "type": "array"
          }
        },
        "required": [
          "events"
        ],
        "type": "object"
      },
      "DashboardIntegrationsResponse": {
        "properties": {
          "app": {
            "additionalProperties": true,
            "type": "object"
          },
          "channel_settings": {
            "additionalProperties": true,
            "type": "object"
          },
          "event_source_snapshot": {
            "additionalProperties": true,
            "type": "object"
          },
          "event_sources": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "type": "array"
          }
        },
        "required": [
          "app",
          "event_sources"
        ],
        "type": "object"
      },
      "DashboardInterventionsGenerationStatus": {
        "properties": {
          "can_retry": {
            "type": "boolean"
          },
          "failure_reason": {
            "nullable": true,
            "type": "string"
          },
          "max_retries": {
            "type": "integer"
          },
          "retry_count": {
            "type": "integer"
          },
          "state": {
            "enum": [
              "not_started",
              "generating",
              "ready",
              "failed"
            ],
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "nullable": true,
            "type": "string"
          }
        },
        "required": [
          "state",
          "retry_count",
          "max_retries",
          "can_retry"
        ],
        "type": "object"
      },
      "DashboardInterventionsResponse": {
        "properties": {
          "app": {
            "additionalProperties": true,
            "type": "object"
          },
          "sub_variants": {
            "items": {
              "$ref": "#/components/schemas/DashboardSubVariant"
            },
            "type": "array"
          }
        },
        "required": [
          "app",
          "sub_variants"
        ],
        "type": "object"
      },
      "DashboardKnowledgeBrandVoice": {
        "properties": {
          "captured_at": {
            "type": "string"
          },
          "forbidden": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "sample_sentence": {
            "type": "string"
          },
          "tone": {
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "required": [
          "tone",
          "forbidden",
          "sample_sentence",
          "captured_at"
        ],
        "type": "object"
      },
      "DashboardKnowledgeBusinessProfile": {
        "properties": {
          "captured_at": {
            "type": "string"
          },
          "industry": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "pricing_model": {
            "type": "string"
          },
          "product_category": {
            "type": "string"
          },
          "sub_industry": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "industry",
          "sub_industry",
          "product_category",
          "pricing_model",
          "captured_at"
        ],
        "type": "object"
      },
      "DashboardKnowledgeCustomerProfile": {
        "properties": {
          "activation_criterion": {
            "type": "string"
          },
          "anti_icp": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "captured_at": {
            "type": "string"
          },
          "churn_signals": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "modifiers": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "type": "array"
          },
          "primary_icp": {
            "additionalProperties": true,
            "type": "object"
          }
        },
        "required": [
          "primary_icp",
          "modifiers",
          "activation_criterion",
          "churn_signals",
          "anti_icp",
          "captured_at"
        ],
        "type": "object"
      },
      "DashboardKnowledgeEventContext": {
        "properties": {
          "app": {
            "additionalProperties": true,
            "type": "object"
          },
          "event_sources": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "type": "array"
          },
          "import": {
            "additionalProperties": true,
            "type": "object"
          },
          "selected_interventions": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "type": "array"
          },
          "taxonomy": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "type": "array"
          }
        },
        "required": [
          "app",
          "taxonomy",
          "selected_interventions",
          "event_sources"
        ],
        "type": "object"
      },
      "DashboardKnowledgeRuntimeDetail": {
        "properties": {
          "app": {
            "additionalProperties": true,
            "type": "object"
          },
          "business_context": {
            "additionalProperties": true,
            "type": "object"
          },
          "channel_settings": {
            "additionalProperties": true,
            "type": "object"
          },
          "config_version": {
            "nullable": true,
            "type": "integer"
          },
          "delivery_policy": {
            "additionalProperties": true,
            "type": "object"
          },
          "event_source_snapshot": {
            "additionalProperties": true,
            "type": "object"
          },
          "generation_units": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "type": "array"
          },
          "runtime": {
            "additionalProperties": true,
            "type": "object"
          }
        },
        "required": [
          "app",
          "runtime",
          "generation_units",
          "delivery_policy"
        ],
        "type": "object"
      },
      "DashboardPolicyGenerationResponse": {
        "properties": {
          "configVersionId": {
            "type": "string"
          },
          "jobId": {
            "type": "string"
          },
          "mode": {
            "enum": [
              "first_policy",
              "regeneration"
            ],
            "type": "string"
          },
          "status": {
            "enum": [
              "pending",
              "running"
            ],
            "type": "string"
          }
        },
        "required": [
          "status",
          "jobId",
          "configVersionId",
          "mode"
        ],
        "type": "object"
      },
      "DashboardSessionResponse": {
        "properties": {
          "active_app": {
            "$ref": "#/components/schemas/DashboardApp"
          },
          "apps": {
            "items": {
              "$ref": "#/components/schemas/DashboardApp"
            },
            "type": "array"
          },
          "user": {
            "$ref": "#/components/schemas/DashboardUser"
          }
        },
        "required": [
          "user",
          "apps"
        ],
        "type": "object"
      },
      "DashboardStatusRequest": {
        "additionalProperties": false,
        "properties": {
          "reason": {
            "type": "string"
          },
          "status": {
            "enum": [
              "active",
              "paused"
            ],
            "type": "string"
          }
        },
        "required": [
          "status"
        ],
        "type": "object"
      },
      "DashboardSubVariant": {
        "properties": {
          "code": {
            "type": "string"
          },
          "fired_count_7d": {
            "type": "integer"
          },
          "label": {
            "type": "string"
          },
          "last_fired_at": {
            "format": "date-time",
            "nullable": true,
            "type": "string"
          },
          "parent_label": {
            "type": "string"
          },
          "parent_strategy": {
            "type": "string"
          },
          "paused_at": {
            "format": "date-time",
            "nullable": true,
            "type": "string"
          },
          "paused_reason": {
            "nullable": true,
            "type": "string"
          },
          "status": {
            "enum": [
              "active",
              "paused",
              "blocked",
              "declined"
            ],
            "type": "string"
          },
          "trigger_event": {
            "nullable": true,
            "type": "string"
          }
        },
        "required": [
          "code",
          "parent_strategy",
          "status",
          "fired_count_7d"
        ],
        "type": "object"
      },
      "DashboardUser": {
        "properties": {
          "auth_id": {
            "type": "string"
          },
          "email": {
            "type": "string"
          },
          "session_id": {
            "type": "string"
          }
        },
        "required": [
          "auth_id"
        ],
        "type": "object"
      },
      "DashboardVariantEventLink": {
        "properties": {
          "event_code": {
            "type": "string"
          },
          "parent_code": {
            "type": "string"
          },
          "rationale": {
            "nullable": true,
            "type": "string"
          },
          "role": {
            "enum": [
              "required",
              "optional",
              "outcome"
            ],
            "type": "string"
          },
          "source": {
            "type": "string"
          },
          "source_ref": {
            "nullable": true,
            "type": "string"
          },
          "variant_code": {
            "type": "string"
          }
        },
        "required": [
          "event_code",
          "parent_code",
          "variant_code",
          "role",
          "source"
        ],
        "type": "object"
      },
      "DeliveryEmailActivityMessage": {
        "allOf": [
          {
            "$ref": "#/components/schemas/DeliveryOutboundMessage"
          },
          {
            "properties": {
              "events": {
                "items": {
                  "$ref": "#/components/schemas/DeliveryMessageEvent"
                },
                "type": "array"
              }
            },
            "required": [
              "events"
            ],
            "type": "object"
          }
        ]
      },
      "DeliveryEmailActivityResponse": {
        "properties": {
          "messages": {
            "items": {
              "$ref": "#/components/schemas/DeliveryEmailActivityMessage"
            },
            "type": "array"
          }
        },
        "required": [
          "messages"
        ],
        "type": "object"
      },
      "DeliveryEmailServer": {
        "properties": {
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "id": {
            "description": "Whisperr provider account id.",
            "type": "string"
          },
          "outbound_stream_id": {
            "type": "string"
          },
          "provider_account_id": {
            "description": "Postmark server id.",
            "type": "string"
          },
          "status": {
            "enum": [
              "pending",
              "active",
              "error",
              "disabled"
            ],
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          },
          "webhook_registered_at": {
            "format": "date-time",
            "nullable": true,
            "type": "string"
          }
        },
        "required": [
          "id",
          "provider_account_id",
          "outbound_stream_id",
          "status",
          "created_at",
          "updated_at"
        ],
        "type": "object"
      },
      "DeliveryEmailServerResponse": {
        "properties": {
          "server": {
            "$ref": "#/components/schemas/DeliveryEmailServer"
          }
        },
        "required": [
          "server"
        ],
        "type": "object"
      },
      "DeliveryEmailSettings": {
        "properties": {
          "from_address": {
            "description": "Default From email address. Empty string when unset.",
            "type": "string"
          },
          "from_name": {
            "description": "Default From display name. Empty string when unset.",
            "type": "string"
          }
        },
        "required": [
          "from_name",
          "from_address"
        ],
        "type": "object"
      },
      "DeliveryEmailSettingsResponse": {
        "properties": {
          "settings": {
            "$ref": "#/components/schemas/DeliveryEmailSettings"
          }
        },
        "required": [
          "settings"
        ],
        "type": "object"
      },
      "DeliveryEmailTemplate": {
        "properties": {
          "active_version_id": {
            "description": "Present after a reviewed version has been published and activated.",
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "latest_version": {
            "$ref": "#/components/schemas/DeliveryEmailTemplateVersion"
          },
          "name": {
            "maxLength": 120,
            "type": "string"
          },
          "purpose": {
            "maxLength": 120,
            "type": "string"
          },
          "status": {
            "$ref": "#/components/schemas/DeliveryEmailTemplateStatus"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          },
          "versions": {
            "items": {
              "$ref": "#/components/schemas/DeliveryEmailTemplateVersion"
            },
            "type": "array"
          }
        },
        "required": [
          "id",
          "name",
          "purpose",
          "status",
          "created_at",
          "updated_at"
        ],
        "type": "object"
      },
      "DeliveryEmailTemplateBlock": {
        "additionalProperties": false,
        "properties": {
          "alt": {
            "description": "Required for image blocks.",
            "type": "string"
          },
          "level": {
            "description": "Heading level for heading blocks.",
            "maximum": 3,
            "minimum": 1,
            "type": "integer"
          },
          "text": {
            "description": "Required for heading, paragraph, and button blocks.",
            "type": "string"
          },
          "type": {
            "enum": [
              "heading",
              "paragraph",
              "button",
              "image",
              "divider"
            ],
            "type": "string"
          },
          "url": {
            "description": "Required for button and image blocks. Image URLs must use https.",
            "type": "string"
          }
        },
        "required": [
          "type"
        ],
        "type": "object"
      },
      "DeliveryEmailTemplateDocument": {
        "properties": {
          "blocks": {
            "items": {
              "$ref": "#/components/schemas/DeliveryEmailTemplateBlock"
            },
            "maxItems": 50,
            "minItems": 1,
            "type": "array"
          },
          "preheader": {
            "maxLength": 300,
            "type": "string"
          },
          "subject": {
            "maxLength": 180,
            "type": "string"
          }
        },
        "required": [
          "subject",
          "blocks"
        ],
        "type": "object"
      },
      "DeliveryEmailTemplatePreview": {
        "properties": {
          "compiled_html": {
            "type": "string"
          },
          "compiled_text": {
            "type": "string"
          },
          "content": {
            "type": "string"
          },
          "mode": {
            "enum": [
              "desktop",
              "text"
            ],
            "type": "string"
          },
          "preheader": {
            "type": "string"
          },
          "subject": {
            "type": "string"
          },
          "variable_names": {
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "required": [
          "mode",
          "content",
          "subject",
          "preheader"
        ],
        "type": "object"
      },
      "DeliveryEmailTemplatePreviewResponse": {
        "properties": {
          "preview": {
            "$ref": "#/components/schemas/DeliveryEmailTemplatePreview"
          }
        },
        "required": [
          "preview"
        ],
        "type": "object"
      },
      "DeliveryEmailTemplateResponse": {
        "properties": {
          "template": {
            "$ref": "#/components/schemas/DeliveryEmailTemplate"
          }
        },
        "required": [
          "template"
        ],
        "type": "object"
      },
      "DeliveryEmailTemplateStatus": {
        "enum": [
          "draft",
          "generated",
          "reviewed",
          "published",
          "active"
        ],
        "type": "string"
      },
      "DeliveryEmailTemplateVersion": {
        "properties": {
          "compiled_html": {
            "type": "string"
          },
          "compiled_text": {
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "postmark_template_alias": {
            "type": "string"
          },
          "postmark_template_id": {
            "type": "string"
          },
          "preheader": {
            "type": "string"
          },
          "source_json": {
            "additionalProperties": true,
            "type": "object"
          },
          "subject": {
            "type": "string"
          },
          "template_id": {
            "type": "string"
          },
          "version": {
            "minimum": 1,
            "type": "integer"
          }
        },
        "required": [
          "id",
          "template_id",
          "version",
          "source_json",
          "compiled_html",
          "compiled_text",
          "subject",
          "preheader",
          "created_at"
        ],
        "type": "object"
      },
      "DeliveryEmailTemplateVersionResponse": {
        "properties": {
          "version": {
            "$ref": "#/components/schemas/DeliveryEmailTemplateVersion"
          }
        },
        "required": [
          "version"
        ],
        "type": "object"
      },
      "DeliveryEmailTemplatesResponse": {
        "properties": {
          "templates": {
            "items": {
              "$ref": "#/components/schemas/DeliveryEmailTemplate"
            },
            "type": "array"
          }
        },
        "required": [
          "templates"
        ],
        "type": "object"
      },
      "DeliveryMessageEvent": {
        "properties": {
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "details": {
            "additionalProperties": true,
            "type": "object"
          },
          "event_at": {
            "format": "date-time",
            "type": "string"
          },
          "event_type": {
            "$ref": "#/components/schemas/DeliveryMessageEventType"
          },
          "id": {
            "type": "string"
          },
          "metadata": {
            "additionalProperties": true,
            "type": "object"
          },
          "provider": {
            "enum": [
              "postmark"
            ],
            "type": "string"
          },
          "provider_message_id": {
            "type": "string"
          },
          "recipient": {
            "type": "string"
          },
          "summary": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "event_type",
          "provider",
          "provider_message_id",
          "recipient",
          "event_at",
          "summary",
          "details",
          "metadata",
          "created_at"
        ],
        "type": "object"
      },
      "DeliveryMessageEventType": {
        "enum": [
          "delivered",
          "opened",
          "clicked",
          "bounced",
          "spam_complained",
          "subscription_changed"
        ],
        "type": "string"
      },
      "DeliveryOutboundMessage": {
        "properties": {
          "channel": {
            "enum": [
              "email"
            ],
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "failed_at": {
            "format": "date-time",
            "type": "string"
          },
          "from_address": {
            "type": "string"
          },
          "from_name": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "idempotency_key": {
            "type": "string"
          },
          "provider": {
            "enum": [
              "postmark"
            ],
            "type": "string"
          },
          "provider_account_id": {
            "type": "string"
          },
          "provider_error_code": {
            "type": "string"
          },
          "provider_error_message": {
            "type": "string"
          },
          "provider_message_id": {
            "type": "string"
          },
          "sent_at": {
            "format": "date-time",
            "type": "string"
          },
          "status": {
            "$ref": "#/components/schemas/DeliveryOutboundMessageStatus"
          },
          "submitted_at": {
            "format": "date-time",
            "type": "string"
          },
          "template_alias": {
            "type": "string"
          },
          "template_id": {
            "type": "string"
          },
          "template_model": {
            "additionalProperties": true,
            "type": "object"
          },
          "template_version_id": {
            "type": "string"
          },
          "to_address": {
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          }
        },
        "required": [
          "id",
          "provider_account_id",
          "template_id",
          "template_version_id",
          "channel",
          "provider",
          "to_address",
          "from_address",
          "from_name",
          "template_alias",
          "template_model",
          "status",
          "created_at",
          "updated_at"
        ],
        "type": "object"
      },
      "DeliveryOutboundMessageResponse": {
        "properties": {
          "message": {
            "$ref": "#/components/schemas/DeliveryOutboundMessage"
          }
        },
        "required": [
          "message"
        ],
        "type": "object"
      },
      "DeliveryOutboundMessageStatus": {
        "enum": [
          "pending",
          "sending",
          "sent",
          "failed"
        ],
        "type": "string"
      },
      "ErrorResponse": {
        "properties": {
          "error": {
            "propert

# --- truncated at 32 KB (121 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/whisperr-inc/refs/heads/main/openapi/whisperr-inc-runtime-openapi.json