PUT /portfolio_property_values
Bearer auth

Create or update a single portfolio property value for a portfolio company profile.

Pass the portfolio property and portfolio company profile identifiers along with the value, and the API will either create a new record or update the existing one if it already exists for that (portfolio_property_id, portfolio_company_profile_id) pair.

For properties with data_type of select or multiselect, you must send option IDs instead of option labels:

  • For select properties, use portfolio_property_option_id with the UUID of a single option.
  • For multiselect properties, use portfolio_property_option_ids with an array of option UUIDs. For all other data types (string, text, url, number, date, rich_text) use the generic value field.
application/json

Body Required

  • portfolio_property_value object

    One of:
    Text/Number/Date object Select object Multiselect object

Responses

  • 201 application/json

    Portfolio property value successfully created

    Hide response attribute Show response attribute object
    • portfolio_property_value object
      Hide portfolio_property_value attributes Show portfolio_property_value attributes object
      • id string(uuid) Required

        Unique identifier for the portfolio property value

      • value string | number | boolean | array | null

        The formatted value based on the property type

      • portfolio_property_id string(uuid) Required

        ID of the associated portfolio property

      • portfolio_company_profile_id string(uuid) Required

        ID of the associated portfolio company profile

      • portfolio_property_option_id string | null

        ID of the selected option when the associated property has data_type of select.

      • portfolio_property_option_ids array[string(uuid)]

        IDs of the selected options when the associated property has data_type of multiselect.
  • 200 application/json

    Portfolio property value successfully updated

    Hide response attribute Show response attribute object
    • portfolio_property_value object
      Hide portfolio_property_value attributes Show portfolio_property_value attributes object
      • id string(uuid) Required

        Unique identifier for the portfolio property value

      • value string | number | boolean | array | null

        The formatted value based on the property type

      • portfolio_property_id string(uuid) Required

        ID of the associated portfolio property

      • portfolio_company_profile_id string(uuid) Required

        ID of the associated portfolio company profile

      • portfolio_property_option_id string | null

        ID of the selected option when the associated property has data_type of select.

      • portfolio_property_option_ids array[string(uuid)]

        IDs of the selected options when the associated property has data_type of multiselect.
  • 400 application/json

    Bad Request - The request is invalid or malformed

    Hide response attribute Show response attribute object
    • errors array[object] Required

      Single error item. Different error types can include different fields.

      Hide errors attributes Show errors attributes object
      • type string

        Machine-readable error type

      • field string

        The related field, if applicable

      • message string

        Human-readable error message
  • 401 application/json

    Unauthorized - Invalid or missing authentication token

    Hide response attribute Show response attribute object
    • errors array[object] Required

      Single error item. Different error types can include different fields.

      Hide errors attributes Show errors attributes object
      • type string

        Machine-readable error type

      • field string

        The related field, if applicable

      • message string

        Human-readable error message
  • 403 application/json

    Forbidden - The authenticated user does not have access to the requested resource

    Hide response attribute Show response attribute object
    • errors array[object] Required

      Single error item. Different error types can include different fields.

      Hide errors attributes Show errors attributes object
      • type string

        Machine-readable error type

      • field string

        The related field, if applicable

      • message string

        Human-readable error message
  • 422 application/json

    Unprocessable Entity - The request is valid but contains semantic errors

    Hide response attribute Show response attribute object
    • errors array[object] Required

      Single error item. Different error types can include different fields.

      Hide errors attributes Show errors attributes object
      • type string

        Machine-readable error type

      • field string

        The related field, if applicable

      • message string

        Human-readable error message
  • 429 application/json

    Too Many Requests - Rate limit exceeded

    Hide response attribute Show response attribute object
    • errors array[object] Required

      Single error item. Different error types can include different fields.

      Hide errors attributes Show errors attributes object
      • type string

        Machine-readable error type

      • field string

        The related field, if applicable

      • message string

        Human-readable error message
PUT /portfolio_property_values 
curl \
 --request PUT 'https://api.visible.vc/portfolio_property_values' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{"portfolio_property_value":{"value":"Some text value","portfolio_property_id":"cad09a10-73e8-4205-ae67-4e6156f37be8","portfolio_company_profile_id":"b9bd9bb5-9b12-48bb-ae93-cdd2eba9af98"}}'
Request examples 
{
  "portfolio_property_value": {
    "value": "Some text value",
    "portfolio_property_id": "cad09a10-73e8-4205-ae67-4e6156f37be8",
    "portfolio_company_profile_id": "b9bd9bb5-9b12-48bb-ae93-cdd2eba9af98"
  }
}
{
  "portfolio_property_value": {
    "portfolio_property_id": "e2f345b9-3cde-5678-90ab-4d56e789f123",
    "portfolio_company_profile_id": "b9bd9bb5-9b12-48bb-ae93-cdd2eba9af98",
    "portfolio_property_option_id": "9d243039-85e2-4396-881f-7e971a3200c4"
  }
}
{
  "portfolio_property_value": {
    "portfolio_property_id": "c4e567f8-9abc-0123-4567-89def0123456",
    "portfolio_company_profile_id": "b9bd9bb5-9b12-48bb-ae93-cdd2eba9af98",
    "portfolio_property_option_ids": [
      "9d243039-85e2-4396-881f-7e971a3200c4",
      "a1395c0e-30dc-428b-883b-42455c84e6c2"
    ]
  }
}
Response examples (201) 
{
  "portfolio_property_value": "Sample text value"
}
Response examples (200) 
{
  "portfolio_property_value": "Sample text value"
}
Response examples (400) 
{
  "errors": [
    {
      "type": "parameter_invalid",
      "field": "filter",
      "message": "must be an object"
    }
  ]
}
Response examples (401) 
{
  "errors": [
    {
      "type": "unauthorized"
    }
  ]
}
Response examples (403) 
{
  "errors": [
    {
      "type": "forbidden"
    }
  ]
}
Response examples (422) 
{
  "errors": [
    {
      "type": "attribute_invalid",
      "field": "value",
      "message": "required"
    }
  ]
}
Response examples (429) 
{
  "errors": [
    {
      "type": "rate_limit_exceeded"
    }
  ]
}