singlesend_response_short

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/sendgrid/main/json-schema/sendgrid-singlesend-response-short-schema.json",
  "title": "singlesend_response_short",
  "x-generated": "2026-10-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/sendgrid-single-sends-api-openapi.yml#/components/schemas/SinglesendResponseShort",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid"
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "name of the Single Send"
    },
    "abtest": {
      "$ref": "#/$defs/AbTestSummary"
    },
    "status": {
      "type": "string",
      "description": "current status of the Single Send",
      "$ref": "#/$defs/Status3"
    },
    "categories": {
      "type": "array",
      "uniqueItems": true,
      "maxItems": 10,
      "description": "categories to associate with this Single Send",
      "items": {
        "type": "string"
      }
    },
    "send_at": {
      "type": "string",
      "format": "date-time",
      "description": "The ISO 8601 time at which to send the Single Send. This must be in future or the string `now`. SendGrid [Mail Send](https://docs.sendgrid.com/api-reference/mail-send/mail-send) emails can be scheduled up to 72 hours in advance. However, this scheduling constraint does not apply to emails sent via [Marketing Campaigns](https://docs.sendgrid.com/ui/sending-email/how-to-send-email-with-marketing-campaigns/)."
    },
    "is_abtest": {
      "type": "boolean",
      "description": "true if the Single Send's AB Test functionality has been toggled on"
    },
    "updated_at": {
      "type": "string",
      "description": "the ISO 8601 time at which the Single Send was last updated",
      "format": "date-time"
    },
    "created_at": {
      "type": "string",
      "description": "the ISO 8601 time at which the Single Send was created",
      "format": "date-time"
    }
  },
  "required": [
    "id",
    "name",
    "abtest",
    "status",
    "categories",
    "is_abtest",
    "updated_at",
    "created_at"
  ],
  "$defs": {
    "AbTestSummary": {
      "title": "abTest_summary",
      "properties": {
        "type": {
          "type": "string",
          "description": "What differs between the A/B tests",
          "$ref": "#/$defs/Type"
        },
        "winner_criteria": {
          "type": "string",
          "description": "How the winner will be decided",
          "$ref": "#/$defs/WinnerCriteria"
        },
        "test_percentage": {
          "type": "integer",
          "description": "What percentage of your recipient will be included in your A/B testing"
        },
        "duration": {
          "type": "string",
          "description": "How long the A/B Testing will last"
        },
        "winning_template_id": {
          "type": "string",
          "description": "Winner of the A/B Test"
        },
        "winner_selected_at": {
          "description": "When the winner was selected",
          "type": [
            "string",
            "null"
          ]
        },
        "expiration_date": {
          "description": "Last day to select an A/B Test Winner",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "type",
        "winner_criteria",
        "test_percentage",
        "duration",
        "winning_template_id",
        "winner_selected_at",
        "expiration_date"
      ],
      "type": [
        "object",
        "null"
      ]
    },
    "Status3": {
      "type": "string",
      "enum": [
        "draft",
        "scheduled",
        "triggered"
      ]
    },
    "Type": {
      "type": "string",
      "enum": [
        "subject",
        "content"
      ]
    },
    "WinnerCriteria": {
      "type": "string",
      "enum": [
        "open",
        "click",
        "manual"
      ]
    }
  }
}