Skip to main content
Pulumi logo Pulumi logo
  1. Docs
  2. Support & Troubleshooting
  3. Support request API

Support request API

    AI agents and scripts can open a ticket with the Pulumi support team by posting JSON to https://www.pulumi.com/api/support, without driving the web form. The endpoint needs no authentication and no cookies. Replies come by email to the address in the request, so give one that a person reads.

    Never send a leave_blank key. The rendered web form carries a hidden leave_blank input, which is a spam trap. A request that sets it is discarded behind a response indistinguishable from success, so no ticket is ever filed. Post the six fields below rather than scraping the HTML form for its inputs.

    Request

    Send a POST with Content-Type: application/json and exactly these six fields. Any other top-level key is rejected with a 422, except leave_blank: a non-empty leave_blank is accepted and silently discards the request (see the warning above).

    curl -X POST https://www.pulumi.com/api/support \
      -H "Content-Type: application/json" \
      -d '{
        "email": "you@example.com",
        "name": "Your Name",
        "organization": "your-pulumi-org",
        "priority": "Normal",
        "subject": "Stack update stuck in progress",
        "description": "What you expected, what actually happened, and any relevant code or CLI output."
      }'
    

    Fields

    All fields are required strings.

    FieldRules
    email254 characters or fewer, in the form name@domain.tld. Whitespace, <, >, ", ,, and ; are rejected.
    name200 characters or fewer.
    organizationThe bare organization name from https://app.pulumi.com/<org>. Starts with a letter or number, followed by letters, numbers, hyphens, and underscores, 40 characters or fewer. A pasted Pulumi Cloud console URL is reduced to the organization name for you.
    priorityNormal or Urgent, matched case-insensitively.
    subject200 characters or fewer.
    descriptionBetween 10 and 20,000 characters. Markdown and line breaks are kept.

    Every field is trimmed, and control characters (except tab and newline) and bidirectional text overrides are stripped before the limits apply. The whole request body must be 256 KB or smaller.

    Responses

    A successful request returns 200:

    {"ok": true, "id": "3f1c...", "conversationId": "215475836771541"}
    

    A validation failure returns 422 with a fields object keyed by field name, so each error maps back to its input without parsing prose. A problem with the payload as a whole, such as an unknown key or a body that isn’t a JSON object, is reported under _form:

    {"ok": false, "error": "validation_failed", "fields": {"email": "Enter a valid email address."}}
    
    StatusMeaning
    200The request was filed.
    400The Content-Type isn’t application/json (unsupported_content_type), the body is empty (empty_body), or the body isn’t valid JSON (invalid_json).
    404The request was blocked before it reached the endpoint. This is an HTML page, not JSON.
    405The method wasn’t POST (method_not_allowed).
    413The body is larger than 256 KB (payload_too_large).
    422One or more fields failed validation (validation_failed).
    429The request was rate limited. Back off rather than retrying immediately.
    502The ticket couldn’t be created (conversation_creation_failed). The response includes an id to quote if you contact support another way.

    A 429, a 404, and a 413 for a body large enough to exceed the platform’s invocation limit can all arrive without the JSON ok/error envelope, so check the status code before parsing the body.

    Next steps

      The infrastructure as code platform for any cloud.