Update a custom source — Guide

First-request guide for Update a custom source.

API GUIDE

Update a custom source

Update a custom source

PUT/integration/v1/custom-sources/{id}JSONAuthentication required

Overview

Updates an existing source by its ID and returns the updated resource.

Call the endpoint

Send a PUT request to /integration/v1/custom-sources/{id} with the required authentication and parameters.

Build the request body

Use the JSON shape below and replace example values with your data.

Inspect the response

Use the success response shape to validate the fields your integration receives.

Quickstart

Follow these two steps to make a request and recognize a successful response.

STEP 1

Make a request

REQUEST
curl --request PUT \
  --url https://uapi.demandbase.com/integration/v1/custom-sources/1 \
  --header "Authorization: Bearer $DB_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"name":"Salesforce CRM (updated)","description":"Updated description.","priority":55}'
STEP 2

Read the response

SUCCESS RESPONSE · HTTP 200
{
  "id": 42,
  "name": "Salesforce CRM (updated)",
  "description": "Updated description.",
  "sourceGroup": "custom",
  "priority": 55
}

Request anatomy

Build the request from the method, path, parameters, and payload described below.

Parameters

NameLocationTypeRequiredDescription
valueOptional

Request body

No fields are defined for this payload.

Response anatomy

The endpoint returns 200 for the documented success case. The updated source.

The response schema does not enumerate fields; inspect the example response and status code.

Rules

  • Use PUT with the path /integration/v1/custom-sources/{id}.
  • Required inputs: No parameters are marked required in the published schema..
  • Authenticate every request with a valid Demandbase access token.
  • Send the request body as application/json.

Filters

This endpoint has no additional filters or parameters beyond its authentication requirements.

NameLocationTypeRequiredDescription
valueOptional

Errors

Handle non-success responses explicitly so your integration can report actionable failures.

StatusMeaning
400Request failed.
401Request failed.
404Request failed.
500Request failed.

Next steps

Try the quickstart

Start with the request example, then replace the sample values with your credentials and data.

Return to the API area

Back to custom-sources

Back to top