Sign up

API → Payments → Update balance for an user
hidden

Parameters

Name

Type

Req.

Returns

  • 200 OK

    successful operation

    Name

    Type

    Req.

    body

    object
    optional
    Object Properties

    • created_at

      string / ISO-8601
      optional

    • id

      string / UUID
      optional

    • map_id

      string / UUID
      optional

    • modeling_app_enterprise_price

      oneOf
      optional
      One of

      • flat

        object
        optional
        Object Properties

        • interval

          string
          optional
          Possible values
          • day:  Day.
          • month:  Month.
          • week:  Week.
          • year:  Year.

        • price

          number / USD Price
          optional

        • type

          string
          optional
          Possible values
          • flat

      • per_user

        object
        optional
        Object Properties

        • interval

          string
          optional
          Possible values
          • day:  Day.
          • month:  Month.
          • week:  Week.
          • year:  Year.

        • price

          number / USD Price
          optional

        • type

          string
          optional
          Possible values
          • per_user

      • enterprise

        object
        optional
        Object Properties

        • type

          string
          optional
          Possible values
          • enterprise

    • monthly_credits_remaining

      number / USD Price
      optional

    • pre_pay_cash_remaining

      number / USD Price
      optional

    • pre_pay_credits_remaining

      number / USD Price
      optional

    • subscription_details

      object
      optional
      Object Properties

      • modeling_app

        object
        optional
        Object Properties

        • annual_discount

          integer
          optional

        • description

          string
          optional

        • features

          array
          optional
          Array of

        • name

          string
          optional
          Possible values
          • free:  The free tier.
          • pro:  The pro tier.
          • team:  The team tier.
          • enterprise:  The enterprise tier.

        • pay_as_you_go_credits

          number / USD Price
          optional

        • price

          oneOf
          optional
          One of

          • flat

            object
            optional
            Object Properties

            • interval

              string
              optional
              Possible values
              • day:  Day.
              • month:  Month.
              • week:  Week.
              • year:  Year.

            • price

              number / USD Price
              optional

            • type

              string
              optional
              Possible values
              • flat

          • per_user

            object
            optional
            Object Properties

            • interval

              string
              optional
              Possible values
              • day:  Day.
              • month:  Month.
              • week:  Week.
              • year:  Year.

            • price

              number / USD Price
              optional

            • type

              string
              optional
              Possible values
              • per_user

          • enterprise

            object
            optional
            Object Properties

            • type

              string
              optional
              Possible values
              • enterprise

        • share_links

          array
          optional

        • support_tier

          string
          optional
          Possible values
          • community:  Community support.
          • standard:  Standard support.
          • premium:  Premium support.
          • priority:  Priority support.

        • training_data_behavior

          string
          optional
          Possible values
          • always:  The data is always used for training and cannot be turned off.
          • default_on:  The data is used for training by default, but can be turned off.
          • default_off:  The data is not used for training by default, but can be turned on.

        • type

          oneOf
          optional
          One of

          • individual

            object
            optional
            Object Properties

            • type

              string
              optional
              Possible values
              • individual

          • organization

            object
            optional
            Object Properties

            • saml_sso

              boolean
              optional

            • type

              string
              optional
              Possible values
              • organization

        • zoo_tools_included

          array
          optional

    • subscription_id

      string
      optional

    • total_due

      number / USD Price
      optional

    • updated_at

      string / ISO-8601
      optional
put
/users/{id}/payment/balance
$ curl -X PUT "https://api.zoo.dev/users/{id}/payment/balance" \
	--header "Authorization: Bearer $TOKEN" \
	--header "Content-Type: application/json" \
	--data '{
  "monthly_credits_remaining": "56.21",
  "pre_pay_cash_remaining": "23.68",
  "pre_pay_credits_remaining": "12.75"
}'
200 OK
Response
{
  "created_at": "2025-01-09T18:26:50.739Z",
  "id": "90100825-4d48-48ba-9cb1-14d554b60a87",
  "map_id": "e80a4301-4a1f-4e53-a2db-cbc309284a95",
  "modeling_app_enterprise_price": {
    "type": "enterprise"
  },
  "monthly_credits_remaining": "42.91",
  "pre_pay_cash_remaining": "44.90",
  "pre_pay_credits_remaining": "73.10",
  "subscription_details": {
    "modeling_app": {
      "annual_discount": 30,
      "description": "qTITJn",
      "features": [
        {
          "info": "Vs7vzf5kXfANReGlBUSjijLThiFlPHQJHxt2VzOe92k81hSvNIlM"
        }
      ],
      "name": "free",
      "pay_as_you_go_credits": "100.12",
      "price": {
        "interval": "week",
        "price": "90.09",
        "type": "flat"
      },
      "share_links": [
        "password_protected"
      ],
      "support_tier": "premium",
      "training_data_behavior": "default_on",
      "type": {
        "type": "individual"
      },
      "zoo_tools_included": [
        "modeling_app"
      ]
    }
  },
  "subscription_id": "5AN",
  "total_due": "84.51",
  "updated_at": "2025-01-09T18:26:50.739Z"
}